Repository: cordova-plugin-network-information Updated Branches: refs/heads/master 6869d768a -> 5b3ac5462
Lisa testing pulling in plugins for plugin: cordova-plugin-network-information Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/repo Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/commit/d67870f7 Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/tree/d67870f7 Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/diff/d67870f7 Branch: refs/heads/master Commit: d67870f7662e00f41f9b5d32c9b785abe29befbf Parents: cd67d7a Author: ldeluca <[email protected]> Authored: Wed Feb 26 09:36:26 2014 -0500 Committer: ldeluca <[email protected]> Committed: Wed Feb 26 09:36:26 2014 -0500 ---------------------------------------------------------------------- doc/es/index.md | 173 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 173 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/d67870f7/doc/es/index.md ---------------------------------------------------------------------- diff --git a/doc/es/index.md b/doc/es/index.md new file mode 100644 index 0000000..4817768 --- /dev/null +++ b/doc/es/index.md @@ -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 + +Este plugin proporciona una implementación de una versión antigua de la [Red de información API][1]. Proporciona información acerca del dispositivo móvil y conexión wifi, y si el dispositivo tiene una conexión a internet. + + [1]: http://www.w3.org/TR/2011/WD-netinfo-api-20110607/ + +## Instalación + + cordova plugin add org.apache.cordova.network-information + + +## Plataformas soportadas + +* Amazon fuego OS +* Android +* BlackBerry 10 +* iOS +* Windows Phone 7 y 8 +* Tizen +* Windows 8 + +# Conexión + +> El `connection` objeto expuesto mediante `navigator.connection` , proporciona información acerca del dispositivo móvil y conexión wifi. + +## Propiedades + +* connection.type + +## Constantes + +* Connection.UNKNOWN +* Connection.ETHERNET +* Connection.WIFI +* Connection.CELL_2G +* Connection.CELL_3G +* Connection.CELL_4G +* Connection.CELL +* Connection.NONE + +## connection.type + +Esta propiedad ofrece una forma rápida de determinar el estado de conexión de red del dispositivo y el tipo de conexión. + +### Ejemplo rápido + + 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(); + + +### Cambio de API + +Hasta Cordova 2.3.0, el `Connection` objeto se accede a través de `navigator.network.connection` , después de que fue cambiada a `navigator.connection` para que coincida con la especificación W3C. TodavÃa está disponible en su ubicación original, pero está en desuso y eventualmente se eliminarán. + +### iOS rarezas + +* iOS no puede detectar el tipo de conexión de red celular. + * `navigator.connection.type`se establece en `Connection.CELL` para todos los datos celulares. + +### Windows Phone rarezas + +* Cuando se ejecuta en el emulador, siempre detecta `navigator.connection.type` como`Connection.UNKNOWN`. + +* Windows Phone no puede detectar el tipo de conexión de red celular. + + * `navigator.connection.type`se establece en `Connection.CELL` para todos los datos celulares. + +### Rarezas Tizen + +* Tizen sólo puede detectar un Wi-Fi o conexión celular. + * `navigator.connection.type`se establece en `Connection.CELL_2G` para todos los datos celulares. + +# Eventos relacionados con la red + +## offline + +El evento se desencadena cuando una aplicación está desconectada, y el dispositivo no está conectado a Internet. + + document.addEventListener("offline", yourCallbackFunction, false); + + +### Detalles + +El `offline` evento se desencadena cuando un dispositivo conectado previamente pierde una conexión de red para que una aplicación no puede acceder a Internet. Se basa en la misma información que la API de conexión y cuando se dispara el `connection.type` cambia de `NONE` a cualquier otro valor. + +Las aplicaciones normalmente deben utilizar `document.addEventListener` para conectar un detector de eventos una vez el `deviceready` evento incendios. + +### Ejemplo rápido + + document.addEventListener ("offline", onOffline, false); + + function onOffline() {/ / Handle del evento offline} + + +### iOS rarezas + +Durante el arranque inicial, el primer evento offline (si corresponde) toma por lo menos un segundo para disparar. + +### Windows Phone 7 rarezas + +Cuando se ejecuta en el emulador, el `connection.status` siempre es desconocida, asà que este evento no se ** fuego. + +### Windows Phone 8 rarezas + +El emulador, informa el tipo de conexión como `Cellular` , que no cambia, asà que el evento no se ** fuego. + +## online + +Este evento se desencadena cuando una aplicación en lÃnea, el dispositivo se conecta a Internet. + + document.addEventListener("online", yourCallbackFunction, false); + + +### Detalles + +El `online` evento se desencadena cuando un dispositivo previamente inconexos recibe una conexión de red para permitir un acceso a las aplicaciones a Internet. Se basa en la misma información que la API de conexión y cuando se dispara el valor del `connection.type` se convierte`NONE`. + +Las aplicaciones normalmente deben utilizar `document.addEventListener` para conectar un detector de eventos una vez el `deviceready` evento incendios. + +### Ejemplo rápido + + document.addEventListener("online", onOnline, false); + + function onOnline() { + // Handle the online event + } + + +### iOS rarezas + +Durante el arranque inicial, la primera `online` evento (si corresponde) toma por lo menos un segundo al fuego, antes de que `connection.type` es`UNKNOWN`. + +### Windows Phone 7 rarezas + +Cuando se ejecuta en el emulador, el `connection.status` siempre es desconocida, asà que este evento no se ** fuego. + +### Windows Phone 8 rarezas + +El emulador, informa el tipo de conexión como `Cellular` , que no cambia, asà que se lo eventos *no* fuego. \ No newline at end of file
