cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ldel...@apache.org
Subject [10/13] git commit: Lisa testing pulling in plugins for plugin: cordova-plugin-contacts
Date Mon, 07 Jul 2014 17:50:07 GMT
Lisa testing pulling in plugins for plugin: cordova-plugin-contacts


Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/commit/efb6b948
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/efb6b948
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/efb6b948

Branch: refs/heads/master
Commit: efb6b9485424c08356da94d96b4ea11b6764619e
Parents: 81cb15a
Author: ldeluca <ldeluca@us.ibm.com>
Authored: Tue May 27 21:21:38 2014 -0400
Committer: ldeluca <ldeluca@us.ibm.com>
Committed: Tue May 27 21:21:38 2014 -0400

----------------------------------------------------------------------
 doc/es/index.md | 163 ++++++++-----
 doc/fr/index.md | 315 +++++++++++++-----------
 doc/it/index.md | 668 +++++++++++++++++++++++++++++++++++++++++++++++++++
 doc/ko/index.md | 668 +++++++++++++++++++++++++++++++++++++++++++++++++++
 doc/pl/index.md | 668 +++++++++++++++++++++++++++++++++++++++++++++++++++
 doc/zh/index.md | 668 +++++++++++++++++++++++++++++++++++++++++++++++++++
 6 files changed, 2946 insertions(+), 204 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/efb6b948/doc/es/index.md
----------------------------------------------------------------------
diff --git a/doc/es/index.md b/doc/es/index.md
index 94432d6..a239376 100644
--- a/doc/es/index.md
+++ b/doc/es/index.md
@@ -45,12 +45,17 @@ Crear **www/manifest.webapp** como se describe en [Manifestar Docs][1]. Agregar
     }
     
 
+### Rarezas de Windows 8
+
+Windows 8 contactos son de sólo lectura. Través de los contactos de la API de Córdoba no son consultables/búsqueda, se debe informar al usuario a buscar un contacto como una llamada a contacts.pickContact que se abrirá la aplicación 'Personas' donde el usuario debe elegir un contacto. Cualquier contacto volvió es readonly, su aplicación no puede modificarlos.
+
 ## Navigator.Contacts
 
 ### Métodos
 
 *   navigator.contacts.create
 *   navigator.contacts.find
+*   navigator.contacts.pickContact
 
 ### Objetos
 
@@ -61,6 +66,7 @@ Crear **www/manifest.webapp** como se describe en [Manifestar Docs][1]. Agregar
 *   ContactOrganization
 *   ContactFindOptions
 *   ContactError
+*   ContactFieldType
 
 ## Navigator.contacts.Create
 
@@ -85,23 +91,25 @@ Este método no retiene el objeto de contacto en la base de contactos de disposi
 
 El `navigator.contacts.find` método se ejecuta asincrónicamente, consultando la base de datos de contactos de dispositivo y devolver una matriz de `Contact` objetos. Los objetos resultantes son pasados a la `contactSuccess` función de devolución de llamada especificada por el parámetro **contactSuccess** .
 
-El parámetro **contactFields** especifica los campos para ser utilizado como un calificador de búsqueda, y sólo esos resultados son pasados a la función de devolución de llamada **contactSuccess** . Un parámetro de longitud cero **contactFields** no es válido y resultados en `ContactError.INVALID_ARGUMENT_ERROR` . Un valor de **contactFields** de `"*"` devuelve todo contacto con los campos.
+El parámetro **contactFields** especifica los campos para ser utilizado como un calificador de búsqueda. Un parámetro de longitud cero **contactFields** no es válido y resultados en `ContactError.INVALID_ARGUMENT_ERROR` . Un valor de **contactFields** de `"*"` devuelve todo contacto con los campos.
 
-La cadena de **contactFindOptions.filter** puede ser usada como un filtro de búsqueda al consultar la base de datos de contactos. Si proporciona, una entre mayúsculas y minúsculas, coincidencia parcial valor se aplica a cada campo especificado en el parámetro **contactFields** . Si hay un partido para *cualquier* de los campos especificados, se devuelve el contacto.
+La cadena de **contactFindOptions.filter** puede ser usada como un filtro de búsqueda al consultar la base de datos de contactos. Si proporciona, una entre mayúsculas y minúsculas, coincidencia parcial valor se aplica a cada campo especificado en el parámetro **contactFields** . Si hay un partido para *cualquier* de los campos especificados, se devuelve el contacto. Uso **contactFindOptions.desiredFields** parámetro al control que Contacta con propiedades debe devolverse atrás.
 
 ### Parámetros
 
-*   **contactFields**: póngase en contacto con campos para usar como un calificador de búsqueda. La resultante `Contact` objeto sólo cuenta con los valores de estos campos. *(DOMString[])* [Obligatorio]
-
 *   **contactSuccess**: función de callback de éxito se invoca con la matriz de objetos contacto devueltos desde la base de datos. [Obligatorio]
 
 *   **contactError**: función de callback de Error, se invoca cuando se produce un error. [Opcional]
 
+*   **contactFields**: póngase en contacto con campos para usar como un calificador de búsqueda. *(DOMString[])* [Obligatorio]
+
 *   **contactFindOptions**: buscar opciones para filtrar navigator.contacts. [Opcional] Claves incluyen:
+
+*   **filtro**: la cadena de búsqueda utilizada para encontrar navigator.contacts. *(DOMString)* (Por defecto:`""`)
+
+*   **múltiples**: determina si la operación de búsqueda devuelve múltiples navigator.contacts. *(Booleano)* (Por defecto:`false`)
     
-    *   **filtro**: la cadena de búsqueda utilizada para encontrar navigator.contacts. *(DOMString)* (Por defecto:`""`)
-    
-    *   **múltiples**: determina si la operación de búsqueda devuelve múltiples navigator.contacts. *(Booleano)* (Por defecto:`false`)
+    *   **desiredFields**: póngase en contacto con campos para volver atrás. Si se especifica, la resultante `Contact` objeto sólo cuenta con los valores de estos campos. *(DOMString[])* [Opcional]
 
 ### Plataformas soportadas
 
@@ -110,12 +118,11 @@ La cadena de **contactFindOptions.filter** puede ser usada como un filtro de bú
 *   Firefox OS
 *   iOS
 *   Windows Phone 7 y 8
-*   Windows 8
 
 ### Ejemplo
 
     function onSuccess(contacts) {
-        alert('Found ' + navigator.contacts.length + ' navigator.contacts.');
+        alert('Found ' + contacts.length + ' contacts.');
     };
     
     function onError(contactError) {
@@ -126,8 +133,35 @@ La cadena de **contactFindOptions.filter** puede ser usada como un filtro de bú
     var options      = new ContactFindOptions();
     options.filter   = "Bob";
     options.multiple = true;
-    var fields       = ["displayName", "name"];
-    navigator.contacts.find(fields, onSuccess, onError, options);
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(onSuccess, onError, fields, options);
+    
+
+## navigator.contacts.pickContact
+
+El `navigator.contacts.pickContact` método lanza el selector para seleccionar un único contacto contacto. El objeto resultante se pasa a la `contactSuccess` función de devolución de llamada especificada por el parámetro **contactSuccess** .
+
+### Parámetros
+
+*   **contactSuccess**: función de callback de éxito se invoca con el único objeto de contacto. [Obligatorio]
+
+*   **contactError**: función de callback de Error, se invoca cuando se produce un error. [Opcional]
+
+### Plataformas soportadas
+
+*   Android
+*   iOS
+*   Windows Phone 8
+*   Windows 8
+
+### Ejemplo
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
     
 
 ## Contacto
@@ -228,8 +262,8 @@ El `Contact` objeto representa el contacto de un usuario. Contactos pueden ser c
         alert("Error = " + contactError.code);
     };
     
-        // remove the contact from the device
-        contact.remove(onSuccess,onError);
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
     
 
 ### Rarezas Android 2.X
@@ -238,27 +272,7 @@ El `Contact` objeto representa el contacto de un usuario. Contactos pueden ser c
 
 ### BlackBerry 10 rarezas
 
-*   **ID**: apoyado. Asignado por el dispositivo cuando se guarda el contacto.
-
-*   **displayName**: apoyado. Almacena en campo **usuario1** BlackBerry.
-
-*   **apodo**: no soportado, regresando`null`.
-
-*   **números**: parcialmente soportado. Números de teléfono se almacenan en BlackBerry campos **homePhone1** y **homePhone2** si el *tipo* es 'casa', **workPhone1** y **workPhone2** si el *tipo* es 'trabajo', **teléfono móvil** si el *tipo* es 'móvil', **faxPhone** si el *tipo* es 'fax', **pagerPhone** si *el tipo* es 'pager' y **otherPhone** si no *tipo de* ninguno de los anteriores.
-
-*   **correo electrónico**: parcialmente soportado. Las primeras direcciones de correo tres electrónico se almacenan en el BlackBerry **electrónico1** **email2**Campos y **email3** , respectivamente.
-
-*   **direcciones**: parcialmente soportado. Las primeras y la segunda direcciones se almacenan en los campos BlackBerry **homeAddress** y **workAddress** , respectivamente.
-
-*   **IMS**: no soportado, regresando`null`.
-
-*   **organizaciones**: parcialmente soportado. El **nombre** y el **título** de la primera organización se almacenan en los campos de la **empresa** y **título** de la BlackBerry, respectivamente.
-
-*   **fotos**: parcialmente soportado. Se admite una sola foto miniatura. Para fijar la foto de un contacto, pasar una o un codificado en base64 imagen, o una dirección URL que apunta a la imagen. La imagen es reducida antes de guardar en la base de datos de contactos de BlackBerry. La foto de contacto se devuelve como una imagen codificada en base64.
-
-*   **categorías**: parcialmente soportado. Se admiten únicamente las categorías de *negocios* y *Personal* .
-
-*   **URL**: parcialmente soportado. La primera URL se almacena en el campo de la **página web** de BlackBerry.
+*   **ID**: asignado por el dispositivo cuando se guarda el contacto.
 
 ### FirefoxOS rarezas
 
