mirror of
https://gitee.com/shuto/cordova-plugin-network-information.git
synced 2025-01-18 21:52:48 +08:00
Lisa testing pulling in plugins for plugin: cordova-plugin-network-information
This commit is contained in:
ldeluca
parent
15049afcce
commit
1d4d78820c
173
doc/fr/index.md
Normal file
173
doc/fr/index.md
Normal file
@ -0,0 +1,173 @@
|
||||
<!---
|
||||
Licensed to the Apache Software Foundation (ASF) under one
|
||||
or more contributor license agreements. See the NOTICE file
|
||||
distributed with this work for additional information
|
||||
regarding copyright ownership. The ASF licenses this file
|
||||
to you under the Apache License, Version 2.0 (the
|
||||
"License"); you may not use this file except in compliance
|
||||
with the License. You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing,
|
||||
software distributed under the License is distributed on an
|
||||
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||
KIND, either express or implied. See the License for the
|
||||
specific language governing permissions and limitations
|
||||
under the License.
|
||||
-->
|
||||
|
||||
# org.apache.cordova.network-information
|
||||
|
||||
Ce plugin fournit une implémentation d'une ancienne version de l' [API Information Network][1]. Il fournit des informations sur l'appareil cellulaire et connexion wifi, et si l'appareil dispose d'une connexion internet.
|
||||
|
||||
[1]: http://www.w3.org/TR/2011/WD-netinfo-api-20110607/
|
||||
|
||||
## Installation
|
||||
|
||||
cordova plugin add org.apache.cordova.network-information
|
||||
|
||||
|
||||
## Plates-formes prises en charge
|
||||
|
||||
* Amazon Fire OS
|
||||
* Android
|
||||
* BlackBerry 10
|
||||
* iOS
|
||||
* Windows Phone 7 et 8
|
||||
* Paciarelli
|
||||
* Windows 8
|
||||
|
||||
# Connexion
|
||||
|
||||
> L'objet `connection`, disponible via `navigator.connection`, fournit des informations sur la connection cellulaire/wifi de l'appareil.
|
||||
|
||||
## Propriétés
|
||||
|
||||
* connection.type
|
||||
|
||||
## Constantes
|
||||
|
||||
* Connection.UNKNOWN
|
||||
* Connection.ETHERNET
|
||||
* Connection.WIFI
|
||||
* Connection.CELL_2G
|
||||
* Connection.CELL_3G
|
||||
* Connection.CELL_4G
|
||||
* Connection.CELL
|
||||
* Connection.NONE
|
||||
|
||||
## connection.type
|
||||
|
||||
Cette propriété offre un moyen rapide pour déterminer l'état et le type de la connexion réseau de l'appareil.
|
||||
|
||||
### Petit exemple
|
||||
|
||||
function checkConnection() {
|
||||
var networkState = navigator.connection.type;
|
||||
|
||||
var states = {};
|
||||
states[Connection.UNKNOWN] = 'Unknown connection';
|
||||
states[Connection.ETHERNET] = 'Ethernet connection';
|
||||
states[Connection.WIFI] = 'WiFi connection';
|
||||
states[Connection.CELL_2G] = 'Cell 2G connection';
|
||||
states[Connection.CELL_3G] = 'Cell 3G connection';
|
||||
states[Connection.CELL_4G] = 'Cell 4G connection';
|
||||
states[Connection.CELL] = 'Cell generic connection';
|
||||
states[Connection.NONE] = 'No network connection';
|
||||
|
||||
alert('Connection type: ' + states[networkState]);
|
||||
}
|
||||
|
||||
checkConnection();
|
||||
|
||||
|
||||
### Changement d'API
|
||||
|
||||
Jusqu'à Cordova 2.3.0, l'objet `Connection` était accessible via `navigator.network.connection` ; ceci a été changé pour `navigator.connection` afin de concorder avec la spécification du W3C. L'accès est toujours possible à l'emplacement d'origine, mais est considéré comme obsolète et sera bientôt supprimé.
|
||||
|
||||
### iOS Quirks
|
||||
|
||||
* iOS ne peut pas détecter le type de connexion au réseau cellulaire.
|
||||
* `navigator.connection.type`a la valeur `Connection.CELL` pour toutes les données cellulaires.
|
||||
|
||||
### Windows Phone Quirks
|
||||
|
||||
* Lors de l'exécution dans l'émulateur, détecte toujours `navigator.connection.type` comme`Connection.UNKNOWN`.
|
||||
|
||||
* Windows Phone ne peut pas détecter le type de connexion au réseau cellulaire.
|
||||
|
||||
* `navigator.connection.type`a la valeur `Connection.CELL` pour toutes les données cellulaires.
|
||||
|
||||
### Bizarreries de paciarelli
|
||||
|
||||
* Paciarelli peut uniquement détecter une connexion cellulaire ou bien WiFi.
|
||||
* `navigator.connection.type`a la valeur `Connection.CELL_2G` pour toutes les données cellulaires.
|
||||
|
||||
# Événements liés au réseau
|
||||
|
||||
## offline
|
||||
|
||||
L'évènement se déclenche lorsqu'une application se déconnecte, quand l'appareil n'est pas connecté à Internet.
|
||||
|
||||
document.addEventListener("offline", yourCallbackFunction, false);
|
||||
|
||||
|
||||
### Détails
|
||||
|
||||
L'évènement `offline` se déclenche lorsqu'un appareil précédemment connecté perd sa connexion au réseau, empêchant ainsi l'application d'accéder à Internet. Il repose sur les mêmes informations que l'API Connection et se déclenche quand `connection.type` passe de `NONE` à une autre valeur.
|
||||
|
||||
Les applications doivent généralement utiliser `document.addEventListener` pour attacher un écouteur d'événements une fois le `deviceready` événement se déclenche.
|
||||
|
||||
### Petit exemple
|
||||
|
||||
document.addEventListener (« hors ligne », onOffline, false) ;
|
||||
|
||||
function onOffline() {/ / gestion de l'événement en mode hors connexion}
|
||||
|
||||
|
||||
### iOS Quirks
|
||||
|
||||
Lors du démarrage initial, le déclenchement du premier évènement offline (si applicable) prend au moins une seconde.
|
||||
|
||||
### Windows Phone 7 Quirks
|
||||
|
||||
Lors de l'exécution dans l'émulateur, le `connection.status` est toujours inconnu, ainsi cet événement ne fait *pas* de feu.
|
||||
|
||||
### Windows Phone 8 Quirks
|
||||
|
||||
L'émulateur signale le type de connexion comme `Cellular`, type qui ne change jamais, ainsi l'évènement n'est *pas* déclenché.
|
||||
|
||||
## online
|
||||
|
||||
L'évènement se déclenche lorsqu'une application se connecte, quand l'appareil est connecté à Internet.
|
||||
|
||||
document.addEventListener("online", yourCallbackFunction, false);
|
||||
|
||||
|
||||
### Détails
|
||||
|
||||
L'évènement `online` se déclenche lorsqu'un appareil précédemment non-connecté se connecte au réseau, permettant ainsi à l'application d'accéder à Internet. Il repose sur les mêmes informations que l'API Connection et se déclenche quand la valeur de `connection.type` devient `NONE`.
|
||||
|
||||
Les applications doivent généralement utiliser `document.addEventListener` pour attacher un écouteur d'événements une fois le `deviceready` événement se déclenche.
|
||||
|
||||
### Petit exemple
|
||||
|
||||
document.addEventListener("online", onOnline, false);
|
||||
|
||||
function onOnline() {
|
||||
// Handle the online event
|
||||
}
|
||||
|
||||
|
||||
### iOS Quirks
|
||||
|
||||
Lors du démarrage initial, le déclenchement du premier évènement `online` (si applicable) prend au moins une seconde avant quoi `connection.type` vaut `UNKNOWN`.
|
||||
|
||||
### Windows Phone 7 Quirks
|
||||
|
||||
Lors de l'exécution dans l'émulateur, le `connection.status` est toujours inconnu, ainsi cet événement ne fait *pas* de feu.
|
||||
|
||||
### Windows Phone 8 Quirks
|
||||
|
||||
L'émulateur signale le type de connexion comme `Cellular` , qui ne change pas, aussi des événements ne fait *pas* de feu.
|
||||
Loading…
Reference in New Issue
Block a user