@@ -288,17 +302,17 @@ El `Contact` objeto representa el contacto de un usuario. Contactos pueden ser c
 
 *   **correos electrónicos**: no se admite la opción *pref* . Home y referencias misma entrada de correo electrónico. Se permite solamente una entrada para cada *tipo*.
 
-*   **direcciones**: soporta sólo trabajo y hogar/personal *tipo*. La casa y personal *tipo* referencia la misma entrada de dirección. Se permite solamente una entrada para cada *tipo*.
+*   **direcciones**: soporta sólo trabajo y hogar/personal *tipo*. La casa y personales de *tipo* referencia la misma entrada de dirección. Se permite solamente una entrada para cada *tipo*.
 
 *   **organizaciones**: sólo está permitido y no es compatible con los atributos *pref*, *tipo*y *Departamento* .
 
-*   **Nota**: no compatible, volviendo`null`.
+*   **Nota**: no compatible, regresando`null`.
 
-*   **IMS**: no admite, volviendo`null`.
+*   **IMS**: no soportado, regresando`null`.
 
-*   **cumpleaños**: no admite, volviendo`null`.
+*   **cumpleaños**: no soportado, regresando`null`.
 
-*   **categorías**: no admite, volviendo`null`.
+*   **categorías**: no soportado, regresando`null`.
 
 ## ContactAddress
 
@@ -310,7 +324,7 @@ El `ContactAddress` objeto almacena las propiedades de una única dirección de
 
 *   **tipo**: una cadena que indica qué tipo de campo es, *casa* por ejemplo. *(DOMString)*
 
-*   **formato**: la dirección completa con formato de pantalla. *(DOMString)*
+*   **formato**: la dirección completa con formato de visualización. *(DOMString)*
 
 *   **streetAddress**: la dirección completa. *(DOMString)*
 
@@ -337,7 +351,7 @@ El `ContactAddress` objeto almacena las propiedades de una única dirección de
     // display the address information for all contacts
     
     function onSuccess(contacts) {
-        for (var i = 0; i < navigator.contacts.length; i++) {
+        for (var i = 0; i < contacts.length; i++) {
             for (var j = 0; j < contacts[i].addresses.length; j++) {
                 alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
                     "Type: "           + contacts[i].addresses[j].type          + "\n" +
@@ -364,27 +378,27 @@ El `ContactAddress` objeto almacena las propiedades de una única dirección de
 
 ### Rarezas Android 2.X
 
-*   **Pref**: no admite, volviendo `false` en dispositivos Android 2.X.
+*   **Pref**: no soportado, volviendo `false` en dispositivos Android 2.X.
 
 ### BlackBerry 10 rarezas
 
-*   **Pref**: no compatible con dispositivos BlackBerry, volviendo`false`.
+*   **Pref**: no compatible con dispositivos BlackBerry, regresando`false`.
 
-*   **tipo**: parcialmente financiado. Sólo uno de *trabajo* y *casa* tipo direcciones puede almacenarse por contacto.
+*   **tipo**: parcialmente soportado. Sólo uno de cada *trabajo* y *casa* tipo direcciones puede ser almacenado por contacto.
 
-*   **formato**: parcialmente financiado. Devuelve una concatenación de todos los campos de dirección de BlackBerry.
+*   **formato**: parcialmente soportado. Devuelve una concatenación de todos los campos de dirección de BlackBerry.
 
-*   **streetAddress**: apoyo. Devuelve una concatenación de BlackBerry **address1** y **2** Campos de dirección.
+*   **streetAddress**: soportado. Devuelve una concatenación de BlackBerry **address1** y **2** Campos de dirección.
 
-*   **localidad**: apoyado. Almacenado en el campo de dirección de la **ciudad** de BlackBerry.
+*   **localidad**: apoyado. Almacenada en el campo de dirección de la **ciudad** de BlackBerry.
 
-*   **región**: apoyado. Almacenado en el campo de dirección de BlackBerry **stateProvince** .
+*   **región**: apoyado. Almacenada en el campo de dirección de BlackBerry **stateProvince** .
 
-*   **Código postal**: apoyado. Almacenado en el campo de dirección de BlackBerry **zipPostal** .
+*   **Código postal**: apoyado. Almacenada en el campo de dirección de BlackBerry **zipPostal** .
 
-*   **país**: apoyo.
+*   **país**: apoyado.
 
-### Rarezas FirefoxOS
+### FirefoxOS rarezas
 
 *   **formato**: actualmente no se admite
 
@@ -394,29 +408,33 @@ El `ContactAddress` objeto almacena las propiedades de una única dirección de
 
 *   **formato**: actualmente no se admite.
 
+### Rarezas de Windows 8
+
+*   **Pref**: no se admite
+
 ## ContactError
 
 El `ContactError` objeto se devuelve al usuario a través de la `contactError` función de devolución de llamada cuando se produce un error.
 
 ### Propiedades
 
-*   **código**: uno de los códigos de error predefinido a continuación.
+*   **código**: uno de los códigos de error predefinido enumerados a continuación.
 
 ### Constantes
 
-*   `ContactError.UNKNOWN_ERROR`
-*   `ContactError.INVALID_ARGUMENT_ERROR`
-*   `ContactError.TIMEOUT_ERROR`
-*   `ContactError.PENDING_OPERATION_ERROR`
-*   `ContactError.IO_ERROR`
-*   `ContactError.NOT_SUPPORTED_ERROR`
-*   `ContactError.PERMISSION_DENIED_ERROR`
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
 
 ## ContactField
 
 El `ContactField` objeto es un componente reutilizable que representa en contacto con campos genéricamente. Cada `ContactField` objeto contiene un `value` , `type` , y `pref` propiedad. A `Contact` objeto almacena varias propiedades en `ContactField[]` arreglos de discos, como las direcciones de teléfono números y correo electrónico.
 
-En la mayoría de los casos, no existen previamente determinados valores para un `ContactField` atributo **type** del objeto. Por ejemplo, un número de teléfono puede especificar valores de **tipo** de *hogar*, *trabajo*, *móvil*, *iPhone*o cualquier otro valor que es apoyado por contacto de base de datos de una plataforma dispositivo determinado. Sin embargo, para el `Contact` **fotos de** campo, el campo **tipo** indica el formato de la imagen devuelta: **url** cuando el atributo de **valor** contiene una dirección URL de la imagen de la foto, o *base64* cuando el **valor** contiene una cadena codificada en base64 imagen. 
+En la mayoría de los casos, no existen previamente determinados valores para un `ContactField` atributo **type** del objeto. Por ejemplo, un número de teléfono puede especificar valores de **tipo** de *hogar*, *trabajo*, *móvil*, *iPhone*o cualquier otro valor que es apoyado por contacto de base de datos de una plataforma dispositivo determinado. Sin embargo, para el `Contact` **fotos de** campo, el campo **tipo** indica el formato de la imagen devuelta: **url** cuando el atributo de **valor** contiene una dirección URL de la imagen de la foto, o *base64* cuando el **valor** contiene una cadena codificada en base64 imagen.
 
 ### Propiedades
 
@@ -468,6 +486,10 @@ En la mayoría de los casos, no existen previamente determinados valores para un
 
 *   **Pref**: no soportado, regresando`false`.
 
+### Windows8 rarezas
+
+*   **Pref**: no soportado, regresando`false`.
+
 ## ContactName
 
 Contiene diferentes tipos de información sobre un `Contact` nombre del objeto.
@@ -499,7 +521,7 @@ Contiene diferentes tipos de información sobre un `Contact` nombre del objeto.
 ### Ejemplo
 
     function onSuccess(contacts) {
-        for (var i = 0; i < navigator.contacts.length; i++) {
+        for (var i = 0; i < contacts.length; i++) {
             alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
                 "Family Name: "  + contacts[i].name.familyName      + "\n" +
                 "Given Name: "   + contacts[i].name.givenName       + "\n" +
@@ -521,7 +543,7 @@ Contiene diferentes tipos de información sobre un `Contact` nombre del objeto.
 
 ### Rarezas Android
 
-*   **formato**: parcialmente compatibles y de sólo lectura. Devuelve una cadena de `honorificPrefix` , `givenName` , `middleName` , `familyName` , y`honorificSuffix`.
+*   **formato**: parcialmente compatibles y de sólo lectura. Devuelve una concatenación de `honorificPrefix` , `givenName` , `middleName` , `familyName` , y`honorificSuffix`.
 
 ### BlackBerry 10 rarezas
 
@@ -545,6 +567,20 @@ Contiene diferentes tipos de información sobre un `Contact` nombre del objeto.
 
 *   **formato**: parcialmente soportado. Devuelve iOS nombre compuesto, pero es de sólo lectura.
 
+### Rarezas de Windows 8
+
+*   **formato**: este es el único nombre de propiedad y es idéntico al `displayName` , y`nickname`
+
+*   **familia**: no se admite
+
+*   **givenName**: no se admite
+
+*   **middleName**: no se admite
+
+*   **honorificPrefix**: no se admite
+
+*   **honorificSuffix**: no se admite
+
 ## ContactOrganization
 
 El `ContactOrganization` objeto almacena las propiedades de organización de un contacto. A `Contact` objeto almacena uno o más `ContactOrganization` los objetos en una matriz.
@@ -568,12 +604,11 @@ El `ContactOrganization` objeto almacena las propiedades de organización de un
 *   Firefox OS
 *   iOS
 *   Windows Phone 7 y 8
-*   Windows 8
 
 ### Ejemplo
 
     function onSuccess(contacts) {
-        for (var i = 0; i < navigator.contacts.length; i++) {
+        for (var i = 0; i < contacts.length; i++) {
             for (var j = 0; j < contacts[i].organizations.length; j++) {
                 alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
                     "Type: "        + contacts[i].organizations[j].type       + "\n" +

http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/efb6b948/doc/fr/index.md
----------------------------------------------------------------------
diff --git a/doc/fr/index.md b/doc/fr/index.md
index 8f8aee8..5511d2f 100644
--- a/doc/fr/index.md
+++ b/doc/fr/index.md
@@ -45,12 +45,17 @@ Créez **www/manifest.webapp** comme décrit dans [Les Docs manifeste][1]. Ajout
     }
     
 
+### Bizarreries de Windows 8
+
+Windows 8 Contacts sont en lecture seule. Via les Contacts d'API Cordova ne sont pas queryable/consultables, vous devez en informer l'utilisateur de choisir un contact comme un appel à contacts.pickContact qui va ouvrir l'application « People » où l'utilisateur doit choisir un contact. Les contacts retournés sont en lecture seule, afin que votre application ne puisse les modifier.
+
 ## Navigator.contacts
 
 ### Méthodes
 
 *   navigator.contacts.create
 *   navigator.contacts.find
+*   navigator.contacts.pickContact
 
 ### Objets
 
@@ -61,12 +66,13 @@ Créez **www/manifest.webapp** comme décrit dans [Les Docs manifeste][1]. Ajout
 *   ContactOrganization
 *   ContactFindOptions
 *   ContactError
+*   ContactFieldType
 
 ## Navigator.contacts.Create
 
 La `navigator.contacts.create` méthode est synchrone et retourne un nouveau `Contact` objet.
 
-Cette méthode ne conserve pas l'objet Contact dans la base de données des contacts de l'appareil, pour lesquels il faut appeler la méthode `Contact.save`.
+Cette méthode ne conserve pas l'objet de Contact dans la base de données des contacts périphériques, dont vous avez besoin d'appeler le `Contact.save` méthode.
 
 ### Plates-formes prises en charge
 
@@ -83,25 +89,27 @@ Cette méthode ne conserve pas l'objet Contact dans la base de données des cont
 
 ## navigator.contacts.find
 
-La `navigator.contacts.find` méthode s'exécute de façon asynchrone, l'interrogation de la base de données de contacts de dispositif et retourne un tableau de `Contact` objets. Les objets retournés sont passés à la fonction de callback `contactSuccess` spécifiée par le paramètre **contactSuccess** .
+La `navigator.contacts.find` méthode s'exécute de façon asynchrone, l'interrogation de la base de données de contacts de dispositif et retourne un tableau de `Contact` objets. Les objets résultants sont passés à la `contactSuccess` la fonction de rappel spécifiée par le paramètre **contactSuccess** .
 
-Le paramètre **contactFields** spécifie les champs à utiliser comme un qualificateur de recherche, et seulement ces résultats sont passés à la fonction de callback **contactSuccess**. Un paramètre de longueur nulle **contactFields** n'est pas valide et provoque une erreur `ContactError.INVALID_ARGUMENT_ERROR`. Une valeur de **contactFields** de `"*"` retourne les champs de tout contact.
+Le paramètre **contactFields** spécifie les champs à utiliser comme un qualificateur de recherche. Un paramètre de longueur nulle **contactFields** n'est pas valide et se traduit par `ContactError.INVALID_ARGUMENT_ERROR` . Une valeur de **contactFields** de `"*"` retourne les champs de tout contact.
 
-La chaîne **contactFindOptions.filter** peut être utilisée comme un filtre de recherche lorsque vous interrogez la base de données de contacts. Si fourni, une valeur insensible à la casse et partiellement correspondante est appliquée à chaque champ spécifié dans le paramètre **contactFields**. S'il y a une correspondance pour *n'importe lequel* des champs spécifiés, le contact est retourné.
+La chaîne **contactFindOptions.filter** peut servir comme un filtre de recherche lors de l'interrogation de la base de données de contacts. Si fourni, un non-respect de la casse, correspondance de valeur partielle est appliquée à chaque champ spécifié dans le paramètre **contactFields** . S'il y a une correspondance pour *n'importe quel* des champs spécifiés, le contact est retourné. Utilisation **contactFindOptions.desiredFields** paramètre de contrôle qui contacter propriétés doit être retourné au retour.
 
 ### Paramètres
 
-*   **contactFields** : champs du Contact à utiliser comme un qualificateur de recherche. L'objet `Contact` retourné dispose seulement des valeurs pour ces champs. *(DOMString[])* [Obligatoire]
-
 *   **contactSuccess**: fonction de rappel de succès avec le tableau d'objets Contact appelée retournée par la base de données. [Obligatoire]
 
-*   **contactError** : fonction de callback d'erreur, appelée lorsqu'une erreur se produit. [Facultatif]
+*   **contactError**: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Facultatif]
+
+*   **contactFields**: communiquer avec les champs à utiliser comme un qualificateur de recherche. *(DOMString[])* [Obligatoire]
 
 *   **contactFindOptions**: recherche d'options pour filtrer navigator.contacts. [Facultatif] Clés incluent :
+
+*   **filtre**: la chaîne de recherche utilisée pour trouver navigator.contacts. *(DOMString)* (Par défaut :`""`)
+
+*   **multiples**: détermine si l'opération find retourne plusieurs navigator.contacts. *(Booléen)* (Par défaut :`false`)
     
-    *   **filtre**: la chaîne de recherche utilisée pour trouver navigator.contacts. *(DOMString)* (Par défaut :`""`)
-    
-    *   **multiples**: détermine si l'opération find retourne plusieurs navigator.contacts. *(Booléen)* (Par défaut :`false`)
+    *   **desiredFields**: Contactez champs soit retourné en arrière. Si spécifié, l'entraînant `Contact` objet dispose seulement des valeurs de ces champs. *(DOMString[])* [Facultatif]
 
 ### Plates-formes prises en charge
 
@@ -110,12 +118,11 @@ La chaîne **contactFindOptions.filter** peut être utilisée comme un filtre de
 *   Firefox OS
 *   iOS
 *   Windows Phone 7 et 8
-*   Windows 8
 
 ### Exemple
 
     function onSuccess(contacts) {
-        alert('Found ' + navigator.contacts.length + ' navigator.contacts.');
+        alert('Found ' + contacts.length + ' contacts.');
     };
     
     function onError(contactError) {
@@ -126,53 +133,80 @@ La chaîne **contactFindOptions.filter** peut être utilisée comme un filtre de
     var options      = new ContactFindOptions();
     options.filter   = "Bob";
     options.multiple = true;
-    var fields       = ["displayName", "name"];
-    navigator.contacts.find(fields, onSuccess, onError, options);
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(onSuccess, onError, fields, options);
+    
+
+## navigator.contacts.pickContact
+
+La `navigator.contacts.pickContact` méthode lance le sélecteur de Contact pour sélectionner un contact unique. L'objet qui en résulte est passé à la `contactSuccess` la fonction de rappel spécifiée par le paramètre **contactSuccess** .
+
+### Paramètres
+
+*   **contactSuccess**: fonction de rappel de succès appelée avec l'objet de Contact unique. [Obligatoire]
+
+*   **contactError**: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Facultatif]
+
+### Plates-formes prises en charge
+
+*   Android
+*   iOS
+*   Windows Phone 8
+*   Windows 8
+
+### Exemple
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
     
 
 ## Contact
 
-L'objet `Contact` représente un contact de l'utilisateur. Des contacts peuvent être créés, stockés ou supprimés de la base de données de contacts de l'appareil. Contacts peuvent également être récupérées (individuellement ou en vrac) de la base de données en appelant le `navigator.contacts.find` méthode.
+Le `Contact` objet représente le contact de l'utilisateur. Contacts peuvent être créés, conservés ou supprimés de la base de données de contacts de dispositif. Contacts peuvent également être récupérées (individuellement ou en vrac) de la base de données en appelant le `navigator.contacts.find` méthode.
 
 **NOTE**: tous les champs de contact susmentionnés ne sont pris en charge sur chaque plate-forme de périphérique. S'il vous plaît vérifier la section *bizarreries* de chaque plate-forme pour plus de détails.
 
 ### Propriétés
 
-*   **id** : un identifiant globalement unique. *(DOMString)*
+*   **ID**: un identificateur global unique. *(DOMString)*
 
 *   **displayName**: le nom de ce Contact, approprié pour l'affichage à l'utilisateur final. *(DOMString)*
 
-*   **name** : un objet contenant tous les composants du nom de la personne. *(ContactName)*
+*   **nom**: un objet contenant tous les composants d'un nom de personnes. *(ContactName)*
 
-*   **nickname** : un nom occasionnel se référant au contact. *(DOMString)*
+*   **Pseudo**: un nom occasionnel permettant de régler le contact. *(DOMString)*
 
-*   **phoneNumbers** : un tableau des numéros de téléphone du contact. *(ContactField[])*
+*   **phoneNumbers**: un tableau des numéros de téléphone du contact. *(ContactField[])*
 
-*   **emails** : un tableau des adresses email du contact. *(ContactField[])*
+*   **courriels**: un tableau d'adresses de courriel du contact. *(ContactField[])*
 
-*   **addresses** : un tableau contenant toutes les adresses du contact. *(ContactAddress[])*
+*   **adresses**: un tableau d'adresses tous les contacts. *(ContactAddress[])*
 
-*   **ims** : un tableau contenant les adresses de messagerie instantanée du contact. *(ContactField[])*
+*   **IMS**: un tableau d'adresses IM tout le contact. *(ContactField[])*
 
-*   **organizations** : un tableau contenant les organismes liés au contact. *(ContactOrganization[])*
+*   **organisations**: un tableau des organisations de tout le contact. *(ContactOrganization[])*
 
-*   **birthday** : la date d'anniversaire du contact. *(Date)*
+*   **anniversaire**: l'anniversaire du contact. *(Date)*
 
-*   **note** : une remarque à propos du contact. *(DOMString)*
+*   **Remarque**: une remarque sur le contact. *(DOMString)*
 
-*   **photos** : un tableau de photos du contact. *(ContactField[])*
+*   **photos**: un tableau de photos du contact. *(ContactField[])*
 
-*   **categories** : un tableau de toutes les catégories définies par l'utilisateur attribuées au contact. *(ContactField[])*
+*   **catégories**: un tableau de toutes les catégories définies par l'utilisateur attribuée au contact. *(ContactField[])*
 
-*   **urls** : un tableau d'adresses Web attribuées au contact. *(ContactField[])*
+*   **URL**: un tableau des pages web attribuée au contact. *(ContactField[])*
 
 ### Méthodes
 
-*   **clone** : retourne un nouvel objet `Contact`, copie récursive de l'objet cloné, sa propriété `id` vaudra cependant `null`.
+*   **Clone**: retourne un nouveau `Contact` objet qui est une copie complète de l'objet appelant, avec le `id` propriété la valeur`null`.
 
-*   **remove** : supprime le contact de la base de données de contacts de l'appareil, sinon exécute une fonction callback d'erreur en lui passant un objet `ContactError`.
+*   **supprimer**: supprime le contact de la base de données de contacts de dispositif, sinon exécute un rappel d'erreur avec un `ContactError` objet.
 
-*   **save** : enregistre un nouveau contact dans la base de données de contacts de l'appareil, ou met à jour un contact existant si un contact avec le même **id** existe déjà.
+*   **Enregistrer**: enregistre un nouveau contact dans la base de données de contacts de périphérique, ou met à jour un contact existant, si un contact avec le même **id** existe déjà.
 
 ### Plates-formes prises en charge
 
@@ -228,37 +262,17 @@ L'objet `Contact` représente un contact de l'utilisateur. Des contacts peuvent
         alert("Error = " + contactError.code);
     };
     
-        // remove the contact from the device
-        contact.remove(onSuccess,onError);
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
     
 
-### Notes au sujet d'Android 2.X
+### Android 2.X Quirks
 
-*   **categories** : non pris en charge sur les périphériques Android 2.X, valeur `null`.
+*   **catégories**: non pris en charge sur les périphériques Android 2.X, retour`null`.
 
 ### BlackBerry 10 Quirks
 
-*   **id** : supporté, attribué par l'appareil lors de l'enregistrement du contact.
-
-*   **displayName** : supporté, stocké dans le champ BlackBerry **user1**.
-
-*   **nickname** : pas pris en charge, valeur `null`.
-
-*   **phoneNumbers** : partiellement pris en charge. Les numéros de téléphone sont enregistrés dans les champs BlackBerry **homePhone1** et **homePhone2** si le *type* est 'home', **workPhone1** et **workPhone2** si le *type* est 'work', **mobilePhone** si le *type* est 'mobile', **faxPhone** si le *type* est 'fax', **pagerPhone** si le *type* est 'pager' et **otherPhone** si le *type* n'est aucun de ceux listés.
-
-*   **emails** : partiellement pris en charge. Les trois premières adresses sont stockées respectivement dans les champs BlackBerry **email1**, **email2**et **email3**.
-
-*   **addresses** : partiellement pris en charge. La première et la deuxième adresse sont stockées respectivement dans les champs BlackBerry **homeAddress** et **workAddress**.
-
-*   **ims** : pas supporté, valeur `null`.
-
-*   **organizations** : partiellement pris en charge. Les propriétés **name** et **title** du premier organisme sont stockées respectivement dans les champs BlackBerry **company** et **title**.
-
-*   **photos** : partiellement pris en charge. Seule une miniature est supportée. Pour définir la photo d'un contact, passez soit une image encodée en base64, soit une URL pointant vers l'image souhaitée. L'image sera réduite avant d'être enregistrée dans la base de données de contacts BlackBerry. La photo du contact sera ensuite retournée en tant qu'image encodée en base64.
-
-*   **categories** : partiellement pris en charge. Seules les catégories *Business* et *Personal* sont supportées.
-
-*   **urls** : partiellement pris en charge. La première URL est stockée dans le champ BlackBerry **webpage**.
+*   **ID**: assignés par l'appareil lors de l'enregistrement du contact.
 
 ### Bizarreries de FirefoxOS
 
@@ -270,57 +284,57 @@ L'objet `Contact` représente un contact de l'utilisateur. Des contacts peuvent
 
 ### iOS Quirks
 
-*   **displayName** : pas pris en charge, valeur `null` à moins qu'il n'y ait aucun `ContactName` spécifié, auquel cas, renvoie le nom composite : **nickname** ou `""`.
+*   **displayName**: ne pas possible sur iOS, retour `null` à moins qu'il n'y a aucun `ContactName` spécifié, auquel cas, il renvoie le nom composite, **Pseudo** ou `""` , respectivement.
 
-*   **birthday** : doit être un object `Date` JavaScript, il sera aussi retourné en tant que tel.
+*   **anniversaire**: doit être entré comme un JavaScript `Date` objet, de la même façon qu'il soit retourné.
 
-*   **photos** : renvoie une URL de fichier de l'image stockée dans le répertoire temporaire de l'application. Le contenu de ce dernier est supprimé lorsque l'application est fermée.
+*   **photos**: retourne une URL de fichier de l'image, qui est stocké dans le répertoire temporaire de l'application. Contenu du répertoire temporaire est supprimés lorsque l'application se ferme.
 
-*   **categories** : cette propriété n'est actuellement pas supportée, valeur `null`.
+*   **catégories**: cette propriété n'est actuellement pas supportée, retour`null`.
 
 ### Windows Phone 7 et 8 Quirks
 
-*   **displayName** : lorsqu'un contact est créé, la valeur fournie pour le paramètre de nom d'affichage est différente de celle récupérée lors de la récupération ultérieure du contact.
+*   **displayName**: lorsque vous créez un contact, la valeur fournie pour le paramètre de nom d'affichage est différent de l'affichage nom Récupérée lors de la recherche du contact.
 
 *   **URL**: lorsque vous créez un contact, les utilisateurs peuvent entrer et enregistrer plus d'une adresse web, mais seulement un est disponible lors de la recherche du contact.
 
-*   **phoneNumbers** : l'option *pref* n'est pas prise en charge. Le *type* n'est pas supporté lors d'un appel à *find*. Seul `phoneNumber` est autorisé pour chaque *type*.
+*   **phoneNumbers**: l'option de *pref* n'est pas pris en charge. Le *type* n'est pas pris en charge lors d'une opération de *trouver* . Seul `phoneNumber` est autorisé pour chaque *type*.
 
-*   **emails** : l'option *pref* n'est pas prise en charge. Maison et personnel font référence à la même entrée d'email. Une seule entrée est autorisée pour chaque *type*.
+*   **courriels**: l'option de *pref* n'est pas pris en charge. Accueil et personnels références même courriel entrée. Une seule participation est autorisée pour chaque *type*.
 
-*   **addresses** : prend en charge seulement les *type*s travail et maison/personnel. Les *type*s maison et personnel font référence à la même entrée d'adresse. Une seule entrée est autorisée pour chaque *type*.
+*   **adresses**: prend en charge seulement travail et accueil/personal *type*. La maison et personnels de *type* référence la même entrée d'adresse. Une seule participation est autorisée pour chaque *type*.
 
-*   **organizations** : une seule entrée autorisée, les attributs *pref*, *type* et *department* ne sont pas supportés.
+*   **organisations**: seul est autorisé et ne supporte pas les attributs *pref*, *type*et *Département* .
 
-*   **note** : pas pris en charge, valeur `null`.
+*   **Remarque**: ne pas pris en charge, retour`null`.
 
 *   **IMS**: ne pas pris en charge, retour`null`.
 
-*   **birthdays** : pas pris en charge, valeur `null`.
+*   **anniversaires**: ne pas pris en charge, retour`null`.
 
-*   **categories** : pas pris en charge, valeur `null`.
+*   **catégories**: ne pas pris en charge, retour`null`.
 
 ## ContactAddress
 
-L'objet `ContactAddress` stocke les propriétés d'une seule adresse d'un contact. Un objet `Contact` peut inclure plusieurs adresses dans un tableau `ContactAddress[]`.
+Le `ContactAddress` objet Stocke les propriétés d'une seule adresse d'un contact. A `Contact` objet peut inclure plusieurs adresses dans un `ContactAddress[]` tableau.
 
 ### Propriétés
 
-*   **pref** : la valeur `true` si `ContactAddress` contient la valeur de préférence de l'utilisateur. *(booléen)*
+*   **pref**: la valeur `true` si ce `ContactAddress` contient la valeur de préférence de l'utilisateur. *(booléen)*
 
-*   **type** : une chaîne qui indique le type de champ, *maison* par exemple. *(DOMString)*
+*   **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. *(DOMString)*
 
-*   **formatted** : l'adresse complète formattée pour l'affichage. *(DOMString)*
+*   **mise en forme**: l'adresse complète au format pour l'affichage. *(DOMString)*
 
-*   **streetAddress** : l'adresse complète. *(DOMString)*
+*   **adresse**: l'adresse complète. *(DOMString)*
 
-*   **locality** : la ville ou la localité. *(DOMString)*
+*   **localité**: la ville ou la localité. *(DOMString)*
 
-*   **region** : l'État ou la région. *(DOMString)*
+*   **région**: l'État ou la région. *(DOMString)*
 
-*   **postalCode** : le code zip ou code postal. *(DOMString)*
+*   **Code postal**: le code zip ou code postal. *(DOMString)*
 
-*   **country** : le nom du pays. *(DOMString)*
+*   **pays**: le nom du pays. *(DOMString)*
 
 ### Plates-formes prises en charge
 
@@ -337,7 +351,7 @@ L'objet `ContactAddress` stocke les propriétés d'une seule adresse d'un contac
     // display the address information for all contacts
     
     function onSuccess(contacts) {
-        for (var i = 0; i < navigator.contacts.length; i++) {
+        for (var i = 0; i < contacts.length; i++) {
             for (var j = 0; j < contacts[i].addresses.length; j++) {
                 alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
                     "Type: "           + contacts[i].addresses[j].type          + "\n" +
@@ -364,25 +378,25 @@ L'objet `ContactAddress` stocke les propriétés d'une seule adresse d'un contac
 
 ### Android 2.X Quirks
 
-*   **pref** : non pris en charge, retourne `false` sur les appareils Android 2.X.
+*   **pref**: ne pas pris en charge, retour `false` sur les appareils Android 2.X.
 
 ### BlackBerry 10 Quirks
 
-*   **pref** : non pris en charge sur les appareils BlackBerry, retourne `false`.
+*   **pref**: non pris en charge sur les appareils BlackBerry, retour`false`.
 
-*   **type** : partiellement pris en charge. Seulement un des types d'adresse *Work* et *Home* peut être stocké par contact.
+*   **type**: partiellement pris en charge. Seule chaque de *travail* et tapez les adresses de *la maison* peut être stockée par contact.
 
-*   **formatted** : partiellement pris en charge. Retourne la concaténation de tous les champs d'adresse BlackBerry.
+*   **au format**: partiellement pris en charge. Retourne la concaténation de tous les champs d'adresse BlackBerry.
 
-*   **streetAddress** : pris en charge. Retourne la concaténation des champs d'adresse BlackBerry **address1** et **address2**.
+*   **streetAddress**: prise en charge. Retourne la concaténation de BlackBerry **address1** et **address2** champs d'adresse.
 
-*   **locality** : prise en charge. Stockée dans le champ d'adresse BlackBerry **city** .
+*   **localité**: prise en charge. Stockée dans le champ d'adresse BlackBerry **ville** .
 
-*   **region** : pris en charge. Stockée dans le champ d'adresse BlackBerry **stateProvince** .
+*   **région**: pris en charge. Stockée dans le champ d'adresse BlackBerry **stateProvince** .
 
-*   **postalCode** : prise en charge. Stockée dans le champ d'adresse BlackBerry **zipPostal** .
+*   **Code postal**: prise en charge. Stockée dans le champ d'adresse BlackBerry **zipPostal** .
 
-*   **country** : prise en charge.
+*   **pays**: prise en charge.
 
 ### Bizarreries de FirefoxOS
 
@@ -390,41 +404,45 @@ L'objet `ContactAddress` stocke les propriétés d'une seule adresse d'un contac
 
 ### iOS Quirks
 
-*   **pref** : non pris en charge sur les appareils iOS, retourne `false`.
+*   **pref**: non pris en charge sur les appareils iOS, retour`false`.
+
+*   **au format**: actuellement ne pas pris en charge.
+
+### Bizarreries de Windows 8
 
-*   **formatted** : actuellement non pris en charge.
+*   **pref**: non pris en charge
 
 ## ContactError
 
-L'objet `ContactError` est retourné à l'utilisateur via la fonction de callback `contactError` lorsqu'une erreur survient.
+Le `ContactError` objet est retourné à l'utilisateur via le `contactError` fonction de rappel lorsqu'une erreur survient.
 
 ### Propriétés
 
-*   **code** : l'un des codes d'erreur prédéfinis énumérés ci-dessous.
+*   **code**: l'un des codes d'erreur prédéfinis énumérés ci-dessous.
 
 ### Constantes
 
-*   `ContactError.UNKNOWN_ERROR`
-*   `ContactError.INVALID_ARGUMENT_ERROR`
-*   `ContactError.TIMEOUT_ERROR`
-*   `ContactError.PENDING_OPERATION_ERROR`
-*   `ContactError.IO_ERROR`
-*   `ContactError.NOT_SUPPORTED_ERROR`
-*   `ContactError.PERMISSION_DENIED_ERROR`
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
 
 ## ContactField
 
-L'objet `ContactField` est un composant réutilisable que représente un champ de contact générique. Chaque objet `ContactField` contient une propriété `value` , `type` , et `pref`. Un objet `Contact` stocke plusieurs propriétés dans les tableaux `ContactField[]`, tels que les numéros de téléphone et adresses e-mail.
+Le `ContactField` objet est un composant réutilisable que représente contacter champs génériquement. Chaque `ContactField` objet contient un `value` , `type` , et `pref` propriété. A `Contact` objet stocke plusieurs propriétés dans `ContactField[]` tableaux, tels que téléphone numéros et adresses e-mail.
 
-Dans la plupart des cas, il n'y a pas de valeurs prédéterminées pour un attribut **type** de l'objet `ContactField`. Par exemple, un numéro de téléphone peut spécifier des valeurs pour **type** comme *home*, *work*, *mobile*, *iPhone*, ou toute autre valeur qui est prise en charge par la base de contacts de la plate-forme d'un appareil particulier. Toutefois, pour le champ **photos** de `Contact` , le champ **type** indique le format de l'image retournée : **url** lorsque l'attribut **value** contient une URL vers la photo ou *base64* lorsque la **valeur** contient une chaîne d'image codée en base64. 
+Dans la plupart des cas, il n'y a pas de valeurs prédéterminées pour une `ContactField` l'attribut **type** de l'objet. Par exemple, un numéro de téléphone peut spécifier des valeurs de **type** de la *maison*, *travail*, *mobile*, *iPhone*ou toute autre valeur qui est pris en charge par la base de contacts de la plate-forme un périphérique particulier. Toutefois, pour les `Contact` **photos** champ, le champ **type** indique le format de l'image retournée : **url** lorsque l'attribut **value** contient une URL vers l'image photo ou *base64* lorsque la **valeur** contient une chaîne codée en base64 image.
 
 ### Propriétés
 
-*   **type** : une chaîne qui indique le type de champ, *home* par exemple. *(DOMString)*
+*   **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. *(DOMString)*
 
-*   **value** : la valeur du champ, comme un téléphone numéro ou adresse e-mail. *(DOMString)*
+*   **valeur**: la valeur du champ, comme un téléphone numéro ou adresse e-mail. *(DOMString)*
 
-*   **pref** : la valeur `true` si `ContactField` contient la valeur de préférence de l'utilisateur. *(booléen)*
+*   **pref**: la valeur `true` si ce `ContactField` contient la valeur de préférence de l'utilisateur. *(booléen)*
 
 ### Plates-formes prises en charge
 
@@ -454,13 +472,13 @@ Dans la plupart des cas, il n'y a pas de valeurs prédéterminées pour un attri
 
 ### Quirks Android
 
-*   **pref** : nonpas pris en charge, retourne `false`.
+*   **pref**: ne pas pris en charge, retour`false`.
 
 ### BlackBerry 10 Quirks
 
-*   **type** : partiellement pris en charge. Utilisé pour les numéros de téléphone.
+*   **type**: partiellement pris en charge. Utilisé pour les numéros de téléphone.
 
-*   **valeur** : pris en charge.
+*   **valeur**: prise en charge.
 
 *   **pref**: ne pas pris en charge, retour`false`.
 
@@ -468,23 +486,27 @@ Dans la plupart des cas, il n'y a pas de valeurs prédéterminées pour un attri
 
 *   **pref**: ne pas pris en charge, retour`false`.
 
+### Quirks Windows8
+
+*   **pref**: ne pas pris en charge, retour`false`.
+
 ## ContactName
 
-Contient différents types d'informations sur le nom d'un objet `Contact`.
+Contient différents types d'informations sur un `Contact` nom de l'objet.
 
 ### Propriétés
 
-*   **mise en forme** : le nom complet du contact. *(DOMString)*
+*   **mise en forme**: le nom complet du contact. *(DOMString)*
 
-*   **familyName** : nom de famille du contact. *(DOMString)*
+*   **familyName**: nom de famille du contact. *(DOMString)*
 
-*   **givenName** : prénom du contact. *(DOMString)*
+*   **givenName**: prénom du contact. *(DOMString)*
 
-*   **middleName** : deuxième prénom du contact. *(DOMString)*
+*   **middleName**: deuxième prénom du contact. *(DOMString)*
 
-*   **honorificPrefix** : préfixe du contact (exemple *M.* ou *Mme*) *(DOMString)*
+*   **honorificPrefix**: préfixe du contact (exemple *M.* ou *Mme*) *(DOMString)*
 
-*   **honorificSuffix** : suffixe du contact (exemple *Esq.*). *(DOMString)*
+*   **honorificSuffix**: suffixe du contact (exemple *Esq.*). *(DOMString)*
 
 ### Plates-formes prises en charge
 
@@ -499,7 +521,7 @@ Contient différents types d'informations sur le nom d'un objet `Contact`.
 ### Exemple
 
     function onSuccess(contacts) {
-        for (var i = 0; i < navigator.contacts.length; i++) {
+        for (var i = 0; i < contacts.length; i++) {
             alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
                 "Family Name: "  + contacts[i].name.familyName      + "\n" +
                 "Given Name: "   + contacts[i].name.givenName       + "\n" +
@@ -521,21 +543,21 @@ Contient différents types d'informations sur le nom d'un objet `Contact`.
 
 ### Quirks Android
 
-*   **formatted** : partiellement pris en charge et en lecture seule. Retourne la concaténation de `honorificPrefix` , `givenName` , `middleName` , `familyName` , et `honorificSuffix`.
+*   **au format**: partiellement pris en charge et en lecture seule. Retourne la concaténation de `honorificPrefix` , `givenName` , `middleName` , `familyName` , et`honorificSuffix`.
 
 ### BlackBerry 10 Quirks
 
-*   **formatted** : partiellement pris en charge. Retourne la concaténation de champs **firstName** et **lastName** de BlackBerry.
+*   **au format**: partiellement pris en charge. Retourne la concaténation de champs **firstName** et **lastName** de BlackBerry.
 
-*   **familyName** : prise en charge. Stockée dans le champ **lastName** BlackBerry.
+*   **familyName**: prise en charge. Stockée dans le champ **lastName** BlackBerry.
 
-*   **givenName** : prise en charge. Stockée dans le champ **firstName** BlackBerry.
+*   **givenName**: prise en charge. Stockée dans le champ **firstName** BlackBerry.
 
-*   **middleName** : non pris en charge, retourne `null`.
+*   **middleName**: ne pas pris en charge, retour`null`.
 
-*   **honorificPrefix** : non pris en charge, retourne `null`.
+*   **honorificPrefix**: ne pas pris en charge, retour`null`.
 
-*   **honorificSuffix** : non pris en charge, retourne `null`.
+*   **honorificSuffix**: ne pas pris en charge, retour`null`.
 
 ### Bizarreries de FirefoxOS
 
@@ -543,23 +565,37 @@ Contient différents types d'informations sur le nom d'un objet `Contact`.
 
 ### iOS Quirks
 
-*   **formatted** : partiellement pris en charge. Retourne le nom composé iOS, mais est en lecture seule.
+*   **au format**: partiellement pris en charge. Retourne la dénomination composée d'iOS, mais est en lecture seule.
+
+### Bizarreries de Windows 8
+
+*   **au format**: c'est le seul nom de propriété et est identique à `displayName` , et`nickname`
+
+*   **familyName**: non pris en charge
+
+*   **givenName**: non pris en charge
+
+*   **middleName**: non pris en charge
+
+*   **honorificPrefix**: non pris en charge
+
+*   **honorificSuffix**: non pris en charge
 
 ## ContactOrganization
 
-L'objet `ContactOrganization` stocke des propriétés de l'entreprise d'un contact. Un objet `Contact` contient un ou plusieurs objets `ContactOrganization` dans un tableau.
+Le `ContactOrganization` objet Stocke des propriétés un contact de l'organisation. A `Contact` objet contient un ou plusieurs `ContactOrganization` des objets dans un tableau.
 
 ### Propriétés
 
-*   **pref** : fixé à `true` si `ContactOrganization` contient la valeur préférée de l'utilisateur. *(booléen)*
+*   **pref**: la valeur `true` si ce `ContactOrganization` contient la valeur de préférence de l'utilisateur. *(booléen)*
 
-*   **type** : une chaîne qui indique le type de champ, *home* par exemple. _(DOMString)
+*   **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. _(DOMString)
 
-*   **name** : le nom de l'organisation. *(DOMString)*
+*   **nom**: le nom de l'organisation. *(DOMString)*
 
-*   **department** : le département pour lequel travaille le contact. *(DOMString)*
+*   **Département**: le département et le contrat de travaille pour. *(DOMString)*
 
-*   **title** : titre du contact au sein de l'organisation. *(DOMString)*
+*   **titre**: titre du contact auprès de l'organisation. *(DOMString)*
 
 ### Plates-formes prises en charge
 
@@ -568,12 +604,11 @@ L'objet `ContactOrganization` stocke des propriétés de l'entreprise d'un conta
 *   Firefox OS
 *   iOS
 *   Windows Phone 7 et 8
-*   Windows 8
 
 ### Exemple
 
     function onSuccess(contacts) {
-        for (var i = 0; i < navigator.contacts.length; i++) {
+        for (var i = 0; i < contacts.length; i++) {
             for (var j = 0; j < contacts[i].organizations.length; j++) {
                 alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
                     "Type: "        + contacts[i].organizations[j].type       + "\n" +
@@ -596,19 +631,19 @@ L'objet `ContactOrganization` stocke des propriétés de l'entreprise d'un conta
 
 ### Android 2.X Quirks
 
-*   **pref** : non pris en charge par des appareils Android 2.X, retourne `false`.
+*   **pref**: ne pas pris en charge par des dispositifs Android 2.X, retour`false`.
 
 ### BlackBerry 10 Quirks
 
-*   **pref** : non pris en charge par les appareils BlackBerry, retourne `false`.
+*   **pref**: ne pas pris en charge par les appareils BlackBerry, retour`false`.
 
-*   **type**: non pris en charge par les appareils BlackBerry, retourne `null`.
+*   **type**: ne pas pris en charge par les appareils BlackBerry, retour`null`.
 
-*   **name** : partiellement pris en charge. Le premier nom de l'entreprise est stocké dans le champ **company** de BlackBerry.
+*   **nom**: partiellement pris en charge. Le premier nom de l'organisme est stocké dans le champ **company** de BlackBerry.
 
-*   **department** : non pris en charge, retourne `null`.
+*   **Département**: ne pas pris en charge, retour`null`.
 
-*   **title** : partiellement pris en charge. Le premier titre de l'entreprise est stocké dans le champ de **jobTitle** BlackBerry.
+*   **titre**: partiellement pris en charge. Le premier titre de l'organisation est stocké dans le champ de **jobTitle** BlackBerry.
 
 ### Firefox OS Quirks
 
@@ -624,10 +659,10 @@ L'objet `ContactOrganization` stocke des propriétés de l'entreprise d'un conta
 
 *   **pref**: non pris en charge sur les appareils iOS, retour`false`.
 
-*   **type** : non pris en charge sur les appareils iOS, retourne `null`.
+*   **type**: non pris en charge sur les appareils iOS, retour`null`.
 
-*   **name** : partiellement pris en charge. Le premier nom de l'entreprise est stocké dans le champ de **kABPersonOrganizationProperty** iOS.
+*   **nom**: partiellement pris en charge. Le premier nom de l'organisme est stocké dans le champ de **kABPersonOrganizationProperty** iOS.
 
-*   **department** : partiellement pris en charge. Le premier nom de département est stocké dans le champ de **kABPersonDepartmentProperty** iOS.
+*   **Département**: partiellement pris en charge. Le premier nom de département est stocké dans le champ de **kABPersonDepartmentProperty** iOS.
 
-*   **title** : partiellement pris en charge. Le premier titre est stocké dans le champ **kABPersonJobTitleProperty** iOS.
\ No newline at end of file
+*   **titre**: partiellement pris en charge. Le premier titre est stocké dans le champ de **kABPersonJobTitleProperty** iOS.
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/efb6b948/doc/it/index.md
----------------------------------------------------------------------
diff --git a/doc/it/index.md b/doc/it/index.md
new file mode 100644
index 0000000..5d67901
--- /dev/null
+++ b/doc/it/index.md
@@ -0,0 +1,668 @@
+<!---
+    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.contacts
+
+Fornisce l'accesso al database di contatti del dispositivo.
+
+**Avviso**: raccolta e utilizzo dei dati di contatto solleva questioni di privacy importante. Politica sulla privacy dell'app dovrebbe discutere come app utilizza i dati di contatto e se è condiviso con altre parti. Informazioni di contatto sono considerate sensibile perché rivela le persone con cui una persona comunica. Pertanto, oltre alla politica di privacy dell'app, è fortemente consigliabile fornendo un preavviso di just-in-time prima app accede o utilizza i dati di contatto, se il sistema operativo del dispositivo non farlo già. Tale comunicazione deve fornire le informazioni stesse notate sopra, oltre ad ottenere l'autorizzazione (ad esempio, presentando scelte per **OK** e **No grazie**). Si noti che alcuni mercati app possono richiedere l'app per fornire un preavviso di just-in-time e ottenere l'autorizzazione dell'utente prima di accedere ai dati di contatto. Un'esperienza utente chiara e facile--capisce che circonda l'uso del contatto dati aiuta a evitare la confusio
 ne dell'utente e percepito un uso improprio dei dati di contatto. Per ulteriori informazioni, vedere la guida sulla Privacy.
+
+## Installazione
+
+    cordova plugin add org.apache.cordova.contacts
+    
+
+### Firefox OS stranezze
+
+Creare **www/manifest.webapp** come descritto nel [Manifesto Docs][1]. Aggiungi permisions rilevanti. C'è anche la necessità di modificare il tipo di webapp in "privilegiato" - [Manifesto Docs][2]. **AVVERTENZA**: tutte le apps privilegiato applicare [Content Security Policy][3] che vieta script inline. Inizializzare l'applicazione in un altro modo.
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+    "type": "privileged",
+    "permissions": {
+        "contacts": {
+            "access": "readwrite",
+            "description": "Describe why there is a need for such permission"
+        }
+    }
+    
+
+### Stranezze di Windows 8
+
+Windows 8 contatti sono readonly. Tramite i contatti di Cordova API non sono queryable/ricerche, si dovrebbe informare l'utente di scegliere un contatto come una chiamata a contacts.pickContact che aprirà l'app 'Persone' dove l'utente deve scegliere un contatto. Eventuali contatti restituiti sono readonly, quindi l'applicazione non può modificarli.
+
+## Navigator.contacts
+
+### Metodi
+
+*   navigator.contacts.create
+*   navigator.contacts.find
+*   navigator.contacts.pickContact
+
+### Oggetti
+
+*   Contatto
+*   ContactName
+*   ContactField
+*   ContactAddress
+*   ContactOrganization
+*   ContactFindOptions
+*   ContactError
+*   ContactFieldType
+
+## Navigator.contacts.Create
+
+Il `navigator.contacts.create` metodo sincrono e restituisce un nuovo `Contact` oggetto.
+
+Questo metodo non mantiene l'oggetto contatto nel database contatti dispositivo, per cui è necessario richiamare il `Contact.save` metodo.
+
+### Piattaforme supportate
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+
+### Esempio
+
+    var myContact = navigator.contacts.create({"displayName": "Test User"});
+    
+
+## navigator.contacts.find
+
+Il `navigator.contacts.find` metodo in modo asincrono, esegue una query sul database di contatti del dispositivo e restituisce una matrice di `Contact` oggetti. Gli oggetti risultanti sono passati per la `contactSuccess` funzione di callback specificato dal parametro **contactSuccess** .
+
+Il parametro **contactFields** specifica i campi per essere utilizzato come un qualificatore di ricerca. Un parametro di lunghezza zero, **contactFields** non è valido e si traduce in `ContactError.INVALID_ARGUMENT_ERROR` . Un valore di **contactFields** di `"*"` restituisce tutti i contatti di campi.
+
+La stringa di **contactFindOptions.filter** può essere utilizzata come un filtro di ricerca quando una query sul database di contatti. Se fornito, una distinzione, corrispondenza parziale valore viene applicato a ogni campo specificato nel parametro **contactFields** . Se esiste una corrispondenza per *qualsiasi* dei campi specificati, viene restituito il contatto. Uso **contactFindOptions.desiredFields** parametro di controllo quale contattare la proprietà deve essere rispedito indietro.
+
+### Parametri
+
+*   **contactSuccess**: funzione di callback successo richiamato con la matrice di oggetti contatto restituiti dal database. [Richiesto]
+
+*   **contactError**: funzione di callback di errore, viene richiamato quando si verifica un errore. [Facoltativo]
+
+*   **contactFields**: contattare campi da utilizzare come un qualificatore di ricerca. *(DOMString[])* [Richiesto]
+
+*   **contactFindOptions**: opzioni per filtrare navigator.contacts di ricerca. [Facoltativo] I tasti sono:
+
+*   **filtro**: la stringa di ricerca utilizzata per trovare navigator.contacts. *(DOMString)* (Default:`""`)
+
+*   **multiple**: determina se l'operazione di ricerca restituisce più navigator.contacts. *(Booleano)* (Default:`false`)
+    
+    *   **desiredFields**: contattare i campi per essere tornato indietro. Se specificato, il conseguente `Contact` oggetto presenta solo i valori per questi campi. *(DOMString[])* [Facoltativo]
+
+### Piattaforme supportate
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+
+### Esempio
+
+    function onSuccess(contacts) {
+        alert('Found ' + contacts.length + ' contacts.');
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts with 'Bob' in any name field
+    var options      = new ContactFindOptions();
+    options.filter   = "Bob";
+    options.multiple = true;
+    options.desiredFields = [navigator.contacts.fieldType.id];
+    var fields       = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+    navigator.contacts.find(onSuccess, onError, fields, options);
+    
+
+## navigator.contacts.pickContact
+
+Il `navigator.contacts.pickContact` Metodo lancia il contatto selettore per selezionare un singolo contatto. L'oggetto risultante è passato per la `contactSuccess` funzione di callback specificato dal parametro **contactSuccess** .
+
+### Parametri
+
+*   **contactSuccess**: funzione di callback di successo viene richiamato con il singolo oggetto di contatto. [Richiesto]
+
+*   **contactError**: funzione di callback di errore, viene richiamato quando si verifica un errore. [Facoltativo]
+
+### Piattaforme supportate
+
+*   Android
+*   iOS
+*   Windows Phone 8
+*   Windows 8
+
+### Esempio
+
+    navigator.contacts.pickContact(function(contact){
+            console.log('The following contact has been selected:' + JSON.stringify(contact));
+        },function(err){
+            console.log('Error: ' + err);
+        });
+    
+
+## Contatto
+
+Il `Contact` oggetto rappresenta il contatto di un utente. Contatti possono essere creati, memorizzati o rimossi dal database di contatti dispositivo. Contatti possono anche essere estratto (singolarmente o in blocco) dal database richiamando il `navigator.contacts.find` metodo.
+
+**Nota**: non tutti i campi di contatto sopra elencati sono supportati su ogni piattaforma del dispositivo. Consultare la sezione di *stranezze* su ogni piattaforma per dettagli.
+
+### Proprietà
+
+*   **ID**: un identificatore univoco globale. *(DOMString)*
+
+*   **displayName**: il nome di questo contatto, adatto per la visualizzazione a utenti finali. *(DOMString)*
+
+*   **nome**: un oggetto che contiene tutti i componenti di un nome di persone. *(ContactName)*
+
+*   **Nickname**: un nome informale con cui affrontare il contatto. *(DOMString)*
+
+*   **phoneNumbers**: una matrice di numeri di telefono del contatto. *(ContactField[])*
+
+*   **email**: una matrice di indirizzi di posta elettronica del contatto. *(ContactField[])*
+
+*   **indirizzi**: una matrice di indirizzi di contatto. *(ContactAddress[])*
+
+*   **IMS**: una matrice di indirizzi IM tutto il contatto. *(ContactField[])*
+
+*   **organizzazioni**: una matrice di organizzazioni di tutto il contatto. *(ContactOrganization[])*
+
+*   **compleanno**: il compleanno del contatto. *(Data)*
+
+*   **Nota**: una nota sul contatto. *(DOMString)*
+
+*   **foto**: una matrice di foto del contatto. *(ContactField[])*
+
+*   **categorie**: matrice di tutte le categorie definite dall'utente connesso con il contatto. *(ContactField[])*
+
+*   **URL**: matrice di pagine web connesso con il contatto. *(ContactField[])*
+
+### Metodi
+
+*   **clone**: restituisce una nuova `Contact` oggetto che è una copia completa dell'oggetto chiamante, con la `id` proprietà impostata`null`.
+
+*   **rimuovere**: rimuove il contatto dal database contatti dispositivo, altrimenti esegue un callback di errore con un `ContactError` oggetto.
+
+*   **Salva**: salva un nuovo contatto nel database di contatti del dispositivo, o aggiorna un contatto esistente se esiste già un contatto con lo stesso **id** .
+
+### Piattaforme supportate
+
+*   Amazon fuoco OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+*   Windows 8
+
+### Esempio di salvare
+
+    function onSuccess(contact) {
+        alert("Save Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // create a new contact object
+    var contact = navigator.contacts.create();
+    contact.displayName = "Plumber";
+    contact.nickname = "Plumber";            // specify both to support all devices
+    
+    // populate some fields
+    var name = new ContactName();
+    name.givenName = "Jane";
+    name.familyName = "Doe";
+    contact.name = name;
+    
+    // save to device
+    contact.save(onSuccess,onError);
+    
+
+### Esempio di clone
+
+        // clone the contact object
+        var clone = contact.clone();
+        clone.name.givenName = "John";
+        console.log("Original contact name = " + contact.name.givenName);
+        console.log("Cloned contact name = " + clone.name.givenName);
+    
+
+### Rimuovere esempio
+
+    function onSuccess() {
+        alert("Removal Success");
+    };
+    
+    function onError(contactError) {
+        alert("Error = " + contactError.code);
+    };
+    
+    // remove the contact from the device
+    contact.remove(onSuccess,onError);
+    
+
+### Stranezze di Android 2. x
+
+*   **categorie**: non è supportato sui dispositivi Android 2. x, restituendo`null`.
+
+### BlackBerry 10 capricci
+
+*   **ID**: assegnate dal dispositivo quando si salva il contatto.
+
+### Capricci di FirefoxOS
+
+*   **categorie**: parzialmente supportati. Campi **pref** e **tipo** stanno tornando`null`
+
+*   **IMS**: non supportato
+
+*   **foto**: non supportato
+
+### iOS stranezze
+
+*   **displayName**: non supportata su iOS, tornando `null` se non c'è nessun `ContactName` specificato, nel qual caso restituisce il nome composito, **soprannome** o `""` , rispettivamente.
+
+*   **compleanno**: deve essere inserito come un JavaScript `Date` oggetto, allo stesso modo viene restituito.
+
+*   **foto**: restituisce un URL del File dell'immagine, che viene memorizzato nella directory temporanea dell'applicazione. Contenuto della directory temporanea vengono rimossi quando l'applicazione termina.
+
+*   **categorie**: questa proprietà non è attualmente supportata, restituendo`null`.
+
+### Windows Phone 7 e 8 stranezze
+
+*   **displayName**: quando si crea un contatto, il valore specificato per il parametro del nome di visualizzazione è diverso dal nome visualizzato Estratto quando trovare il contatto.
+
+*   **URL**: quando si crea un contatto, gli utenti possono inserire e salvare più di un indirizzo web, ma solo uno è disponibile durante la ricerca del contatto.
+
+*   **phoneNumbers**: non è supportata l'opzione *pref* . Il *tipo* non è supportato in un'operazione di *trovare* . Un solo `phoneNumber` è consentita per ogni *tipo*.
+
+*   **email**: non è supportata l'opzione *pref* . Home e personal fa riferimento la stessa voce di posta elettronica. È consentito un solo ingresso per ogni *tipo*.
+
+*   **indirizzi**: supporta solo lavoro e casa/personali *tipo*. Il riferimento principale e personale *tipo* la stessa voce di indirizzo. È consentito un solo ingresso per ogni *tipo*.
+
+*   **organizzazioni**: solo uno è consentito e non supporta gli attributi *pref*, *tipo*e *dipartimento* .
+
+*   **Nota**: non supportato, restituendo`null`.
+
+*   **IMS**: non supportato, restituendo`null`.
+
+*   **compleanni**: non supportato, restituendo`null`.
+
+*   **categorie**: non supportato, restituendo`null`.
+
+## ContactAddress
+
+Il `ContactAddress` oggetto memorizza le proprietà di un singolo indirizzo di un contatto. A `Contact` oggetto può includere più di un indirizzo in un `ContactAddress[]` matrice.
+
+### Proprietà
+
+*   **pref**: impostare su `true` se questo `ContactAddress` contiene il valore dell'utente preferito. *(booleano)*
+
+*   **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. *(DOMString)*
+
+*   **formattato**: indirizzo completo formattato per la visualizzazione. *(DOMString)*
+
+*   **streetAddress**: l'indirizzo completo. *(DOMString)*
+
+*   **località**: la città o località. *(DOMString)*
+
+*   **regione**: lo stato o la regione. *(DOMString)*
+
+*   **postalCode**: il codice postale o il codice postale. *(DOMString)*
+
+*   **paese**: il nome del paese. *(DOMString)*
+
+### Piattaforme supportate
+
+*   Amazon fuoco OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+*   Windows 8
+
+### Esempio
+
+    // display the address information for all contacts
+    
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].addresses.length; j++) {
+                alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
+                    "Type: "           + contacts[i].addresses[j].type          + "\n" +
+                    "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
+                    "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+                    "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
+                    "Region: "         + contacts[i].addresses[j].region        + "\n" +
+                    "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
+                    "Country: "        + contacts[i].addresses[j].country);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    // find all contacts
+    var options = new ContactFindOptions();
+    options.filter = "";
+    var filter = ["displayName", "addresses"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Stranezze di Android 2. x
+
+*   **pref**: non supportato, tornando `false` su dispositivi Android 2. x.
+
+### BlackBerry 10 capricci
+
+*   **pref**: non è supportato sui dispositivi BlackBerry, restituendo`false`.
+
+*   **tipo**: parzialmente supportati. Solo uno di *lavoro* e *casa* tipo indirizzi può essere memorizzato per ciascun contatto.
+
+*   **formattato**: parzialmente supportati. Restituisce una concatenazione di tutti i campi Indirizzo BlackBerry.
+
+*   **streetAddress**: supportato. Restituisce una concatenazione di BlackBerry **Indirizzo1** e **Indirizzo2** campi indirizzo.
+
+*   **località**: supportato. Memorizzato nel campo indirizzo **città** di BlackBerry.
+
+*   **regione**: supportato. Memorizzato nel campo indirizzo di **stateProvince** BlackBerry.
+
+*   **postalCode**: supportato. Memorizzato nel campo dell'indirizzo **zipPostal** BlackBerry.
+
+*   **paese**: supportato.
+
+### Capricci di FirefoxOS
+
+*   **formattato**: attualmente non supportato
+
+### iOS stranezze
+
+*   **pref**: non è supportato sui dispositivi iOS, restituendo`false`.
+
+*   **formattato**: attualmente non supportati.
+
+### Stranezze di Windows 8
+
+*   **pref**: non supportato
+
+## ContactError
+
+Il `ContactError` oggetto viene restituito all'utente attraverso la `contactError` funzione di callback quando si verifica un errore.
+
+### Proprietà
+
+*   **codice**: uno dei codici di errore predefiniti elencati di seguito.
+
+### Costanti
+
+*   `ContactError.UNKNOWN_ERROR` (code 0)
+*   `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+*   `ContactError.TIMEOUT_ERROR` (code 2)
+*   `ContactError.PENDING_OPERATION_ERROR` (code 3)
+*   `ContactError.IO_ERROR` (code 4)
+*   `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+*   `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+Il `ContactField` oggetto è un componente riutilizzabile che rappresenta Contatta campi genericamente. Ogni `ContactField` oggetto contiene un `value` , `type` , e `pref` proprietà. A `Contact` oggetto memorizza diverse proprietà in `ContactField[]` matrici, come indirizzi di e-mail e numeri di telefono.
+
+Nella maggior parte dei casi, non esistono valori pre-determinati per un `ContactField` **tipo** attributo oggetto. Ad esempio, un numero di telefono può specificare valori di **tipo** di *casa*, *lavoro*, *mobile*, *iPhone*o qualsiasi altro valore che è supportato dal database dei contatti su una piattaforma particolare dispositivo. Tuttavia, per la `Contact` **foto** campo, il campo **tipo** indica il formato dell'immagine restituita: **url** quando il **valore** di attributo contiene un URL per l'immagine fotografica, o *base64* , quando il **valore** contiene una stringa con codifica base64 immagine.
+
+### Proprietà
+
+*   **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. *(DOMString)*
+
+*   **valore**: il valore del campo, ad esempio un telefono numero o indirizzo e-mail. *(DOMString)*
+
+*   **pref**: impostare su `true` se questo `ContactField` contiene il valore dell'utente preferito. *(booleano)*
+
+### Piattaforme supportate
+
+*   Amazon fuoco OS
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+*   Windows 8
+
+### Esempio
+
+        // create a new contact
+        var contact = navigator.contacts.create();
+    
+        // store contact phone numbers in ContactField[]
+        var phoneNumbers = [];
+        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+        contact.phoneNumbers = phoneNumbers;
+    
+        // save the contact
+        contact.save();
+    
+
+### Stranezze Android
+
+*   **pref**: non supportato, restituendo`false`.
+
+### BlackBerry 10 capricci
+
+*   **tipo**: parzialmente supportati. Usato per i numeri di telefono.
+
+*   **valore**: supportato.
+
+*   **pref**: non supportato, restituendo`false`.
+
+### iOS stranezze
+
+*   **pref**: non supportato, restituendo`false`.
+
+### Stranezze di Windows8
+
+*   **pref**: non supportato, restituendo`false`.
+
+## ContactName
+
+Contiene diversi tipi di informazioni circa un `Contact` nome dell'oggetto.
+
+### Proprietà
+
+*   **formattato**: il nome completo del contatto. *(DOMString)*
+
+*   **familyName**: cognome del contatto. *(DOMString)*
+
+*   **givenName**: nome del contatto. *(DOMString)*
+
+*   **middleName**: il nome del contatto medio. *(DOMString)*
+
+*   **honorificPrefix**: prefisso del contatto (esempio *Mr* o *Dr*) *(DOMString)*
+
+*   **honorificSuffix**: suffisso del contatto (esempio *Esq.*). *(DOMString)*
+
+### Piattaforme supportate
+
+*   Amazon fuoco OS
+*   Android 2. x
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+*   Windows 8
+
+### Esempio
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
+                "Family Name: "  + contacts[i].name.familyName      + "\n" +
+                "Given Name: "   + contacts[i].name.givenName       + "\n" +
+                "Middle Name: "  + contacts[i].name.middleName      + "\n" +
+                "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
+                "Prefix: "       + contacts[i].name.honorificSuffix);
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "name"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Stranezze Android
+
+*   **formattato**: parzialmente supportati e di sola lettura. Restituisce una concatenazione di `honorificPrefix` , `givenName` , `middleName` , `familyName` , e`honorificSuffix`.
+
+### BlackBerry 10 capricci
+
+*   **formattato**: parzialmente supportati. Restituisce una concatenazione di campi **firstName** e **lastName** BlackBerry.
+
+*   **familyName**: supportato. Archiviato in campo **lastName** BlackBerry.
+
+*   **givenName**: supportato. Archiviato in campo **firstName** BlackBerry.
+
+*   **middleName**: non supportato, restituendo`null`.
+
+*   **honorificPrefix**: non supportato, restituendo`null`.
+
+*   **honorificSuffix**: non supportato, restituendo`null`.
+
+### Capricci di FirefoxOS
+
+*   **formattato**: parzialmente supportati e di sola lettura. Restituisce una concatenazione di `honorificPrefix` , `givenName` , `middleName` , `familyName` , e`honorificSuffix`.
+
+### iOS stranezze
+
+*   **formattato**: parzialmente supportati. Restituisce il nome composito di iOS, ma è di sola lettura.
+
+### Stranezze di Windows 8
+
+*   **formattato**: questo è l'unico nome proprietà ed è identico a `displayName` , e`nickname`
+
+*   **familyName**: non supportato
+
+*   **givenName**: non supportato
+
+*   **middleName**: non supportato
+
+*   **honorificPrefix**: non supportato
+
+*   **honorificSuffix**: non supportato
+
+## ContactOrganization
+
+Il `ContactOrganization` oggetto memorizza la proprietà di organizzazione di un contatto. A `Contact` oggetto memorizza uno o più `ContactOrganization` gli oggetti in una matrice.
+
+### Proprietà
+
+*   **pref**: impostare su `true` se questo `ContactOrganization` contiene il valore dell'utente preferito. *(booleano)*
+
+*   **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. _(DOMString)
+
+*   **nome**: il nome dell'organizzazione. *(DOMString)*
+
+*   **dipartimento**: contratto lavora per il dipartimento. *(DOMString)*
+
+*   **titolo**: titolo del contatto presso l'organizzazione. *(DOMString)*
+
+### Piattaforme supportate
+
+*   Android
+*   BlackBerry 10
+*   Firefox OS
+*   iOS
+*   Windows Phone 7 e 8
+
+### Esempio
+
+    function onSuccess(contacts) {
+        for (var i = 0; i < contacts.length; i++) {
+            for (var j = 0; j < contacts[i].organizations.length; j++) {
+                alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
+                    "Type: "        + contacts[i].organizations[j].type       + "\n" +
+                    "Name: "        + contacts[i].organizations[j].name       + "\n" +
+                    "Department: "  + contacts[i].organizations[j].department + "\n" +
+                    "Title: "       + contacts[i].organizations[j].title);
+            }
+        }
+    };
+    
+    function onError(contactError) {
+        alert('onError!');
+    };
+    
+    var options = new ContactFindOptions();
+    options.filter = "";
+    filter = ["displayName", "organizations"];
+    navigator.contacts.find(filter, onSuccess, onError, options);
+    
+
+### Stranezze di Android 2. x
+
+*   **pref**: non supportato dai dispositivi Android 2. x, restituendo`false`.
+
+### BlackBerry 10 capricci
+
+*   **pref**: non supportato dai dispositivi BlackBerry, restituendo`false`.
+
+*   **tipo**: non supportato dai dispositivi BlackBerry, restituendo`null`.
+
+*   **nome**: parzialmente supportati. Il primo nome dell'organizzazione è memorizzato nel campo **azienda** BlackBerry.
+
+*   **dipartimento**: non supportato, restituendo`null`.
+
+*   **titolo**: parzialmente supportati. Il primo titolo di organizzazione è memorizzato nel campo **jobTitle** BlackBerry.
+
+### Firefox OS stranezze
+
+*   **pref**: non supportato
+
+*   **tipo**: non supportato
+
+*   **dipartimento**: non supportato
+
+*   Campi **nome** e **titolo** memorizzato in **org** e **jobTitle**.
+
+### iOS stranezze
+
+*   **pref**: non è supportato sui dispositivi iOS, restituendo`false`.
+
+*   **tipo**: non è supportato sui dispositivi iOS, restituendo`null`.
+
+*   **nome**: parzialmente supportati. Il primo nome dell'organizzazione è memorizzato nel campo **kABPersonOrganizationProperty** iOS.
+
+*   **dipartimento**: parzialmente supportati. Il primo nome del dipartimento è memorizzato nel campo **kABPersonDepartmentProperty** iOS.
+
+*   **titolo**: parzialmente supportati. Il primo titolo è memorizzato nel campo **kABPersonJobTitleProperty** iOS.
\ No newline at end of file


Mime
View raw message