You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ld...@apache.org on 2014/07/07 19:49:58 UTC
[01/13] git commit: Lisa testing pulling in plugins for plugin:
cordova-plugin-contacts
Repository: cordova-plugin-contacts
Updated Branches:
refs/heads/master 903aba035 -> e02ede18d
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/0aa9d83f
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/0aa9d83f
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/0aa9d83f
Branch: refs/heads/master
Commit: 0aa9d83f71955e9f947707aeaee77e402ddaeb5d
Parents: 71d66ef
Author: ldeluca <ld...@us.ibm.com>
Authored: Wed Feb 26 09:35:38 2014 -0500
Committer: ldeluca <ld...@us.ibm.com>
Committed: Wed Feb 26 09:35:38 2014 -0500
----------------------------------------------------------------------
doc/es/index.md | 633 +++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 633 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/0aa9d83f/doc/es/index.md
----------------------------------------------------------------------
diff --git a/doc/es/index.md b/doc/es/index.md
new file mode 100644
index 0000000..94432d6
--- /dev/null
+++ b/doc/es/index.md
@@ -0,0 +1,633 @@
+<!---
+ 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
+
+Proporciona acceso a la base de datos de contactos de dispositivo.
+
+**ADVERTENCIA**: recopilación y uso de datos plantea cuestiones de privacidad importante. Política de privacidad de su aplicación debe discutir cómo la aplicación utiliza datos de contacto y si es compartida con terceros. Información de contacto se considera sensible porque revela la gente con quien se comunica una persona. Por lo tanto, además de política de privacidad de la app, fuertemente considere dar un aviso de just-in-time antes de la aplicación accede a ellos o utiliza los datos de contacto, si el sistema operativo del dispositivo no hacerlo ya. Que el aviso debe proporcionar la misma información mencionada, además de obtener un permiso del usuario (por ejemplo, presentando opciones para **Aceptar** y **No gracias**). Tenga en cuenta que algunos mercados de aplicación podrán exigir la aplicación para proporcionar un aviso de just-in-time y obtener el permiso del usuario antes de acceder a datos de contacto. Una experiencia de usuario clara y fácil de entender
que rodean el uso de contacto datos ayuda a evitar la confusión del usuario y percibe uso indebido de los datos de contacto. Para obtener más información, por favor consulte a la guía de privacidad.
+
+## Instalación
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+### Firefox OS rarezas
+
+Crear **www/manifest.webapp** como se describe en [Manifestar Docs][1]. Agregar permisos pertinentes. También hay una necesidad de cambiar el tipo de aplicación a "privilegiados" - [Docs manifiestan][2]. **ADVERTENCIA**: todas las apps privilegiadas aplicar [Política de seguridad de contenidos][3] que prohíbe en línea de comandos. Inicializar la aplicación de otra manera.
+
+ [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"
+ }
+ }
+
+
+## Navigator.Contacts
+
+### Métodos
+
+* navigator.contacts.create
+* navigator.contacts.find
+
+### Objetos
+
+* Contact
+* ContactName
+* ContactField
+* ContactAddress
+* ContactOrganization
+* ContactFindOptions
+* ContactError
+
+## Navigator.contacts.Create
+
+El `navigator.contacts.create` método es sincrónico y devuelve una nueva `Contact` objeto.
+
+Este método no retiene el objeto de contacto en la base de contactos de dispositivo, para lo cual necesita invocar el `Contact.save` método.
+
+### Plataformas soportadas
+
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 y 8
+
+### Ejemplo
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## navigator.contacts.find
+
+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.
+
+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.
+
+### 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]
+
+* **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`)
+
+### Plataformas soportadas
+
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 y 8
+* Windows 8
+
+### Ejemplo
+
+ function onSuccess(contacts) {
+ alert('Found ' + navigator.contacts.length + ' navigator.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;
+ var fields = ["displayName", "name"];
+ navigator.contacts.find(fields, onSuccess, onError, options);
+
+
+## Contacto
+
+El `Contact` objeto representa el contacto de un usuario. Contactos pueden ser creados, almacenados o eliminados de la base de datos de contactos de dispositivo. Contactos pueden también ser obtenidos (individualmente o a granel) de la base de datos invocando el `navigator.contacts.find` método.
+
+**Nota**: no todos los campos de contacto mencionados son compatibles con la plataforma de cada dispositivo. Consulte sección *peculiaridades* de cada plataforma para más detalles.
+
+### Propiedades
+
+* **ID**: un identificador único global. *(DOMString)*
+
+* **displayName**: el nombre de este contacto, conveniente para la exhibición a los usuarios finales. *(DOMString)*
+
+* **nombre**: un objeto que contiene todos los componentes de un nombre de las personas. *(ContactName)*
+
+* **apodo**: un nombre para abordar el contacto casual. *(DOMString)*
+
+* **números**: una matriz de números de teléfono de contacto. *(ContactField[])*
+
+* **correos electrónicos**: un conjunto de direcciones de correo electrónico del contacto. *(ContactField[])*
+
+* **direcciones**: un conjunto de direcciones de todos los contactos. *(ContactAddress[])*
+
+* **IMS**: un conjunto de direcciones de todos los contactos IM. *(ContactField[])*
+
+* **organizaciones**: un conjunto de organizaciones de todos los contactos. *(ContactOrganization[])*
+
+* **cumpleaños**: el cumpleaños del contacto. *(Fecha)*
+
+* **Nota**: una nota sobre el contacto. *(DOMString)*
+
+* **fotos**: una serie de fotos de los contactos. *(ContactField[])*
+
+* **categorías**: una matriz de todas las categorías definidas por el usuario asociado con el contacto. *(ContactField[])*
+
+* **URL**: un conjunto de páginas web asociadas con el contacto. *(ContactField[])*
+
+### Métodos
+
+* **clon**: devuelve un nuevo `Contact` objeto que es una copia en profundidad del objeto de llamadas con el `id` propiedad establecida en`null`.
+
+* **eliminar**: elimina el contacto de la base de datos de contactos de dispositivo, si no se ejecuta un callback de error con un `ContactError` objeto.
+
+* **Guardar**: guarda un nuevo contacto en la base de datos de contactos de dispositivo o actualiza un contacto existente si ya existe un contacto con el mismo **id** .
+
+### Plataformas soportadas
+
+* Amazon fuego OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 y 8
+* Windows 8
+
+### Salvar ejemplo
+
+ 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);
+
+
+### Ejemplo de clon
+
+ // 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);
+
+
+### Quitar ejemplo
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### Rarezas Android 2.X
+
+* **categorías**: no compatible con dispositivos Android 2.X, regresando`null`.
+
+### 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.
+
+### FirefoxOS rarezas
+
+* **categorías**: parcialmente soportado. Campos **pref** y **tipo** regresan`null`
+
+* **IMS**: no se admite
+
+* **fotos**: no se admite
+
+### iOS rarezas
+
+* **displayName**: no compatible con iOS, regresando `null` si no hay ningún `ContactName` especifica, en cuyo caso devuelve el nombre del compuesto, **apodo** o `""` , respectivamente.
+
+* **cumpleaños**: debe ser de entrada como un JavaScript `Date` objeto, del mismo modo que se la devuelvan.
+
+* **fotos**: devuelve una dirección URL del archivo de la imagen, que se almacena en el directorio temporal de la aplicación. Contenidos del directorio temporal se eliminan cuando salga de la aplicación.
+
+* **categorías**: esta propiedad actualmente no es compatible, regresando`null`.
+
+### Windows Phone 7 y 8 rarezas
+
+* **displayName**: cuando se crea un contacto, previsto para el parámetro de nombre pantalla difiere el nombre para mostrar el valor obtenido al encontrar el contacto.
+
+* **URL**: cuando se crea un contacto, los usuarios pueden ingresar y salvar más de una dirección web, pero sólo está disponible cuando busque el contacto.
+
+* **números**: no se admite la opción *pref* . El *tipo* no se admite en una operación de *encontrar* . Solamente un `phoneNumber` está permitido para cada *tipo*.
+
+* **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*.
+
+* **organizaciones**: sólo está permitido y no es compatible con los atributos *pref*, *tipo*y *Departamento* .
+
+* **Nota**: no compatible, volviendo`null`.
+
+* **IMS**: no admite, volviendo`null`.
+
+* **cumpleaños**: no admite, volviendo`null`.
+
+* **categorías**: no admite, volviendo`null`.
+
+## ContactAddress
+
+El `ContactAddress` objeto almacena las propiedades de una única dirección de un contacto. A `Contact` objeto puede incluir más de una dirección en un `ContactAddress[]` matriz.
+
+### Propiedades
+
+* **Pref**: A `true` si este `ContactAddress` contiene el valor del usuario preferido. *(booleano)*
+
+* **tipo**: una cadena que indica qué tipo de campo es, *casa* por ejemplo. *(DOMString)*
+
+* **formato**: la dirección completa con formato de pantalla. *(DOMString)*
+
+* **streetAddress**: la dirección completa. *(DOMString)*
+
+* **localidad**: la ciudad o localidad. *(DOMString)*
+
+* **región**: el estado o la región. *(DOMString)*
+
+* **Código postal**: el código postal o código postal. *(DOMString)*
+
+* **país**: el nombre del país. *(DOMString)*
+
+### Plataformas soportadas
+
+* Amazon fuego OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 y 8
+* Windows 8
+
+### Ejemplo
+
+ // display the address information for all contacts
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < navigator.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);
+
+
+### Rarezas Android 2.X
+
+* **Pref**: no admite, volviendo `false` en dispositivos Android 2.X.
+
+### BlackBerry 10 rarezas
+
+* **Pref**: no compatible con dispositivos BlackBerry, volviendo`false`.
+
+* **tipo**: parcialmente financiado. Sólo uno de *trabajo* y *casa* tipo direcciones puede almacenarse por contacto.
+
+* **formato**: parcialmente financiado. 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.
+
+* **localidad**: apoyado. Almacenado en el campo de dirección de la **ciudad** de BlackBerry.
+
+* **región**: apoyado. Almacenado en el campo de dirección de BlackBerry **stateProvince** .
+
+* **Código postal**: apoyado. Almacenado en el campo de dirección de BlackBerry **zipPostal** .
+
+* **país**: apoyo.
+
+### Rarezas FirefoxOS
+
+* **formato**: actualmente no se admite
+
+### iOS rarezas
+
+* **Pref**: no se admite en dispositivos iOS, regresando`false`.
+
+* **formato**: actualmente 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.
+
+### 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`
+
+## 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.
+
+### Propiedades
+
+* **tipo**: una cadena que indica qué tipo de campo es, *casa* por ejemplo. *(DOMString)*
+
+* **valor**: el valor del campo, como un teléfono número o dirección de email. *(DOMString)*
+
+* **Pref**: A `true` si este `ContactField` contiene el valor del usuario preferido. *(booleano)*
+
+### Plataformas soportadas
+
+* Amazon fuego OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 y 8
+* Windows 8
+
+### Ejemplo
+
+ // 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();
+
+
+### Rarezas Android
+
+* **Pref**: no soportado, regresando`false`.
+
+### BlackBerry 10 rarezas
+
+* **tipo**: parcialmente soportado. Utilizado para los números de teléfono.
+
+* **valor**: apoyado.
+
+* **Pref**: no soportado, regresando`false`.
+
+### iOS rarezas
+
+* **Pref**: no soportado, regresando`false`.
+
+## ContactName
+
+Contiene diferentes tipos de información sobre un `Contact` nombre del objeto.
+
+### Propiedades
+
+* **formato**: el nombre completo del contacto. *(DOMString)*
+
+* **familia**: el nombre del contacto familiar. *(DOMString)*
+
+* **givenName**: nombre del contacto. *(DOMString)*
+
+* **middleName**: el nombre del contacto media. *(DOMString)*
+
+* **honorificPrefix**: prefijo del contacto (ejemplo *señor* o *doctor*) *(DOMString)*
+
+* **honorificSuffix**: sufijo de contacto (ejemplo *Esq.*). *(DOMString)*
+
+### Plataformas soportadas
+
+* Amazon fuego OS
+* Android 2.X
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 y 8
+* Windows 8
+
+### Ejemplo
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < navigator.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);
+
+
+### Rarezas Android
+
+* **formato**: parcialmente compatibles y de sólo lectura. Devuelve una cadena de `honorificPrefix` , `givenName` , `middleName` , `familyName` , y`honorificSuffix`.
+
+### BlackBerry 10 rarezas
+
+* **formato**: parcialmente soportado. Devuelve una concatenación de campos **firstName** y **lastName** de BlackBerry.
+
+* **familia**: apoyo. Almacenada en el campo **lastName** BlackBerry.
+
+* **givenName**: apoyado. Almacenados en campo **firstName** BlackBerry.
+
+* **middleName**: no soportado, regresando`null`.
+
+* **honorificPrefix**: no soportado, regresando`null`.
+
+* **honorificSuffix**: no soportado, regresando`null`.
+
+### FirefoxOS rarezas
+
+* **formato**: parcialmente compatibles y de sólo lectura. Devuelve una concatenación de `honorificPrefix` , `givenName` , `middleName` , `familyName` , y`honorificSuffix`.
+
+### iOS rarezas
+
+* **formato**: parcialmente soportado. Devuelve iOS nombre compuesto, pero es de sólo lectura.
+
+## 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.
+
+### Propiedades
+
+* **Pref**: A `true` si este `ContactOrganization` contiene el valor del usuario preferido. *(booleano)*
+
+* **tipo**: una cadena que indica qué tipo de campo es, *casa* por ejemplo. _(DOMString)
+
+* **nombre**: el nombre de la organización. *(DOMString)*
+
+* **Departamento**: el contrato de obras para el departamento. *(DOMString)*
+
+* **título**: título del contacto de la organización. *(DOMString)*
+
+### Plataformas soportadas
+
+* Android
+* BlackBerry 10
+* 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 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);
+
+
+### Rarezas Android 2.X
+
+* **Pref**: no compatible con dispositivos Android 2.X, regresando`false`.
+
+### BlackBerry 10 rarezas
+
+* **Pref**: no compatible con dispositivos BlackBerry, regresando`false`.
+
+* **tipo**: no compatible con dispositivos BlackBerry, regresando`null`.
+
+* **nombre**: parcialmente soportado. El primer nombre de la organización se almacena en el campo de la **empresa** BlackBerry.
+
+* **Departamento**: no soportado, regresando`null`.
+
+* **título**: parcialmente soportado. El primer título de la organización se almacena en el campo de **jobTitle** BlackBerry.
+
+### Firefox OS rarezas
+
+* **Pref**: no se admite
+
+* **tipo**: no se admite
+
+* **Departamento**: no se admite
+
+* Los campos **nombre** y **título** almacenado en **org** y **jobTitle**.
+
+### iOS rarezas
+
+* **Pref**: no se admite en dispositivos iOS, regresando`false`.
+
+* **tipo**: no se admite en dispositivos iOS, regresando`null`.
+
+* **nombre**: parcialmente soportado. El primer nombre de la organización se almacena en el campo de **kABPersonOrganizationProperty** de iOS.
+
+* **Departamento**: parcialmente soportado. El primer nombre de departamento se almacena en el campo de **kABPersonDepartmentProperty** de iOS.
+
+* **título**: parcialmente soportado. El primer título se almacena en el campo de **kABPersonJobTitleProperty** de iOS.
\ No newline at end of file
[03/13] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/cef72e37
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/cef72e37
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/cef72e37
Branch: refs/heads/master
Commit: cef72e37e168977aafb77b074d68652d71d2b06c
Parents: ec47823 431eeea
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue Mar 4 12:42:28 2014 -0500
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue Mar 4 12:42:28 2014 -0500
----------------------------------------------------------------------
NOTICE | 5 +++++
RELEASENOTES.md | 4 ++++
plugin.xml | 4 ++--
src/android/ContactAccessorSdk5.java | 4 ++--
4 files changed, 13 insertions(+), 4 deletions(-)
----------------------------------------------------------------------
[12/13] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/acfe5475
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/acfe5475
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/acfe5475
Branch: refs/heads/master
Commit: acfe5475f9fddeb8f0313b166c9c73e277c3497f
Parents: 0b69b50 c3d8987
Author: ldeluca <ld...@us.ibm.com>
Authored: Wed Jun 11 09:55:50 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Wed Jun 11 09:55:50 2014 -0400
----------------------------------------------------------------------
CONTRIBUTING.md | 21 ++++++++++
RELEASENOTES.md | 13 ++++++
plugin.xml | 2 +-
src/ios/CDVContacts.m | 102 +++++++++++----------------------------------
4 files changed, 60 insertions(+), 78 deletions(-)
----------------------------------------------------------------------
[07/13] git commit: Lisa testing pulling in plugins for plugin:
cordova-plugin-contacts
Posted by ld...@apache.org.
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/6da59ee8
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/6da59ee8
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/6da59ee8
Branch: refs/heads/master
Commit: 6da59ee808933f45f30505dff5ff4fe59829f5dd
Parents: 25f2d92
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue May 27 17:49:14 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue May 27 17:49:14 2014 -0400
----------------------------------------------------------------------
doc/ja/index.md | 634 +++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 634 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/6da59ee8/doc/ja/index.md
----------------------------------------------------------------------
diff --git a/doc/ja/index.md b/doc/ja/index.md
new file mode 100644
index 0000000..9d7fea8
--- /dev/null
+++ b/doc/ja/index.md
@@ -0,0 +1,634 @@
+<!---
+ 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
+
+Provides access to the device contacts database.
+
+**警告**: 連絡先データの収集と利用を重要なプライバシーの問題を発生させます。 アプリのプライバシー ポリシー アプリが連絡先データを使用する方法と、他の当事者では共有されているかどうかを話し合う必要があります。 人誰と通信する人々 を明らかにするために、連絡先情報が機密と見なされます。 したがって、アプリのプライバシー ポリシーに加えて、強くする必要がありますデバイスのオペレーティング システムが既にしない場合アプリにアクセスまたは連絡先のデータを使用する前に - 時間のお知らせを提供します。 その通知は、上記の (例えば、 **[ok]**を**おかげで**選択肢を提示する) によってユーザーのアクセス許可を取得するだけでなく、同じ情報を提供する必要があります。 いくつかのアプリのマーケットプ レ
ース - 時間の通知を提供して、連絡先データにアクセスする前にユーザーの許可を取得するアプリをする必要がありますに注意してください。 連絡先データは、ユーザーの混乱を避けるのに役立ちますの使用および連絡先データの知覚の誤用を囲む明確でわかりやすいユーザー エクスペリエンス。 詳細については、プライバシーに関するガイドを参照してください。
+
+## インストール
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+### Firefox OS Quirks
+
+Create **www/manifest.webapp** as described in [Manifest Docs][1]. Add relevant permisions. There is also a need to change the webapp type to "privileged" - [Manifest Docs][2]. **WARNING**: All privileged apps enforce [Content Security Policy][3] which forbids inline script. Initialize your application in another way.
+
+ [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"
+ }
+ }
+
+
+## navigator.contacts
+
+### メソッド
+
+* navigator.contacts.create
+* navigator.contacts.find
+
+### オブジェクト
+
+* お問い合わせ
+* 得意先コード
+* ContactField
+* ContactAddress
+* ContactOrganization
+* ContactFindOptions
+* ContactError
+
+## navigator.contacts.create
+
+The `navigator.contacts.create` method is synchronous, and returns a new `Contact` object.
+
+このメソッドを呼び出す必要があるデバイスの連絡先データベースに連絡先オブジェクトを保持しない、 `Contact.save` メソッド。
+
+### サポートされているプラットフォーム
+
+* アンドロイド
+* ブラックベリー 10
+* Firefox OS
+* iOS
+* Windows Phone 7 と 8
+* Windows 8 ( Note: Windows 8 Contacts are readonly via the Cordova API Contacts are not queryable/searchable, you should inform the user to pick a contact as a call to contacts.find will open the 'People' app where the user must choose a contact. 戻される連絡先は読み取り専用、アプリケーションを変更することはできません。 )
+
+### 例
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## navigator.contacts.find
+
+The `navigator.contacts.find` method executes asynchronously, querying the device contacts database and returning an array of `Contact` objects. 結果として得られるオブジェクトに渡される、 `contactSuccess` 、 **contactSuccess**パラメーターで指定されたコールバック関数。
+
+**連絡先**パラメーター検索の修飾子として使用するフィールドを指定してだけこれらの結果は**contactSuccess**コールバック関数に渡されます。 **連絡先**のゼロ長さのパラメーターが無効である結果 `ContactError.INVALID_ARGUMENT_ERROR` 。 **連絡先**値 `"*"` すべての連絡先フィールドを返します。
+
+**ContactFindOptions.filter**文字列の連絡先データベースを照会するときに検索フィルターとして使用できます。 指定した場合、大文字と小文字、部分的な値の一致する**連絡先**パラメーターで指定されたフィールドごとに適用されます。 一致する*任意*指定のフィールドがある場合は、連絡先が返されます。
+
+### パラメーター
+
+* **連絡先**: 連絡先検索修飾子として使用するフィールド。結果として `Contact` オブジェクトのみ機能のこれらのフィールドの値。*(DOMString[])*[必須]
+
+* **contactSuccess**: Success callback function invoked with the array of Contact objects returned from the database. [Required]
+
+* **contactError**: エラー コールバック関数は、エラーが発生したときに呼び出されます。[オプション]
+
+* **contactFindOptions**: Search options to filter navigator.contacts. [Optional] Keys include:
+
+* **フィルター**: navigator.contacts の検索に使用する検索文字列。*（，）*(既定値します。`""`)
+
+* **multiple**: Determines if the find operation returns multiple navigator.contacts. *(Boolean)* (Default: `false`)
+
+### サポートされているプラットフォーム
+
+* アンドロイド
+* ブラックベリー 10
+* Firefox OS
+* iOS
+* Windows Phone 7 と 8
+* Windows 8 ( read-only support, search requires user interaction, contactFields are ignored, only contactFindOptions.multiple is used to enable the user to select 1 or many contacts. )
+
+### 例
+
+ 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;
+ var fields = ["displayName", "name"];
+ navigator.contacts.find(fields, onSuccess, onError, options);
+
+
+## お問い合わせ
+
+`Contact`オブジェクトは、ユーザーの連絡先を表します。 連絡先の作成、格納、またはデバイスの連絡先データベースから削除することができます。 Contacts can also be retrieved (individually or in bulk) from the database by invoking the `navigator.contacts.find` method.
+
+**注**: すべて上記の連絡先フィールドのすべてのデバイス プラットフォームでサポートされます。詳細については各プラットフォームの*互換*セクションを確認してください。
+
+### プロパティ
+
+* **id**： グローバルに一意の識別子。*（，）*
+
+* **displayName**: エンド ・ ユーザーへの表示に適した、この連絡先の名前。*（，）*
+
+* **名前**： 人の名前のすべてのコンポーネントを格納するオブジェクト。*(ContactName)*
+
+* **ニックネーム**: 連絡先のアドレスに使用するカジュアルな名前。*（，）*
+
+* **電話番号**: 連絡先の電話番号の配列。*(ContactField[])*
+
+* **メール**： 連絡先の電子メール アドレスの配列。*(ContactField[])*
+
+* **アドレス**: 連絡先のアドレスの配列。*(ContactAddress[])*
+
+* **ims**： 連絡先の IM アドレスの配列。*(ContactField[])*
+
+* **組織**: 連絡先の組織の配列。*(ContactOrganization[])*
+
+* **誕生日**: 連絡先の誕生日。*（日）*
+
+* **注**: 連絡先についてのメモ。*（，）*
+
+* **写真**: 連絡先の写真の配列。*(ContactField[])*
+
+* **カテゴリ**: 取引先担当者に関連付けられているすべてのユーザー定義カテゴリの配列。*(ContactField[])*
+
+* **url**: 取引先担当者に関連付けられている web ページの配列。*(ContactField[])*
+
+### メソッド
+
+* **クローン**： 新しいを返します `Contact` と呼び出し元のオブジェクトのディープ コピーであるオブジェクトの `id` プロパティに設定`null`.
+
+* **削除**: デバイスの連絡先データベースから連絡先を削除します、それ以外の場合のためのエラー コールバックを実行する、 `ContactError` オブジェクト。
+
+* **保存**: デバイスの連絡先データベースに新しい連絡先を保存または同じ**id**を持つ連絡先が既に存在する場合、既存の連絡先を更新します。
+
+### サポートされているプラットフォーム
+
+* アマゾン火 OS
+* アンドロイド
+* ブラックベリー 10
+* Firefox OS
+* iOS
+* Windows Phone 7 と 8
+
+### Save Example
+
+ 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);
+
+
+### Clone Example
+
+ // 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);
+
+
+### Remove Example
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### アンドロイド 2.X 癖
+
+* **カテゴリ**: 返す 2.X の Android デバイスでサポートされていません`null`.
+
+### ブラックベリー 10 癖
+
+* **id**: Assigned by the device when saving the contact.
+
+### FirefoxOS Quirks
+
+* **categories**: Partially supported. Fields **pref** and **type** are returning `null`
+
+* **ims**: Not supported
+
+* **photos**: Not supported
+
+### iOS の癖
+
+* **displayName**: 返す iOS でサポートされていない `null` がない限り、ない `ContactName` 指定すると、その場合は複合名、**ニックネーム**を返しますまたは `""` 、それぞれ。
+
+* **誕生日**: JavaScript として入力する必要があります `Date` オブジェクト、同じ方法が返されます。
+
+* **写真**： アプリケーションの一時ディレクトリに格納されているイメージへのファイルの URL を返します。一時ディレクトリの内容は、アプリケーションの終了時に削除されます。
+
+* **カテゴリ**: このプロパティは現在サポートされていません、返す`null`.
+
+### Windows Phone 7 と 8 癖
+
+* **displayName**: 表示名パラメーターの表示名と異なるために提供値を取得、連絡先を検索するとき、連絡先を作成するとき。
+
+* **url**: 連絡先を検索するときに 1 つだけが利用できるが、ユーザーによる入力し 1 つ以上の web アドレスを保存する連絡先を作成するとき。
+
+* **電話番号**:*県*オプションはサポートされていません。 *型*は、*検索*操作ではサポートされていません。 1 つだけ `phoneNumber` は各*タイプ*の許可.
+
+* **メール**：*県*オプションはサポートされていません。家庭や個人的なメールと同じエントリを参照します。各*タイプ*の 1 つだけのエントリが許可されて.
+
+* **アドレス**: 仕事とホーム/パーソナル*タイプ*のみをサポートしています。家庭や個人*型*参照して同じアドレス エントリ。各*タイプ*の 1 つだけのエントリが許可されて.
+
+* **組織**： 1 つだけが許可され、*県*、*タイプ*、および*部門*の属性をサポートしていません。
+
+* **注**: サポートされていないを返す`null`.
+
+* **ims**: サポートされていないを返す`null`.
+
+* **誕生日**: サポートされていないを返す`null`.
+
+* **カテゴリ**: サポートされていないを返す`null`.
+
+## ContactAddress
+
+`ContactAddress`オブジェクトの連絡先の 1 つのアドレスのプロパティが格納されます。 A `Contact` オブジェクトで 1 つ以上のアドレスを含めることができます、 `ContactAddress[]` 配列。
+
+### プロパティ
+
+* **県**: に設定されている `true` 場合は、この `ContactAddress` ユーザーの推奨値が含まれています。*(ブール値)*
+
+* **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。*（，）*
+
+* **書式設定**: 表示用にフォーマットの完全なアドレス。*（，）*
+
+* **番地**： 完全な住所。*（，）*
+
+* **局所性**: 都市または場所。*（，）*
+
+* **地域**: 状態または地域。*（，）*
+
+* **郵便番号**： 郵便番号または郵便番号。*（，）*
+
+* **国**: 国の名前。*（，）*
+
+### サポートされているプラットフォーム
+
+* アマゾン火 OS
+* アンドロイド
+* ブラックベリー 10
+* Firefox OS
+* iOS
+* Windows Phone 7 と 8
+* Windows 8
+
+### 例
+
+ // 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);
+
+
+### アンドロイド 2.X 癖
+
+* **県**: サポートされていない返す `false` 2.X の Android デバイスで。
+
+### ブラックベリー 10 癖
+
+* **県**： 戻る、BlackBerry デバイスでサポートされていません`false`.
+
+* **種類**: 部分的にサポートされます。連絡先ごとの 1 つだけ各*仕事*と*家庭*の種類のアドレスを格納できます。
+
+* **フォーマット**： 部分的にサポートされます。すべての BlackBerry アドレス フィールドの連結を返します。
+
+* **番地**： サポートされています。ブラックベリーの**住所 1** **住所 2**の連結アドレス フィールドを返します。
+
+* **局所性**： サポートされています。ブラックベリー**市**アドレス フィールドに格納されます。
+
+* **地域**: サポートされています。ブラックベリー **stateProvince**アドレス フィールドに格納されます。
+
+* **郵便番号**： サポートされています。ブラックベリー **zipPostal**アドレス フィールドに格納されます。
+
+* **国**: サポートされています。
+
+### FirefoxOS Quirks
+
+* **formatted**: Currently not supported
+
+### iOS の癖
+
+* **県**: 戻る iOS デバイスでサポートされていません`false`.
+
+* **フォーマット**: 現在サポートされていません。
+
+### Windows 8 Quirks
+
+* **pref**: Not supported
+
+## ContactError
+
+`ContactError`オブジェクトを介してユーザーに返されます、 `contactError` コールバック関数でエラーが発生したとき。
+
+### プロパティ
+
+* **コード**: 次のいずれかの定義済みのエラー コード。
+
+### 定数
+
+* `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
+
+`ContactField`オブジェクトは連絡先フィールドを総称を表す再利用可能なコンポーネントです。 各 `ContactField` オブジェクトが含まれています、 `value` 、 `type` 、および `pref` プロパティ。 A `Contact` オブジェクトのいくつかのプロパティに格納されます `ContactField[]` 携帯電話番号、メール アドレスなどの配列。
+
+ほとんどの場合、事前に決められた値がない、 `ContactField` オブジェクトの**type**属性。 たとえば、電話番号が*ホーム*、*仕事*、*モバイル*、 *iPhone*、または特定のデバイス プラットフォームの連絡先データベースでサポートされている他の値の**型**の値を指定できます。 ただし、ため、 `Contact` **写真**] フィールドに、**種類**フィールド、返されるイメージの形式を示します: **url** **値**属性**値**を base64 でエンコードされたイメージの文字列が含まれる場合に写真イメージまたは*base64*に URL が含まれる場合。
+
+### プロパティ
+
+* **type**: A string that indicates what type of field this is, *home* for example. *(DOMString)*
+
+* **value**: The value of the field, such as a phone number or email address. *(DOMString)*
+
+* **pref**: Set to `true` if this `ContactField` contains the user's preferred value. *(boolean)*
+
+### サポートされているプラットフォーム
+
+* アマゾン火 OS
+* アンドロイド
+* ブラックベリー 10
+* Firefox OS
+* iOS
+* Windows Phone 7 と 8
+* Windows 8
+
+### 例
+
+ // 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();
+
+
+### Android の癖
+
+* **pref**: Not supported, returning `false`.
+
+### ブラックベリー 10 癖
+
+* **type**: Partially supported. Used for phone numbers.
+
+* **value**: Supported.
+
+* **pref**: Not supported, returning `false`.
+
+### iOS の癖
+
+* **pref**: Not supported, returning `false`.
+
+### Windows8 Quirks
+
+* **pref**: Not supported, returning `false`.
+
+## 得意先コード
+
+についての異なる種類情報にはが含まれています、 `Contact` オブジェクトの名前。
+
+### プロパティ
+
+* **formatted**: The complete name of the contact. *(DOMString)*
+
+* **familyName**: The contact's family name. *(DOMString)*
+
+* **givenName**: 連絡先の名前。*（，）*
+
+* **ミドル ネーム**: 連絡先のミドル ネーム。*（，）*
+
+* **honorificPrefix**: 連絡先のプレフィックス (例*氏*または*博士*) *(，)*
+
+* **honorificSuffix**: 連絡先のサフィックス (*弁護士*の例)。*（，）*
+
+### サポートされているプラットフォーム
+
+* アマゾン火 OS
+* アンドロイド 2.X
+* ブラックベリー 10
+* Firefox の OS
+* iOS
+* Windows Phone 7 と 8
+* Windows 8
+
+### 例
+
+ 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);
+
+
+### Android の癖
+
+* **フォーマット**： 部分的にサポートされると読み取り専用です。 連結を返します `honorificPrefix` 、 `givenName` 、 `middleName` 、 `familyName` と`honorificSuffix`.
+
+### ブラックベリー 10 癖
+
+* **フォーマット**： 部分的にサポートされます。ブラックベリー **firstName**と**lastName**フィールドの連結を返します。
+
+* **familyName**: サポートされています。ブラックベリー **[氏名]**フィールドに格納されます。
+
+* **givenName**: サポートされています。ブラックベリーの**firstName**フィールドに格納されます。
+
+* **ミドル ネーム**: サポートされていないを返す`null`.
+
+* **honorificPrefix**: サポートされていないを返す`null`.
+
+* **honorificSuffix**: サポートされていないを返す`null`.
+
+### FirefoxOS の癖
+
+* **フォーマット**： 部分的にサポートされており、読み取り専用です。 連結を返します `honorificPrefix` 、 `givenName` 、 `middleName` 、 `familyName` と`honorificSuffix`.
+
+### iOS の癖
+
+* **フォーマット**： 部分的にサポートされます。IOS 複合名を返しますが、読み取り専用です。
+
+### Windows 8 の癖
+
+* **フォーマット**： これは、プロパティの名前し、同じです `displayName` と`nickname`
+
+* **familyName**: サポートされていません。
+
+* **givenName**: サポートされていません。
+
+* **ミドル ネーム**: サポートされていません。
+
+* **honorificPrefix**: サポートされていません。
+
+* **honorificSuffix**: サポートされていません。
+
+## ContactOrganization
+
+`ContactOrganization`オブジェクトは、連絡先の組織のプロパティを格納します。A `Contact` 1 つまたは複数のオブジェクトに格納されます `ContactOrganization` 配列内のオブジェクト。
+
+### プロパティ
+
+* **県**: に設定されている `true` 場合は、この `ContactOrganization` ユーザーの推奨値が含まれています。*(ブール値)*
+
+* **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。_(DOMString)
+
+* **名前**: 組織の名前。*（，）*
+
+* **部門**: 契約に勤めている部門。*（，）*
+
+* **タイトル**: 組織の連絡先のタイトル。*（，）*
+
+### サポートされているプラットフォーム
+
+* アンドロイド
+* ブラックベリー 10
+* Firefox の OS
+* iOS
+* Windows Phone 7 と 8
+
+### 例
+
+ 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);
+
+
+### アンドロイド 2.X 癖
+
+* **県**: 返す 2.X の Android デバイスでサポートされていません`false`.
+
+### ブラックベリー 10 癖
+
+* **県**： 戻る、BlackBerry デバイスでサポートされていません`false`.
+
+* **タイプ**： 戻る、BlackBerry デバイスでサポートされていません`null`.
+
+* **名前**： 部分的にサポートされます。最初の組織名は、**会社**のブラックベリーのフィールドに格納されます。
+
+* **部門**: サポートされていないを返す`null`.
+
+* **タイトル**: 部分的にサポートされます。組織の最初のタイトルはブラックベリー**氏名**フィールドに格納されます。
+
+### Firefox OS 癖
+
+* **県**: サポートされていません。
+
+* **タイプ**: サポートされていません。
+
+* **部門**: サポートされていません。
+
+* フィールドの**名前**と**組織**、**氏名**に格納された**タイトル**.
+
+### iOS の癖
+
+* **県**: 戻る iOS デバイスでサポートされていません`false`.
+
+* **タイプ**： 戻る iOS デバイスでサポートされていません`null`.
+
+* **名前**： 部分的にサポートされます。最初の組織名は、iOS **kABPersonOrganizationProperty**フィールドに格納されます。
+
+* **部門**: 部分的にサポートされます。最初の部署名は iOS **kABPersonDepartmentProperty**フィールドに格納されます。
+
+* **タイトル**: 部分的にサポートされます。最初のタイトルは、iOS **kABPersonJobTitleProperty**フィールドに格納されます。
\ No newline at end of file
[11/13] git commit: documentation translation: cordova-plugin-contacts
Posted by ld...@apache.org.
documentation translation: 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/0b69b50d
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/0b69b50d
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/0b69b50d
Branch: refs/heads/master
Commit: 0b69b50df3e5f9ab9d32ca9642cafc7c2352a4e3
Parents: efb6b94
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue May 27 21:36:04 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue May 27 21:36:04 2014 -0400
----------------------------------------------------------------------
doc/de/index.md | 668 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/ja/index.md | 132 ++++++----
2 files changed, 751 insertions(+), 49 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/0b69b50d/doc/de/index.md
----------------------------------------------------------------------
diff --git a/doc/de/index.md b/doc/de/index.md
new file mode 100644
index 0000000..ef27929
--- /dev/null
+++ b/doc/de/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
+
+Ermöglicht den Zugriff auf die Kontaktdatenbank Gerät.
+
+**Warnung**: Erhebung und Nutzung von Kontaktdaten löst wichtige Datenschutzprobleme. Ihre app-Datenschutzerklärung sollten besprechen, wie die app Kontaktdaten verwendet und ob es mit irgendwelchen anderen Parteien geteilt wird. Kontaktinformationen ist als vertraulich angesehen, weil es die Menschen zeigt, mit denen eine Person kommuniziert. Daher neben der app-Privacy Policy sollten stark Sie Bereitstellung einer just-in-Time-Bekanntmachung, bevor die app zugreift oder Kontaktdaten verwendet, wenn das Betriebssystem des Geräts bereits tun nicht. Diese Benachrichtigung sollte der gleichen Informationen, die vorstehend, sowie die Zustimmung des Benutzers (z.B. durch Präsentation Entscheidungen für das **OK** und **Nein danke**). Beachten Sie, dass einige app-Marktplätze die app eine Frist eine just-in-Time und erhalten die Erlaubnis des Benutzers vor dem Zugriff auf Kontaktdaten verlangen können. Eine klare und leicht verständliche Benutzererfahrung rund um die Verwendung d
er Kontakt-Daten Benutzer Verwirrung zu vermeiden können und wahrgenommene Missbrauch der Kontaktdaten. Weitere Informationen finden Sie in der Datenschutz-Guide.
+
+## Installation
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+### Firefox OS Macken
+
+Erstellen Sie **www/manifest.webapp** , wie in [Docs Manifest][1]beschrieben. Fügen Sie die entsprechenden Permisions. Es muss auch die Webapp um "privilegierte" - [Manifest Docs][2]ändern. **Warnung**: alle privilegierten apps [Content Security Policy][3] , welche Inlineskript verbietet zu erzwingen. Initialisieren Sie die Anwendung auf andere Weise.
+
+ [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"
+ }
+ }
+
+
+### Windows 8 Macken
+
+Windows 8 Kontakte sind Readonly. Über die Cordova-API-Kontakte nicht abgefragt werden/können durchsucht werden, Sie sollten den Benutzer informieren, wählen Sie einen Kontakt als Aufruf an contacts.pickContact, die 'People'-app öffnet, wo muss der Benutzer einen Kontakt auswählen. Alle zurückgegebenen Kontakte sind Readonly, so dass sie von die Anwendung nicht geändert werden kann.
+
+## Navigator.Contacts
+
+### Methoden
+
+* navigator.contacts.create
+* navigator.contacts.find
+* navigator.contacts.pickContact
+
+### Objekte
+
+* Kontakt
+* ContactName
+* ContactField
+* ContactAddress
+* ContactOrganization
+* ContactFindOptions
+* ContactError
+* ContactFieldType
+
+## Navigator.Contacts.Create
+
+Die `navigator.contacts.create` Methode ist synchron und gibt eine neue `Contact` Objekt.
+
+Diese Methode behält nicht das Kontakt-Objekt in der Gerät-Kontakte-Datenbank, wofür Sie aufrufen müssen der `Contact.save` Methode.
+
+### Unterstützte Plattformen
+
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 und 8
+
+### Beispiel
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## navigator.contacts.find
+
+Die `navigator.contacts.find` Methode wird asynchron ausgeführt, Abfragen der Gerät-Kontakte-Datenbank und gibt ein Array von `Contact` Objekten. Die resultierenden Objekte werden an übergeben die `contactSuccess` Callback-Funktion, die durch den **ContactSuccess** -Parameter angegeben.
+
+Der **ContactFields** -Parameter gibt die Felder als Qualifizierer Suche verwendet werden. Ein leere **ContactFields** -Parameter ist ungültig und führt zu `ContactError.INVALID_ARGUMENT_ERROR` . **ContactFields** der Wert `"*"` gibt alle Kontaktfelder.
+
+Die **contactFindOptions.filter** -Zeichenfolge kann als einen Suchfilter verwendet, wenn die Kontaktdatenbank Abfragen. Wenn angeboten, ein groß-und Kleinschreibung, wird jedes Feld in der **ContactFields** -Parameter angegebenen Teilwert Übereinstimmung. Wenn eine Übereinstimmung für *alle* angegebenen Felder vorliegt, wird der Kontakt zurückgegeben. Verwendung **contactFindOptions.desiredFields** Parameter steuern, welche Eigenschaften kontaktieren muss wieder zurückgegeben werden.
+
+### Parameter
+
+* **ContactSuccess**: Erfolg-Callback-Funktion aufgerufen, die mit dem Array von Contact-Objekte aus der Datenbank zurückgegeben. [Erforderlich]
+
+* **ContactError**: Fehler-Callback-Funktion wird aufgerufen, wenn ein Fehler auftritt. [Optional]
+
+* **ContactFields**: Kontaktfelder als Qualifizierer Suche verwenden. *(DOMString[])* [Erforderlich]
+
+* **ContactFindOptions**: Optionen zum Filtern von navigator.contacts zu suchen. [Optional] Schlüssel enthalten:
+
+* **Filter**: die zu suchende Zeichenfolge verwendet, um navigator.contacts zu finden. *(DOM-String und enthält)* (Standard:`""`)
+
+* **mehrere**: bestimmt, ob der Suchvorgang mehrere navigator.contacts gibt. *(Boolesch)* (Standard:`false`)
+
+ * **DesiredFields**: Kontaktfelder wieder zurückgegeben werden. Wenn angegeben, die sich daraus ergebende `Contact` Objekt verfügt nur über Werte für diese Felder. *(DOMString[])* [Optional]
+
+### Unterstützte Plattformen
+
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 und 8
+
+### Beispiel
+
+ 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
+
+Die `navigator.contacts.pickContact` -Methode startet im Kontakt Farbwähler wählen Sie einen einzigen Ansprechpartner. Das resultierende Objekt wird übergeben, um die `contactSuccess` Callback-Funktion, die durch den **ContactSuccess** -Parameter angegeben.
+
+### Parameter
+
+* **ContactSuccess**: Erfolg-Callback-Funktion, die mit den einzelnen Kontakt-Objekt aufgerufen. [Erforderlich]
+
+* **ContactError**: Fehler-Callback-Funktion wird aufgerufen, wenn ein Fehler auftritt. [Optional]
+
+### Unterstützte Plattformen
+
+* Android
+* iOS
+* Windows Phone 8
+* Windows 8
+
+### Beispiel
+
+ navigator.contacts.pickContact(function(contact){
+ console.log('The following contact has been selected:' + JSON.stringify(contact));
+ },function(err){
+ console.log('Error: ' + err);
+ });
+
+
+## Kontakt
+
+Das `Contact` -Objekt repräsentiert einen Benutzer Kontakt. Kontakte können erstellt, gespeichert oder aus der Gerät-Kontakte-Datenbank entfernt werden. Kontakte können auch abgerufen werden (einzeln oder als Gruppe) aus der Datenbank durch den Aufruf der `navigator.contacts.find` Methode.
+
+**Hinweis**: nicht alle oben aufgeführten Kontaktfelder werden auf jedes Geräteplattform unterstützt. Bitte überprüfen Sie jede Plattform *Quirks* Abschnitt für Details.
+
+### Eigenschaften
+
+* **ID**: einen globally unique Identifier. *(DOM-String und enthält)*
+
+* **DisplayName**: der Name dieses Kontakts, geeignet für die Anzeige für Endbenutzer. *(DOM-String und enthält)*
+
+* **Name**: ein Objekt, das alle Komponenten eines Personen-Namen enthält. *(Kontaktperson)*
+
+* **Nickname**: einen lässig ein, um den Kontakt zu adressieren. *(DOM-String und enthält)*
+
+* **Telefonnummern**: ein Array von der Kontakt-Telefonnummern. *(ContactField[])*
+
+* **Email**: ein Array von e-Mail-Adressen des Kontakts. *(ContactField[])*
+
+* **Adressen**: ein Array von allen Kontaktadressen. *(ContactAddress[])*
+
+* **IMS**: ein Array von IM-Adressen des Kontakts. *(ContactField[])*
+
+* **Organisationen**: ein Array von Organisationen des Kontakts. *(ContactOrganization[])*
+
+* **Geburtstag**: der Geburtstag des Kontakts. *(Datum)*
+
+* **Anmerkung**: eine Anmerkung über den Kontakt. *(DOM-String und enthält)*
+
+* **Fotos**: ein Array mit den Kontakt-Fotos. *(ContactField[])*
+
+* **Kategorien**: ein Array mit allen benutzerdefinierten Kategorien zugeordnet den Kontakt. *(ContactField[])*
+
+* **URLs**: ein Array von Web-Seiten, die den Kontakt zugeordnet. *(ContactField[])*
+
+### Methoden
+
+* **Klon**: gibt eine neue `Contact` Objekt, das eine tiefe Kopie des aufrufenden Objekts, mit der `id` -Eigenschaft festgelegt`null`.
+
+* **Entfernen**: entfernt den Kontakt aus der Gerät-Kontakte-Datenbank, ansonsten führt eine Fehler-Callback mit einem `ContactError` Objekt.
+
+* **Speichern**: speichert einen neuen Kontakt in der Gerätedatenbank Kontakte, oder einen vorhandenen Kontakt aktualisiert, wenn ein Kontakt mit der gleichen **Id** bereits vorhanden ist.
+
+### Unterstützte Plattformen
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 und 8
+* Windows 8
+
+### Speichern Sie Beispiel
+
+ 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);
+
+
+### Clone-Beispiel
+
+ // 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);
+
+
+### Beispiel zu entfernen
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### Android 2.X Macken
+
+* **Kategorien**: Android 2.X Geräten, Rückgabe nicht unterstützt`null`.
+
+### BlackBerry 10 Macken
+
+* **ID**: vom Gerät zugewiesen werden, wenn den Kontakt zu speichern.
+
+### FirefoxOS Macken
+
+* **Kategorien**: teilweise unterstützt. Felder **Pref** und **Typ** kehren zurück`null`
+
+* **IMS**: nicht unterstützt
+
+* **Fotos**: nicht unterstützt
+
+### iOS Macken
+
+* **DisplayName**: nicht auf iOS, Rückkehr unterstützt `null` es sei kein `ContactName` angegeben, in welchem Fall es gibt den zusammengesetzten Namen, **Spitznamen** oder `""` bzw..
+
+* **Geburtstag**: muss eingegeben werden, als JavaScript `Date` Objekt, die gleiche Weise zurückgegeben wird.
+
+* **Fotos**: gibt einen Datei-URL auf das Bild, das im temporären Verzeichnis der Anwendung gespeichert ist. Inhalt des temporären Verzeichnisses werden entfernt, wenn die Anwendung beendet wird.
+
+* **Kategorien**: Diese Eigenschaft wird derzeit nicht unterstützt, Rückgabe`null`.
+
+### Windows Phone 7 und 8 Macken
+
+* **DisplayName**: Wenn Sie einen Kontakt erstellen, der Nutzen für den Anzeigenamen der Display-Name-Parameter unterscheidet abgerufen, wenn den Kontakt zu finden.
+
+* **URLs**: Wenn Sie einen Kontakt erstellen, können Benutzer eingegeben und mehrere Web-Adressen zu speichern, aber nur einer ist verfügbar, wenn Sie den Kontakt zu suchen.
+
+* **Telefonnummern**: die *Pref* -Option wird nicht unterstützt. Der *Typ* wird in eine *find* -Operation nicht unterstützt. Nur ein `phoneNumber` ist erlaubt für jeden *Typ*.
+
+* **Email**: *Pref* -Option wird nicht unterstützt. Haus und persönliche verweist auf dasselbe e-Mail-Eintrag. Nur ein Eintrag ist für jeden *Typ* zulässig..
+
+* **Adressen**: unterstützt nur Arbeit und Home/persönliche *Art*. Den gleichen Adresseintrag auf den privaten und persönlichen *Typ* verweisen. Nur ein Eintrag ist für jeden *Typ* zulässig..
+
+* **Organisationen**: nur zulässig ist, und unterstützt nicht die Attribute *Pref*, *Typ*und *Abteilung* .
+
+* **Hinweis**: nicht unterstützt, Rückgabe`null`.
+
+* **IMS**: nicht unterstützt, Rückgabe`null`.
+
+* **Geburtstage**: nicht unterstützt, Rückgabe`null`.
+
+* **Kategorien**: nicht unterstützt, Rückgabe`null`.
+
+## ContactAddress
+
+Das `ContactAddress` -Objekt speichert die Eigenschaften einer einzelnen Adresse eines Kontakts. A `Contact` Objekt gehören mehr als eine Adresse in ein `ContactAddress[]` Array.
+
+### Eigenschaften
+
+* **Pref**: Legen Sie auf `true` Wenn dieses `ContactAddress` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+
+* **Typ**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. *(DOM-String und enthält)*
+
+* **formatiert**: die vollständige Adresse, die für die Anzeige formatiert. *(DOM-String und enthält)*
+
+* **StreetAddress**: die vollständige Postanschrift. *(DOM-String und enthält)*
+
+* **Ort**: die Stadt oder Gemeinde. *(DOM-String und enthält)*
+
+* **Region**: dem Staat oder der Region. *(DOM-String und enthält)*
+
+* **Postleitzahl**: die Postleitzahl oder Postleitzahl. *(DOM-String und enthält)*
+
+* **Land**: den Ländernamen. *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 und 8
+* Windows 8
+
+### Beispiel
+
+ // 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);
+
+
+### Android 2.X Macken
+
+* **Pref**: nicht unterstützt, Rückkehr `false` auf Android 2.X Geräten.
+
+### BlackBerry 10 Macken
+
+* **Pref**: BlackBerry-Geräten, Rückgabe nicht unterstützt`false`.
+
+* **Typ**: teilweise unterstützt. Nur eine *Arbeit* und *Home* Typ Adressen kann pro Kontakt gespeichert werden.
+
+* **formatiert**: teilweise unterstützt. Gibt eine Verkettung von allen BlackBerry-Adressfelder.
+
+* **StreetAddress**: unterstützt. Gibt eine Verkettung von BlackBerry **Adresse1** und **Adresse2** Adressfelder.
+
+* **Ort**: unterstützt. Gespeichert in BlackBerry **Stadt** Adressfeld.
+
+* **Region**: unterstützt. Gespeichert in BlackBerry **StateProvince** Adressfeld.
+
+* **Postleitzahl**: unterstützt. Im Feld für die Adresse des BlackBerry- **ZipPostal** gespeichert.
+
+* **Land**: unterstützt.
+
+### FirefoxOS Macken
+
+* **formatiert**: derzeit nicht unterstützt
+
+### iOS Macken
+
+* **Pref**: iOS-Geräten, Rückgabe nicht unterstützt`false`.
+
+* **formatiert**: derzeit nicht unterstützt.
+
+### Windows 8 Macken
+
+* **Pref**: nicht unterstützt
+
+## ContactError
+
+Das `ContactError` -Objekt wird zurückgegeben, die der Benutzer über die `contactError` Callback-Funktion, wenn ein Fehler auftritt.
+
+### Eigenschaften
+
+* **Code**: einer der vordefinierten Fehlercodes aufgeführt.
+
+### Konstanten
+
+* `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
+
+Das `ContactField` -Objekt ist eine wieder verwendbare Komponenten stellt Felder generisch kontaktieren. Jeder `ContactField` -Objekt enthält eine `value` , `type` , und `pref` Eigenschaft. A `Contact` -Objekt speichert mehrere Eigenschaften in `ContactField[]` -Arrays, wie Telefon-Nummern und e-Mail-Adressen.
+
+In den meisten Fällen gibt es keine vorher festgelegten Werte für ein `ContactField` **Typ** -Attribut des Objekts. Beispielsweise kann eine Telefonnummer angeben **Typwerte von *Zuhause*, *arbeiten*, *mobile*, *iPhone*oder ein beliebiger anderer Wert, der von einem bestimmten Geräteplattform Kontaktdatenbank unterstützt wird** . Jedoch für die `Contact` **Fotos** Feld, das **Typ** -Feld gibt das Format des zurückgegebenen Bild: **Url** wenn das **Value** -Attribut eine URL zu dem Foto Bild oder *base64* , enthält Wenn der **Wert** eine base64-codierte Bild-Zeichenfolge enthält.
+
+### Eigenschaften
+
+* **Typ**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. *(DOM-String und enthält)*
+
+* **Wert**: der Wert des Feldes, wie z. B. eine Telefonnummer oder e-Mail-Adresse. *(DOM-String und enthält)*
+
+* **Pref**: Legen Sie auf `true` Wenn dieses `ContactField` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+
+### Unterstützte Plattformen
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 und 8
+* Windows 8
+
+### Beispiel
+
+ // 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();
+
+
+### Android Macken
+
+* **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### BlackBerry 10 Macken
+
+* **Typ**: teilweise unterstützt. Für Telefonnummern verwendet.
+
+* **Wert**: unterstützt.
+
+* **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### iOS Macken
+
+* **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### Windows8 Macken
+
+* **Pref**: nicht unterstützt, Rückgabe`false`.
+
+## ContactName
+
+Enthält verschiedene Arten von Informationen über ein `Contact` Name des Objekts.
+
+### Eigenschaften
+
+* **formatiert**: den vollständigen Namen des Kontakts. *(DOM-String und enthält)*
+
+* **Nachname**: Familienname des Kontakts. *(DOM-String und enthält)*
+
+* **GivenName**: Given Name des Kontaktes. *(DOM-String und enthält)*
+
+* **MiddleName**: Middle Name des Kontaktes. *(DOM-String und enthält)*
+
+* **HonorificPrefix**: der Kontakt-Präfix (z.B. *Mr.* oder *Dr.*) *(DOM-String und enthält)*
+
+* **HonorificSuffix**: der Kontakt-Suffix (Beispiel *Esq.*). *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+* Amazon Fire OS
+* Android 2.X
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 und 8
+* Windows 8
+
+### Beispiel
+
+ 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);
+
+
+### Android Macken
+
+* **formatiert**: teilweise unterstützte "und" Read-only. Gibt eine Verkettung von `honorificPrefix` , `givenName` , `middleName` , `familyName` , und`honorificSuffix`.
+
+### BlackBerry 10 Macken
+
+* **formatiert**: teilweise unterstützt. Gibt eine Verkettung von BlackBerry- **FirstName** und **LastName** -Feldern.
+
+* **Nachname**: unterstützt. Im Feld der BlackBerry- **Nachname** gespeichert.
+
+* **GivenName**: unterstützt. Im BlackBerry **FirstName** -Feld gespeichert.
+
+* **MiddleName**: nicht unterstützt, Rückgabe`null`.
+
+* **HonorificPrefix**: nicht unterstützte, Rückgabe`null`.
+
+* **HonorificSuffix**: nicht unterstützte, Rückgabe`null`.
+
+### FirefoxOS Macken
+
+* **formatiert**: teilweise unterstützte "und" Read-only. Gibt eine Verkettung von `honorificPrefix` , `givenName` , `middleName` , `familyName` , und`honorificSuffix`.
+
+### iOS Macken
+
+* **formatiert**: teilweise unterstützt. IOS zusammengesetzten Namen gibt, aber ist schreibgeschützt.
+
+### Windows 8 Macken
+
+* **formatiert**: Dies ist die einzige Eigenschaft, und ist identisch mit `displayName` , und`nickname`
+
+* **Nachname**: nicht unterstützt
+
+* **GivenName**: nicht unterstützt
+
+* **MiddleName**: nicht unterstützt
+
+* **HonorificPrefix**: nicht unterstützt
+
+* **HonorificSuffix**: nicht unterstützt
+
+## ContactOrganization
+
+Das `ContactOrganization` -Objekt speichert Organisationseigenschaften eines Kontakts. A `Contact` -Objekt speichert eine oder mehrere `ContactOrganization` Objekte in einem Array.
+
+### Eigenschaften
+
+* **Pref**: Legen Sie auf `true` Wenn dieses `ContactOrganization` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+
+* **Typ**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. _(DOMString)
+
+* **Name**: der Name der Organisation. *(DOM-String und enthält)*
+
+* **Abteilung**: die Abteilung, die der Vertrag für arbeitet. *(DOM-String und enthält)*
+
+* **Titel**: Titel des Kontakts in der Organisation. *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 und 8
+
+### Beispiel
+
+ 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);
+
+
+### Android 2.X Macken
+
+* **Pref**: von Android 2.X-Geräte, Rückgabe nicht unterstützt`false`.
+
+### BlackBerry 10 Macken
+
+* **Pref**: von BlackBerry-Geräten zurückgeben nicht unterstützt`false`.
+
+* **Typ**: von BlackBerry-Geräten zurückgeben nicht unterstützt`null`.
+
+* **Name**: teilweise unterstützt. Der Name der ersten Organisation wird im Feld **Firma** BlackBerry gespeichert.
+
+* **Abteilung**: nicht unterstützt, Rückgabe`null`.
+
+* **Titel**: teilweise unterstützt. Der erste Titel der Organisation wird im Feld **JobTitle** BlackBerry gespeichert.
+
+### Firefox OS Macken
+
+* **Pref**: nicht unterstützt
+
+* **Typ**: nicht unterstützt
+
+* **Abteilung**: nicht unterstützt
+
+* Felder **Name** und **Titel** in **Org** und **JobTitle** gespeichert.
+
+### iOS Macken
+
+* **Pref**: iOS-Geräten, Rückgabe nicht unterstützt`false`.
+
+* **Typ**: iOS-Geräten, Rückgabe nicht unterstützt`null`.
+
+* **Name**: teilweise unterstützt. Der Name der ersten Organisation wird im Feld **kABPersonOrganizationProperty** iOS gespeichert.
+
+* **Abteilung**: teilweise unterstützt. Die Abteilungsnamen der erste ist im Feld **kABPersonDepartmentProperty** iOS gespeichert.
+
+* **Titel**: teilweise unterstützt. Der erste Titel wird im Feld **kABPersonJobTitleProperty** iOS gespeichert.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/0b69b50d/doc/ja/index.md
----------------------------------------------------------------------
diff --git a/doc/ja/index.md b/doc/ja/index.md
index 9d7fea8..82ffb11 100644
--- a/doc/ja/index.md
+++ b/doc/ja/index.md
@@ -19,7 +19,7 @@
# org.apache.cordova.contacts
-Provides access to the device contacts database.
+デバイスの連絡先データベースへのアクセスを提供します。
**警告**: 連絡先データの収集と利用を重要なプライバシーの問題を発生させます。 アプリのプライバシー ポリシー アプリが連絡先データを使用する方法と、他の当事者では共有されているかどうかを話し合う必要があります。 人誰と通信する人々 を明らかにするために、連絡先情報が機密と見なされます。 したがって、アプリのプライバシー ポリシーに加えて、強くする必要がありますデバイスのオペレーティング システムが既にしない場合アプリにアクセスまたは連絡先のデータを使用する前に - 時間のお知らせを提供します。 その通知は、上記の (例えば、 **[ok]**を**おかげで**選択肢を提示する) によってユーザーのアクセス許可を取得するだけでなく、同じ情報を提供する必要があります。 いくつかのアプリのマーケットプ レ
ース - 時間の通知を提供して、連絡先データにアクセスする前にユーザーの許可を取得するアプリをする必要がありますに注意してください。 連絡先データは、ユーザーの混乱を避けるのに役立ちますの使用および連絡先データの知覚の誤用を囲む明確でわかりやすいユーザー エクスペリエンス。 詳細については、プライバシーに関するガイドを参照してください。
@@ -28,9 +28,9 @@ Provides access to the device contacts database.
cordova plugin add org.apache.cordova.contacts
-### Firefox OS Quirks
+### Firefox OS 癖
-Create **www/manifest.webapp** as described in [Manifest Docs][1]. Add relevant permisions. There is also a need to change the webapp type to "privileged" - [Manifest Docs][2]. **WARNING**: All privileged apps enforce [Content Security Policy][3] which forbids inline script. Initialize your application in another way.
+[マニフェストのドキュメント][1]で説明されているように、 **www/manifest.webapp**を作成します。 関連する権限を追加します。 [マニフェストのドキュメント][2]「特権」- に web アプリケーションの種類を変更する必要も。 **警告**: すべての特権を持つアプリケーション インライン スクリプトを禁止している[コンテンツのセキュリティ ポリシー][3]を適用します。 別の方法で、アプリケーションを初期化します。
[1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
[2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
@@ -45,12 +45,17 @@ Create **www/manifest.webapp** as described in [Manifest Docs][1]. Add relevant
}
+### Windows 8 の癖
+
+Windows 8 の連絡先は、読み取り専用です。 コルドバ API コンタクトを介してされませんクエリ/検索可能で、ユーザーに通知する必要があります連絡先を選択 '人' アプリを開くことが contacts.pickContact への呼び出しとして、ユーザーが連絡先を選択する必要があります。 戻される連絡先は読み取り専用、アプリケーションを変更することはできません。
+
## navigator.contacts
### メソッド
* navigator.contacts.create
* navigator.contacts.find
+* navigator.contacts.pickContact
### オブジェクト
@@ -61,10 +66,11 @@ Create **www/manifest.webapp** as described in [Manifest Docs][1]. Add relevant
* ContactOrganization
* ContactFindOptions
* ContactError
+* ContactFieldType
## navigator.contacts.create
-The `navigator.contacts.create` method is synchronous, and returns a new `Contact` object.
+`navigator.contacts.create`メソッドは同期的にし、新しいを返します `Contact` オブジェクト。
このメソッドを呼び出す必要があるデバイスの連絡先データベースに連絡先オブジェクトを保持しない、 `Contact.save` メソッド。
@@ -72,10 +78,9 @@ The `navigator.contacts.create` method is synchronous, and returns a new `Contac
* アンドロイド
* ブラックベリー 10
-* Firefox OS
+* Firefox の OS
* iOS
* Windows Phone 7 と 8
-* Windows 8 ( Note: Windows 8 Contacts are readonly via the Cordova API Contacts are not queryable/searchable, you should inform the user to pick a contact as a call to contacts.find will open the 'People' app where the user must choose a contact. 戻される連絡先は読み取り専用、アプリケーションを変更することはできません。 )
### 例
@@ -84,34 +89,35 @@ The `navigator.contacts.create` method is synchronous, and returns a new `Contac
## navigator.contacts.find
-The `navigator.contacts.find` method executes asynchronously, querying the device contacts database and returning an array of `Contact` objects. 結果として得られるオブジェクトに渡される、 `contactSuccess` 、 **contactSuccess**パラメーターで指定されたコールバック関数。
+`navigator.contacts.find`デバイスの連絡先データベースをクエリの配列を返すメソッドは、非同期的に実行されます `Contact` オブジェクト。 結果として得られるオブジェクトに渡される、 `contactSuccess` 、 **contactSuccess**パラメーターで指定されたコールバック関数。
-**連絡先**パラメーター検索の修飾子として使用するフィールドを指定してだけこれらの結果は**contactSuccess**コールバック関数に渡されます。 **連絡先**のゼロ長さのパラメーターが無効である結果 `ContactError.INVALID_ARGUMENT_ERROR` 。 **連絡先**値 `"*"` すべての連絡先フィールドを返します。
+**連絡先**パラメーター検索の修飾子として使用するフィールドを指定します。 ゼロ長さ**連絡先**パラメーターが有効になり `ContactError.INVALID_ARGUMENT_ERROR` 。 **連絡先**値 `"*"` すべての連絡先フィールドを返します。
-**ContactFindOptions.filter**文字列の連絡先データベースを照会するときに検索フィルターとして使用できます。 指定した場合、大文字と小文字、部分的な値の一致する**連絡先**パラメーターで指定されたフィールドごとに適用されます。 一致する*任意*指定のフィールドがある場合は、連絡先が返されます。
+**ContactFindOptions.filter**文字列の連絡先データベースを照会するときに検索フィルターとして使用できます。 指定した場合、大文字と小文字、部分的な値の一致する**連絡先**パラメーターで指定されたフィールドごとに適用されます。 一致する*任意*指定のフィールドがある場合は、連絡先が返されます。 バック連絡先プロパティを制御する**contactFindOptions.desiredFields**パラメーターを使用しますが返される必要があります。
### パラメーター
-* **連絡先**: 連絡先検索修飾子として使用するフィールド。結果として `Contact` オブジェクトのみ機能のこれらのフィールドの値。*(DOMString[])*[必須]
-
-* **contactSuccess**: Success callback function invoked with the array of Contact objects returned from the database. [Required]
+* **contactSuccess**: Contact オブジェクトの配列に呼び出される成功コールバック関数は、データベースから返されます。[必須]
* **contactError**: エラー コールバック関数は、エラーが発生したときに呼び出されます。[オプション]
-* **contactFindOptions**: Search options to filter navigator.contacts. [Optional] Keys include:
+* **連絡先**: 連絡先検索修飾子として使用するフィールド。*(DOMString[])*[必須]
+
+* **contactFindOptions**: navigator.contacts をフィルターするオプションを検索します。[オプション]キーは次のとおりです。
* **フィルター**: navigator.contacts の検索に使用する検索文字列。*（，）*(既定値します。`""`)
-* **multiple**: Determines if the find operation returns multiple navigator.contacts. *(Boolean)* (Default: `false`)
+* **複数**: 複数 navigator.contacts かどうかは、検索操作に返すを決定します。*(ブール値)*(既定値します。`false`)
+
+ * **desiredFields**： 戻って返されるフィールドに問い合わせてください。指定した場合、結果として `Contact` オブジェクトのみ機能のこれらのフィールドの値。*(DOMString[])*[オプション]
### サポートされているプラットフォーム
* アンドロイド
* ブラックベリー 10
-* Firefox OS
+* Firefox の OS
* iOS
* Windows Phone 7 と 8
-* Windows 8 ( read-only support, search requires user interaction, contactFields are ignored, only contactFindOptions.multiple is used to enable the user to select 1 or many contacts. )
### 例
@@ -127,13 +133,40 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
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
+
+`navigator.contacts.pickContact`メソッド連絡先ピッカーを起動します 1 つの連絡先を選択します。 結果として得られるオブジェクトに渡される、 `contactSuccess` 、 **contactSuccess**パラメーターで指定されたコールバック関数。
+
+### パラメーター
+
+* **contactSuccess**: 1 つの連絡先オブジェクトに呼び出される成功コールバック関数。[必須]
+
+* **contactError**: エラー コールバック関数は、エラーが発生したときに呼び出されます。[オプション]
+
+### サポートされているプラットフォーム
+
+* アンドロイド
+* iOS
+* Windows Phone 8
+* Windows 8
+
+### 例
+
+ navigator.contacts.pickContact(function(contact){
+ console.log('The following contact has been selected:' + JSON.stringify(contact));
+ },function(err){
+ console.log('Error: ' + err);
+ });
## お問い合わせ
-`Contact`オブジェクトは、ユーザーの連絡先を表します。 連絡先の作成、格納、またはデバイスの連絡先データベースから削除することができます。 Contacts can also be retrieved (individually or in bulk) from the database by invoking the `navigator.contacts.find` method.
+`Contact`オブジェクトは、ユーザーの連絡先を表します。 連絡先の作成、格納、またはデバイスの連絡先データベースから削除することができます。 連絡先も取得できます (個別にまたは一括） をデータベースから呼び出すことによって、 `navigator.contacts.find` メソッド。
**注**: すべて上記の連絡先フィールドのすべてのデバイス プラットフォームでサポートされます。詳細については各プラットフォームの*互換*セクションを確認してください。
@@ -180,11 +213,12 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
* アマゾン火 OS
* アンドロイド
* ブラックベリー 10
-* Firefox OS
+* Firefox の OS
* iOS
* Windows Phone 7 と 8
+* Windows 8
-### Save Example
+### 保存の例
function onSuccess(contact) {
alert("Save Success");
@@ -209,7 +243,7 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
contact.save(onSuccess,onError);
-### Clone Example
+### クローンの例
// clone the contact object
var clone = contact.clone();
@@ -218,7 +252,7 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
console.log("Cloned contact name = " + clone.name.givenName);
-### Remove Example
+### 削除の例
function onSuccess() {
alert("Removal Success");
@@ -238,15 +272,15 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
### ブラックベリー 10 癖
-* **id**: Assigned by the device when saving the contact.
+* **id**: 連絡先を保存するときに、デバイスによって割り当てられます。
-### FirefoxOS Quirks
+### FirefoxOS の癖
-* **categories**: Partially supported. Fields **pref** and **type** are returning `null`
+* **カテゴリ**: 部分的にサポートされます。フィールド**県**・**タイプ**を返す`null`
-* **ims**: Not supported
+* **ims**: サポートされていません。
-* **photos**: Not supported
+* **写真**: サポートされていません。
### iOS の癖
@@ -262,7 +296,7 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
* **displayName**: 表示名パラメーターの表示名と異なるために提供値を取得、連絡先を検索するとき、連絡先を作成するとき。
-* **url**: 連絡先を検索するときに 1 つだけが利用できるが、ユーザーによる入力し 1 つ以上の web アドレスを保存する連絡先を作成するとき。
+* **url**: 連絡先を作成するときユーザー入力保存でき、1 つ以上の web アドレスが 1 つだけ、連絡先を検索するとき。
* **電話番号**:*県*オプションはサポートされていません。 *型*は、*検索*操作ではサポートされていません。 1 つだけ `phoneNumber` は各*タイプ*の許可.
@@ -307,7 +341,7 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
* アマゾン火 OS
* アンドロイド
* ブラックベリー 10
-* Firefox OS
+* Firefox の OS
* iOS
* Windows Phone 7 と 8
* Windows 8
@@ -364,9 +398,9 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
* **国**: サポートされています。
-### FirefoxOS Quirks
+### FirefoxOS の癖
-* **formatted**: Currently not supported
+* **フォーマット**: 現在サポートされていません
### iOS の癖
@@ -374,9 +408,9 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
* **フォーマット**: 現在サポートされていません。
-### Windows 8 Quirks
+### Windows 8 の癖
-* **pref**: Not supported
+* **県**: サポートされていません。
## ContactError
@@ -400,22 +434,22 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
`ContactField`オブジェクトは連絡先フィールドを総称を表す再利用可能なコンポーネントです。 各 `ContactField` オブジェクトが含まれています、 `value` 、 `type` 、および `pref` プロパティ。 A `Contact` オブジェクトのいくつかのプロパティに格納されます `ContactField[]` 携帯電話番号、メール アドレスなどの配列。
-ほとんどの場合、事前に決められた値がない、 `ContactField` オブジェクトの**type**属性。 たとえば、電話番号が*ホーム*、*仕事*、*モバイル*、 *iPhone*、または特定のデバイス プラットフォームの連絡先データベースでサポートされている他の値の**型**の値を指定できます。 ただし、ため、 `Contact` **写真**] フィールドに、**種類**フィールド、返されるイメージの形式を示します: **url** **値**属性**値**を base64 でエンコードされたイメージの文字列が含まれる場合に写真イメージまたは*base64*に URL が含まれる場合。
+ほとんどの場合、事前に決められた値がない、 `ContactField` オブジェクトの**type**属性。 たとえば、電話番号が*ホーム*、*仕事*、*モバイル*、 *iPhone*、または特定のデバイス プラットフォームの連絡先データベースでサポートされている他の値の**型**の値を指定できます。 ただし、ため、 `Contact` **写真**] フィールドに、**種類**フィールド、返されるイメージの形式を示します: **url** **値**属性**値**を base64 でエンコードされたイメージの文字列が含まれる場合に写真イメージまたは*base64*に URL が含まれる場合。
### プロパティ
-* **type**: A string that indicates what type of field this is, *home* for example. *(DOMString)*
+* **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。*（，）*
-* **value**: The value of the field, such as a phone number or email address. *(DOMString)*
+* **値**: 電話番号や電子メール アドレスなど、フィールドの値。*（，）*
-* **pref**: Set to `true` if this `ContactField` contains the user's preferred value. *(boolean)*
+* **県**: に設定されている `true` 場合は、この `ContactField` ユーザーの推奨値が含まれています。*(ブール値)*
### サポートされているプラットフォーム
* アマゾン火 OS
* アンドロイド
* ブラックベリー 10
-* Firefox OS
+* Firefox の OS
* iOS
* Windows Phone 7 と 8
* Windows 8
@@ -438,23 +472,23 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
### Android の癖
-* **pref**: Not supported, returning `false`.
+* **県**: サポートされていないを返す`false`.
### ブラックベリー 10 癖
-* **type**: Partially supported. Used for phone numbers.
+* **種類**: 部分的にサポートされます。電話番号を使用します。
-* **value**: Supported.
+* **値**: サポートされています。
-* **pref**: Not supported, returning `false`.
+* **県**: サポートされていないを返す`false`.
### iOS の癖
-* **pref**: Not supported, returning `false`.
+* **県**: サポートされていないを返す`false`.
-### Windows8 Quirks
+### Windows8 の癖
-* **pref**: Not supported, returning `false`.
+* **県**: サポートされていないを返す`false`.
## 得意先コード
@@ -462,9 +496,9 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
### プロパティ
-* **formatted**: The complete name of the contact. *(DOMString)*
+* **フォーマット**: 連絡先の完全な名前。*（，）*
-* **familyName**: The contact's family name. *(DOMString)*
+* **familyName**: 連絡先の姓。*（，）*
* **givenName**: 連絡先の名前。*（，）*
@@ -509,7 +543,7 @@ The `navigator.contacts.find` method executes asynchronously, querying the devic
### Android の癖
-* **フォーマット**： 部分的にサポートされると読み取り専用です。 連結を返します `honorificPrefix` 、 `givenName` 、 `middleName` 、 `familyName` と`honorificSuffix`.
+* **フォーマット**： 部分的にサポートされており、読み取り専用です。 連結を返します `honorificPrefix` 、 `givenName` 、 `middleName` 、 `familyName` と`honorificSuffix`.
### ブラックベリー 10 癖
[08/13] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/81cb15ac
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/81cb15ac
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/81cb15ac
Branch: refs/heads/master
Commit: 81cb15acbe297bca9998b5b4aa475c511cf4e828
Parents: 6da59ee 756e40c
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue May 27 19:33:21 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue May 27 19:33:21 2014 -0400
----------------------------------------------------------------------
NOTICE | 1 +
doc/index.md | 72 +++++--
plugin.xml | 15 +-
src/android/ContactAccessor.java | 66 +++---
src/android/ContactAccessorSdk5.java | 79 +++----
src/android/ContactInfoDTO.java | 59 ++++++
src/android/ContactManager.java | 60 +++++-
src/ios/CDVContacts.h | 9 +
src/ios/CDVContacts.m | 34 ++-
src/windows8/ContactProxy.js | 178 +++++++---------
src/wp/ContactPicker.xaml | 73 +++++++
src/wp/ContactPicker.xaml.cs | 125 +++++++++++
src/wp/ContactPickerTask.cs | 122 +++++++++++
src/wp/Contacts.cs | 333 +++++++++++------------------
src/wp/ContactsHelper.cs | 335 ++++++++++++++++++++++++++++++
www/ContactFieldType.js | 55 +++++
www/ContactFindOptions.js | 3 +-
www/contacts.js | 26 ++-
18 files changed, 1228 insertions(+), 417 deletions(-)
----------------------------------------------------------------------
[04/13] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/a107c3a4
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/a107c3a4
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/a107c3a4
Branch: refs/heads/master
Commit: a107c3a483e0cf0d9329b1f1b194f28bc1905b3b
Parents: cef72e3 6ed8b90
Author: ldeluca <ld...@us.ibm.com>
Authored: Fri Mar 28 12:08:49 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Fri Mar 28 12:08:49 2014 -0400
----------------------------------------------------------------------
doc/index.md | 40 ++++++++--
plugin.xml | 7 +-
src/windows8/ContactProxy.js | 151 ++++++++++++++++++++++++++++++++++++++
3 files changed, 189 insertions(+), 9 deletions(-)
----------------------------------------------------------------------
[05/13] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/173bcaba
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/173bcaba
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/173bcaba
Branch: refs/heads/master
Commit: 173bcaba5e99ec05e4023abe5667cebdfbd5e7b1
Parents: a107c3a a3f290d
Author: ldeluca <ld...@us.ibm.com>
Authored: Mon May 5 10:00:08 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Mon May 5 10:00:08 2014 -0400
----------------------------------------------------------------------
CONTRIBUTING.md | 16 ++++++++++
RELEASENOTES.md | 6 ++++
doc/index.md | 42 +++++++--------------------
plugin.xml | 20 ++++++++++++-
src/firefoxos/ContactsProxy.js | 58 ++++++++++++++++++-------------------
src/ios/CDVContact.m | 2 +-
src/ios/CDVContacts.m | 20 ++++++-------
7 files changed, 92 insertions(+), 72 deletions(-)
----------------------------------------------------------------------
[13/13] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/e02ede18
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/e02ede18
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/e02ede18
Branch: refs/heads/master
Commit: e02ede18d3aef7c451998be9beeb0697147067fa
Parents: acfe547 903aba0
Author: ldeluca <ld...@us.ibm.com>
Authored: Mon Jul 7 11:07:33 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Mon Jul 7 11:07:33 2014 -0400
----------------------------------------------------------------------
RELEASENOTES.md | 4 +++-
doc/index.md | 2 +-
src/android/ContactManager.java | 15 ++++++++++++++-
src/ios/CDVContact.m | 4 ++++
www/contacts.js | 4 ++--
5 files changed, 24 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
[02/13] git commit: Lisa testing pulling in plugins for plugin:
cordova-plugin-contacts
Posted by ld...@apache.org.
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/ec47823c
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/ec47823c
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/ec47823c
Branch: refs/heads/master
Commit: ec47823c13b27e2783701b4a59304bcf8c692be6
Parents: 0aa9d83
Author: ldeluca <ld...@us.ibm.com>
Authored: Thu Feb 27 11:14:24 2014 -0500
Committer: ldeluca <ld...@us.ibm.com>
Committed: Thu Feb 27 11:14:24 2014 -0500
----------------------------------------------------------------------
doc/fr/index.md | 633 +++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 633 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/ec47823c/doc/fr/index.md
----------------------------------------------------------------------
diff --git a/doc/fr/index.md b/doc/fr/index.md
new file mode 100644
index 0000000..8f8aee8
--- /dev/null
+++ b/doc/fr/index.md
@@ -0,0 +1,633 @@
+<!---
+ 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
+
+Donne accès à la base de données de contacts de dispositif.
+
+**Avertissement**: collecte et utilisation des données de contact soulève des questions importantes de la vie privée. La politique de confidentialité de votre application doit examiner comment l'application utilise les données de contact et si elles sont partagées avec d'autres parties. Les information de contact sont considérés comme sensibles parce qu'elles révèlent les gens avec lesquels une personne communique. Par conséquent, en plus de la politique de confidentialité de l'application, vous devez envisager fortement fournissant un avis juste-à-temps, avant que l'application accède ou utilise des données de contact, si le système d'exploitation de périphérique ne fait donc pas déjà. Cet avis doit fournir les mêmes renseignements mentionnés précédemment, ainsi qu'obtenir l'autorisation de l'utilisateur (par exemple, en présentant des choix **OK** et **Non merci**). Notez que certains marchés app peuvent exiger l'application de fournir un avis juste-à-te
mps et obtenir la permission de l'utilisateur avant d'accéder à des données de contact. Une expérience utilisateur claire et facile à comprendre qui entourent l'utilisation de données permettent d'éviter la confusion des utilisateurs de contact et une utilisation jugée abusive des données de contact. Pour plus d'informations, consultez le Guide de la vie privée.
+
+## Installation
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+### Firefox OS Quirks
+
+Créez **www/manifest.webapp** comme décrit dans [Les Docs manifeste][1]. Ajouter permisions pertinentes. Il est également nécessaire de changer le type d'application Web de « privilégiés » - [Docs manifeste][2]. **Avertissement**: toutes les applications privilégiées appliquer [Contenu politique de sécurité][3] qui interdit à un script inline. Initialiser votre application d'une autre manière.
+
+ [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"
+ }
+ }
+
+
+## Navigator.contacts
+
+### Méthodes
+
+* navigator.contacts.create
+* navigator.contacts.find
+
+### Objets
+
+* Contact
+* ContactName
+* ContactField
+* ContactAddress
+* ContactOrganization
+* ContactFindOptions
+* ContactError
+
+## 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`.
+
+### Plates-formes prises en charge
+
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 et 8
+
+### Exemple
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## 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** .
+
+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.
+
+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é.
+
+### 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]
+
+* **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`)
+
+### Plates-formes prises en charge
+
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 et 8
+* Windows 8
+
+### Exemple
+
+ function onSuccess(contacts) {
+ alert('Found ' + navigator.contacts.length + ' navigator.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;
+ var fields = ["displayName", "name"];
+ navigator.contacts.find(fields, onSuccess, onError, options);
+
+
+## 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.
+
+**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)*
+
+* **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)*
+
+* **nickname** : un nom occasionnel se référant au contact. *(DOMString)*
+
+* **phoneNumbers** : un tableau des numéros de téléphone du contact. *(ContactField[])*
+
+* **emails** : un tableau des adresses email du contact. *(ContactField[])*
+
+* **addresses** : un tableau contenant toutes les adresses du contact. *(ContactAddress[])*
+
+* **ims** : un tableau contenant les adresses de messagerie instantanée du contact. *(ContactField[])*
+
+* **organizations** : un tableau contenant les organismes liés au contact. *(ContactOrganization[])*
+
+* **birthday** : la date d'anniversaire du contact. *(Date)*
+
+* **note** : une remarque à propos du contact. *(DOMString)*
+
+* **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[])*
+
+* **urls** : un tableau d'adresses Web attribuées 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`.
+
+* **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`.
+
+* **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à.
+
+### Plates-formes prises en charge
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 et 8
+* Windows 8
+
+### Enregistrez l'exemple
+
+ 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);
+
+
+### Exemple de 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);
+
+
+### Supprimer l'exemple
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### Notes au sujet d'Android 2.X
+
+* **categories** : non pris en charge sur les périphériques Android 2.X, valeur `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**.
+
+### Bizarreries de FirefoxOS
+
+* **catégories**: partiellement pris en charge. Champs **pref** et **type** sont de retour`null`
+
+* **IMS**: non pris en charge
+
+* **photos**: ne pas pris en charge
+
+### 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 `""`.
+
+* **birthday** : doit être un object `Date` JavaScript, il sera aussi retourné en tant que tel.
+
+* **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.
+
+* **categories** : cette propriété n'est actuellement pas supportée, valeur `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.
+
+* **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*.
+
+* **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*.
+
+* **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*.
+
+* **organizations** : une seule entrée autorisée, les attributs *pref*, *type* et *department* ne sont pas supportés.
+
+* **note** : pas pris en charge, valeur `null`.
+
+* **IMS**: ne pas pris en charge, retour`null`.
+
+* **birthdays** : pas pris en charge, valeur `null`.
+
+* **categories** : pas pris en charge, valeur `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[]`.
+
+### Propriétés
+
+* **pref** : la valeur `true` si `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)*
+
+* **formatted** : l'adresse complète formattée pour l'affichage. *(DOMString)*
+
+* **streetAddress** : l'adresse complète. *(DOMString)*
+
+* **locality** : la ville ou la localité. *(DOMString)*
+
+* **region** : l'État ou la région. *(DOMString)*
+
+* **postalCode** : le code zip ou code postal. *(DOMString)*
+
+* **country** : le nom du pays. *(DOMString)*
+
+### Plates-formes prises en charge
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 et 8
+* Windows 8
+
+### Exemple
+
+ // display the address information for all contacts
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < navigator.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);
+
+
+### Android 2.X Quirks
+
+* **pref** : non pris en charge, retourne `false` sur les appareils Android 2.X.
+
+### BlackBerry 10 Quirks
+
+* **pref** : non pris en charge sur les appareils BlackBerry, retourne `false`.
+
+* **type** : partiellement pris en charge. Seulement un des types d'adresse *Work* et *Home* peut être stocké par contact.
+
+* **formatted** : 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**.
+
+* **locality** : prise en charge. Stockée dans le champ d'adresse BlackBerry **city** .
+
+* **region** : 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** .
+
+* **country** : prise en charge.
+
+### Bizarreries de FirefoxOS
+
+* **au format**: actuellement ne pas pris en charge
+
+### iOS Quirks
+
+* **pref** : non pris en charge sur les appareils iOS, retourne `false`.
+
+* **formatted** : actuellement non pris en charge.
+
+## ContactError
+
+L'objet `ContactError` est retourné à l'utilisateur via la fonction de callback `contactError` lorsqu'une erreur survient.
+
+### Propriétés
+
+* **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`
+
+## 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.
+
+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.
+
+### Propriétés
+
+* **type** : une chaîne qui indique le type de champ, *home* par exemple. *(DOMString)*
+
+* **value** : 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)*
+
+### Plates-formes prises en charge
+
+* Amazon Fire OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 et 8
+* Windows 8
+
+### Exemple
+
+ // 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();
+
+
+### Quirks Android
+
+* **pref** : nonpas pris en charge, retourne `false`.
+
+### BlackBerry 10 Quirks
+
+* **type** : partiellement pris en charge. Utilisé pour les numéros de téléphone.
+
+* **valeur** : pris en charge.
+
+* **pref**: ne pas pris en charge, retour`false`.
+
+### iOS Quirks
+
+* **pref**: ne pas pris en charge, retour`false`.
+
+## ContactName
+
+Contient différents types d'informations sur le nom d'un objet `Contact`.
+
+### Propriétés
+
+* **mise en forme** : le nom complet du contact. *(DOMString)*
+
+* **familyName** : nom de famille du contact. *(DOMString)*
+
+* **givenName** : prénom du contact. *(DOMString)*
+
+* **middleName** : deuxième prénom du contact. *(DOMString)*
+
+* **honorificPrefix** : préfixe du contact (exemple *M.* ou *Mme*) *(DOMString)*
+
+* **honorificSuffix** : suffixe du contact (exemple *Esq.*). *(DOMString)*
+
+### Plates-formes prises en charge
+
+* Amazon Fire OS
+* Android 2.X
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 et 8
+* Windows 8
+
+### Exemple
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < navigator.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);
+
+
+### Quirks Android
+
+* **formatted** : 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.
+
+* **familyName** : prise en charge. Stockée dans le champ **lastName** BlackBerry.
+
+* **givenName** : prise en charge. Stockée dans le champ **firstName** BlackBerry.
+
+* **middleName** : non pris en charge, retourne `null`.
+
+* **honorificPrefix** : non pris en charge, retourne `null`.
+
+* **honorificSuffix** : non pris en charge, retourne `null`.
+
+### Bizarreries de FirefoxOS
+
+* **au format**: partiellement pris en charge et en lecture seule. Retourne la concaténation de `honorificPrefix` , `givenName` , `middleName` , `familyName` , et`honorificSuffix`.
+
+### iOS Quirks
+
+* **formatted** : partiellement pris en charge. Retourne le nom composé iOS, mais est en lecture seule.
+
+## 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.
+
+### Propriétés
+
+* **pref** : fixé à `true` si `ContactOrganization` contient la valeur préférée de l'utilisateur. *(booléen)*
+
+* **type** : une chaîne qui indique le type de champ, *home* par exemple. _(DOMString)
+
+* **name** : le nom de l'organisation. *(DOMString)*
+
+* **department** : le département pour lequel travaille le contact. *(DOMString)*
+
+* **title** : titre du contact au sein de l'organisation. *(DOMString)*
+
+### Plates-formes prises en charge
+
+* Android
+* BlackBerry 10
+* 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 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);
+
+
+### Android 2.X Quirks
+
+* **pref** : non pris en charge par des appareils Android 2.X, retourne `false`.
+
+### BlackBerry 10 Quirks
+
+* **pref** : non pris en charge par les appareils BlackBerry, retourne `false`.
+
+* **type**: non pris en charge par les appareils BlackBerry, retourne `null`.
+
+* **name** : partiellement pris en charge. Le premier nom de l'entreprise est stocké dans le champ **company** de BlackBerry.
+
+* **department** : non pris en charge, retourne `null`.
+
+* **title** : partiellement pris en charge. Le premier titre de l'entreprise est stocké dans le champ de **jobTitle** BlackBerry.
+
+### Firefox OS Quirks
+
+* **pref**: non pris en charge
+
+* **type**: non pris en charge
+
+* **Département**: non pris en charge
+
+* Les champs **nom** et **titre** stocké dans **org** et **jobTitle**.
+
+### iOS Quirks
+
+* **pref**: non pris en charge sur les appareils iOS, retour`false`.
+
+* **type** : non pris en charge sur les appareils iOS, retourne `null`.
+
+* **name** : partiellement pris en charge. Le premier nom de l'entreprise 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.
+
+* **title** : partiellement pris en charge. Le premier titre est stocké dans le champ **kABPersonJobTitleProperty** iOS.
\ No newline at end of file
[09/13] Lisa testing pulling in plugins for plugin:
cordova-plugin-contacts
Posted by ld...@apache.org.
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/efb6b948/doc/ko/index.md
----------------------------------------------------------------------
diff --git a/doc/ko/index.md b/doc/ko/index.md
new file mode 100644
index 0000000..f2f410e
--- /dev/null
+++ b/doc/ko/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
+
+장치 연락처 데이터베이스에 대 한 액세스를 제공합니다.
+
+**경고**: 중요 한 개인 정보 보호 문제를 제기 하는 연락처 데이터의 수집 및 사용 합니다. 응용 프로그램의 개인 정보 보호 정책 응용 프로그램 연락처 데이터를 사용 하는 방법 및 다른 당사자와 함께 공유 하는 여부를 토론 해야 한다. 연락처 정보 누구와 통신 하는 사람이 사람들 보여 때문에 민감한으로 간주 됩니다. 따라서 애플 리 케이 션의 개인 정보 보호 정책 뿐만 아니라 강하게 해야 장치 운영 체제는 이렇게 이미 하지 않는 경우 응용 프로그램 액세스 또는 연락처 데이터를 사용 하기 전에 그냥--시간 통지를 제공 합니다. 그 통지는 (예를 들어, **확인** 및 **아니오**선택 제시) 하 여 사용자의 허가 취득 뿐만 아니라, 위에서 언급 된 동일한 정보를 제공 해야 합니다. Note 일부 애플 리 케이 션 장 터 그냥--시간 공지 및 연락처 데이터에 액세�
�� 하기 전에 사용자의 허가 받아야 응용 프로그램에 필요할 수 있습니다. 연락처 데이터는 사용자의 혼동을 방지할 수의 사용 및 연락처 데이터의 인식된 오용 명확 하 고 이해 하기 쉬운 사용자 경험. 자세한 내용은 개인 정보 보호 가이드를 참조 하십시오.
+
+## 설치
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+### 파이어 폭스 OS 단점
+
+[참고 문서][1]에 설명 된 대로 **www/manifest.webapp** 를 만듭니다. 관련 부여할 추가 합니다. [참고 문서][2]에 "권한"-webapp 유형을 변경 하려면 필요가 하다. **경고**: 모든 훌륭한 애플 리 케이 션 인라인 스크립트를 금지 하는 [콘텐츠 보안 정책][3] 을 적용 합니다. 다른 방법으로 응용 프로그램을 초기화 합니다.
+
+ [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"
+ }
+ }
+
+
+### 윈도우 8 단점
+
+윈도우 8 연락처는 읽기 전용입니다. 코르 도우 바 API 연락처를 통해 하지 쿼리/검색할 수 있습니다, 사용자 알려 '사람' 애플 리 케이 션을 열 것 이다 contacts.pickContact에 대 한 호출으로 연락처를 선택 하 여 사용자 연락처를 선택 해야 합니다. 반환 된 연락처는 읽기 전용 응용 프로그램을 수정할 수 없습니다.
+
+## navigator.contacts
+
+### 메서드
+
+* navigator.contacts.create
+* navigator.contacts.find
+* navigator.contacts.pickContact
+
+### 개체
+
+* 연락처
+* 담당자 이름
+* ContactField
+* ContactAddress
+* ContactOrganization
+* ContactFindOptions
+* ContactError
+* ContactFieldType
+
+## navigator.contacts.create
+
+`navigator.contacts.create`메서드는 동기적, 및 새로운 반환 합니다 `Contact` 개체.
+
+이 메서드를 호출 해야 장치 연락처 데이터베이스에 연락처 개체를 유지 하지 않습니다는 `Contact.save` 방법.
+
+### 지원 되는 플랫폼
+
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+
+### 예를 들어
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## navigator.contacts.find
+
+`navigator.contacts.find`장치 연락처 데이터베이스 쿼리 및의 배열을 반환 메서드가 비동기적으로 실행 될 `Contact` 개체. 결과 객체에 전달 되는 `contactSuccess` **contactSuccess** 매개 변수로 지정 된 콜백 함수.
+
+**ContactFields** 매개 변수는 검색 한정자로 사용할 필드를 지정 합니다. 길이가 0 인 **contactFields** 매개 변수 유효 하지 않습니다 및 결과 `ContactError.INVALID_ARGUMENT_ERROR` . **ContactFields** 값이 `"*"` 모든 연락처 필드를 반환 합니다.
+
+**ContactFindOptions.filter** 문자열 연락처 데이터베이스를 쿼리할 때 검색 필터로 사용할 수 있습니다. 제공 된, 대/소문자, 부분 값 일치 **contactFields** 매개 변수에 지정 된 각 필드에 적용 됩니다. *모든* 지정 된 필드의 일치 하는 경우 연락처 반환 됩니다. 사용 하 여 **contactFindOptions.desiredFields** 매개 변수 속성 문의 제어를 다시 반환 해야 합니다.
+
+### 매개 변수
+
+* **contactSuccess**: 연락처 개체의 배열에 표시 되는 성공 콜백 함수는 데이터베이스에서 반환 된. [필수]
+
+* **contactError**: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]
+
+* **contactFields**: 검색 한정자로 사용 하는 필드에 문의. *(DOMString[])* [필수]
+
+* **contactFindOptions**: navigator.contacts 필터링 옵션을 검색 합니다. [선택 사항] 키 다음과 같습니다.
+
+* **필터**: 검색 문자열 navigator.contacts를 찾는 데 사용 합니다. *(DOMString)* (기본:`""`)
+
+* **여러**: 여러 navigator.contacts 찾기 작업을 반환 합니다 경우 결정 합니다. *(부울)* (기본:`false`)
+
+ * **desiredFields**: 연락처 필드를 다시 반환 합니다. 그 결과 지정 된 경우 `Contact` 만이 필드의 값을 보유 하는 개체. *(DOMString[])* [선택 사항]
+
+### 지원 되는 플랫폼
+
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+
+### 예를 들어
+
+ 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
+
+`navigator.contacts.pickContact`메서드가 단일 연락처 선택 문의 선택 시작. 결과 개체에 전달 되는 `contactSuccess` **contactSuccess** 매개 변수로 지정 된 콜백 함수.
+
+### 매개 변수
+
+* **contactSuccess**: 단일 연락처 개체와 호출 되는 성공 콜백 함수. [필수]
+
+* **contactError**: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]
+
+### 지원 되는 플랫폼
+
+* 안 드 로이드
+* iOS
+* Windows Phone 8
+* 윈도우 8
+
+### 예를 들어
+
+ navigator.contacts.pickContact(function(contact){
+ console.log('The following contact has been selected:' + JSON.stringify(contact));
+ },function(err){
+ console.log('Error: ' + err);
+ });
+
+
+## 연락처
+
+`Contact`개체는 사용자의 연락처를 나타냅니다. 연락처 생성 수, 저장 또는 장치 연락처 데이터베이스에서 제거 합니다. 연락처도 검색할 수 있습니다 (개별적으로 또는 일괄적으로) 데이터베이스에서 호출 하 여는 `navigator.contacts.find` 방법.
+
+**참고**: 모든 연락처 필드 위에 나열 된 모든 장치 플랫폼에서 지원 됩니다. 자세한 내용은 각 플랫폼의 *단점이* 섹션을 확인 하시기 바랍니다.
+
+### 속성
+
+* **id**: 글로벌 고유 식별자. *(DOMString)*
+
+* **displayName**: 최종 사용자에 게 표시에 적합이 연락처의 이름. *(DOMString)*
+
+* **이름**: 사람 이름의 모든 구성 요소를 포함 하는 개체. *(담당자 이름)*
+
+* **별명**: 캐주얼 이름 연락처 주소입니다. *(DOMString)*
+
+* **phoneNumbers**: 모든 연락처의 전화 번호의 배열. *(ContactField[])*
+
+* **이메일**: 모든 연락처의 전자 메일 주소의 배열. *(ContactField[])*
+
+* **주소**: 모든 연락처의 주소 배열. *(ContactAddress[])*
+
+* **ims**: 모든 연락처의 IM 주소 배열. *(ContactField[])*
+
+* **조직**: 다양 한 모든 연락처의 조직. *(ContactOrganization[])*
+
+* **생일**: 연락처의 생일. *(날짜)*
+
+* **참고**: 연락처에 대 한 참고. *(DOMString)*
+
+* **사진**: 연락처의 사진을 배열. *(ContactField[])*
+
+* **카테고리**: 모든 사용자 정의 범주 연락처에 연결 된 배열. *(ContactField[])*
+
+* **url**: 연락처에 연결 된 웹 페이지의 배열. *(ContactField[])*
+
+### 메서드
+
+* **복제**: 새로운 반환 합니다 `Contact` 으로 호출 하는 개체의 전체 복사본은 개체는 `id` 속성으로 설정`null`.
+
+* **제거**: 장치 연락처 데이터베이스에서 연락처를 제거 합니다, 그렇지 않으면와 오류 콜백을 실행 한 `ContactError` 개체.
+
+* **저장**: 장치 연락처 데이터베이스를 새 연락처를 저장 또는 동일한 **id** 를 가진 연락처가 이미 있는 경우 기존 연락처를 업데이트 합니다.
+
+### 지원 되는 플랫폼
+
+* 아마존 화재 운영 체제
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+* 윈도우 8
+
+### 예를 들어 저장
+
+ 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);
+
+
+### 복제 예제
+
+ // 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);
+
+
+### 예제 제거
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### 안 드 로이드 2.X 단점
+
+* **카테고리**: 안 드 로이드 2.X 장치, 반환에서 지원 되지 않습니다`null`.
+
+### 블랙베리 10 단점
+
+* **id**: 연락처를 저장 하면 장치에 할당 합니다.
+
+### FirefoxOS 특수
+
+* **카테고리**: 부분적으로 지원 합니다. 필드 **pref** 및 **형식** 반환`null`
+
+* **ims**: 지원 되지 않음
+
+* **사진**: 지원 되지 않음
+
+### iOS 단점
+
+* **displayName**: 반환 iOS에서 지원 되지 않는 `null` 가 아무 `ContactName` 지정 된,이 경우 복합 이름, **닉네임** 을 반환 합니다 또는 `""` , 각각.
+
+* **생일**: 자바 스크립트로 입력 해야 합니다 `Date` 개체를 같은 방식으로 반환 됩니다.
+
+* **사진**: 응용 프로그램의 임시 디렉터리에 저장 된 이미지 파일 URL을 반환 합니다. 응용 프로그램이 종료 될 때 임시 디렉터리의 내용은 제거 됩니다.
+
+* **카테고리**:이 속성은 현재 지원 되지 않습니다, 반환`null`.
+
+### Windows Phone 7, 8 특수
+
+* **displayName**: 연락처를 만들 때 표시 이름에서 표시 이름 매개 변수 다릅니다 제공 값 검색 연락처를 찾을 때.
+
+* **url**: 연락처를 만들 때 사용자가 입력을 하나 이상의 웹 주소를 저장 하지만 하나만 사용할 수 있는 연락처를 검색할 때.
+
+* **phoneNumbers**: *pref* 옵션이 지원 되지 않습니다. *형식* *찾기* 작업에서 지원 되지 않습니다. 단 하나 `phoneNumber` 각 *형식* 에 대 한 허용.
+
+* **이메일**: *pref* 옵션이 지원 되지 않습니다. 가정 및 개인 동일한 이메일 항목 참조. 각 *형식* 에 대 한 항목이 하나만 허용.
+
+* **주소**: 직장, 및 가정/개인 *유형*을 지원 합니다. 가정 및 개인 *유형* 동일한 주소 항목 참조. 각 *형식* 에 대 한 항목이 하나만 허용.
+
+* **조직**: 하나만 허용 되 고 *pref*, *유형*및 *부서* 특성을 지원 하지 않습니다.
+
+* **참고**: 지원 되지 않는 반환`null`.
+
+* **ims**: 지원 되지 않는 반환`null`.
+
+* **생일**: 지원 되지 않는 반환`null`.
+
+* **카테고리**: 지원 되지 않는 반환`null`.
+
+## ContactAddress
+
+`ContactAddress`개체는 연락처의 단일 주소 속성을 저장 합니다. A `Contact` 개체에 하나 이상의 주소가 포함 될 수 있습니다는 `ContactAddress[]` 배열.
+
+### 속성
+
+* **pref**: 설정 `true` 이 경우 `ContactAddress` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+* **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열. *(DOMString)*
+
+* **포맷**: 전체 주소 표시를 위해 서식이 지정 된. *(DOMString)*
+
+* **streetAddress**: 전체 주소. *(DOMString)*
+
+* **지역**: 구, 군 또는 도시. *(DOMString)*
+
+* **지역**: 상태 또는 지역. *(DOMString)*
+
+* **postalCode**: 우편 번호 또는 우편 번호. *(DOMString)*
+
+* **국가**: 국가 이름. *(DOMString)*
+
+### 지원 되는 플랫폼
+
+* 아마존 화재 운영 체제
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+* 윈도우 8
+
+### 예를 들어
+
+ // 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);
+
+
+### 안 드 로이드 2.X 단점
+
+* **pref**: 지원 되지 않는 반환 `false` 안 드 로이드 2.X 장치에.
+
+### 블랙베리 10 단점
+
+* **pref**: 반환 BlackBerry 장치에서 지원 되지 않습니다`false`.
+
+* **유형**: 부분적으로 지원 합니다. *작업* 및 *홈* 형식 주소 각 단 하나 접촉 당 저장할 수 있습니다.
+
+* **포맷**: 부분적으로 지원 합니다. 모든 검은 딸기 주소 필드의 연결을 반환합니다.
+
+* **streetAddress**: 지원. 블랙베리 **address1** **주소 2** 의 연결 주소 필드를 반환합니다.
+
+* **지역**: 지원. 블랙베리 **시** 주소 필드에 저장 합니다.
+
+* **지역**: 지원. 블랙베리 **stateProvince** 주소 필드에 저장 합니다.
+
+* **postalCode**: 지원. 블랙베리 **zipPostal** 주소 필드에 저장 합니다.
+
+* **국가**: 지원.
+
+### FirefoxOS 특수
+
+* **포맷**: 현재 지원 되지 않습니다
+
+### iOS 단점
+
+* **pref**: 반환 하는 iOS 장치에서 지원 되지 않습니다`false`.
+
+* **포맷**: 현재 지원 되지 않습니다.
+
+### 윈도우 8 단점
+
+* **pref**: 지원 되지 않음
+
+## ContactError
+
+`ContactError`개체를 통해 사용자에 게 반환 되는 `contactError` 콜백 함수는 오류가 발생 한 경우.
+
+### 속성
+
+* **코드**: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된.
+
+### 상수
+
+* `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
+
+`ContactField`개체는 재사용 가능한 구성 요소를 나타내는 필드를 일반적으로 문의. 각 `ContactField` 개체에 포함 되어 있는 `value` , `type` , 및 `pref` 속성. A `Contact` 개체에 여러 속성이 저장 `ContactField[]` 배열, 전화 번호 및 이메일 주소.
+
+대부분의 경우에는 미리 결정 된 값에 대 한는 `ContactField` 개체의 **type** 속성. 예를 들어 전화 번호 *홈*, *작품*, *모바일*, *아이폰*또는 특정 장치 플랫폼의 연락처 데이터베이스에서 지원 되는 다른 값의 **유형** 값을 지정할 수 있습니다. 그러나는 `Contact` **사진** 필드 **유형** 필드 나타냅니다 반환 된 이미지 형식: **url** **값** 특성 **값** 이미지 base64 인코딩된 문자열을 포함 하는 경우 사진 이미지 또는 *base64* URL이 포함 된 경우.
+
+### 속성
+
+* **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열입니다. *(DOMString)*
+
+* **값**: 전화 번호 또는 이메일 주소와 같은 필드 값. *(DOMString)*
+
+* **pref**: 설정 `true` 이 경우 `ContactField` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+### 지원 되는 플랫폼
+
+* 아마존 화재 운영 체제
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+* 윈도우 8
+
+### 예를 들어
+
+ // 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();
+
+
+### 안 드 로이드 단점
+
+* **pref**: 지원 되지 않는 반환`false`.
+
+### 블랙베리 10 단점
+
+* **유형**: 부분적으로 지원 합니다. 전화 번호에 대 한 사용.
+
+* **값**: 지원.
+
+* **pref**: 지원 되지 않는 반환`false`.
+
+### iOS 단점
+
+* **pref**: 지원 되지 않는 반환`false`.
+
+### Windows8 단점
+
+* **pref**: 지원 되지 않는 반환`false`.
+
+## 담당자 이름
+
+에 대 한 다양 한 정보를 포함 한 `Contact` 개체의 이름.
+
+### 속성
+
+* **포맷**: 연락처의 전체 이름. *(DOMString)*
+
+* **familyName**: 연락처의 성. *(DOMString)*
+
+* **givenName**: 연락처의 이름. *(DOMString)*
+
+* **middleName**: 연락처의 중간 이름을. *(DOMString)*
+
+* **honorificPrefix**: 연락처의 접두사 (예: *미스터* 또는 *닥터*) *(DOMString)*
+
+* **honorificSuffix**: 연락처의 접미사 ( *esq.*예). *(DOMString)*
+
+### 지원 되는 플랫폼
+
+* 아마존 화재 운영 체제
+* 안 드 로이드 2.X
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+* 윈도우 8
+
+### 예를 들어
+
+ 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);
+
+
+### 안 드 로이드 단점
+
+* **포맷**: 부분적으로 지원 되 고 읽기 전용. 연결을 반환 합니다 `honorificPrefix` , `givenName` , `middleName` , `familyName` , 그리고`honorificSuffix`.
+
+### 블랙베리 10 단점
+
+* **포맷**: 부분적으로 지원 합니다. 블랙베리 **firstName** 및 **lastName** 필드의 연결을 반환합니다.
+
+* **familyName**: 지원. 블랙베리 **lastName** 필드에 저장 합니다.
+
+* **givenName**: 지원. 블랙베리 **firstName** 필드에 저장 합니다.
+
+* **middleName**: 지원 되지 않는 반환`null`.
+
+* **honorificPrefix**: 지원 되지 않는 반환`null`.
+
+* **honorificSuffix**: 지원 되지 않는 반환`null`.
+
+### FirefoxOS 특수
+
+* **포맷**: 부분적으로 지원 되 고 읽기 전용. 연결을 반환 합니다 `honorificPrefix` , `givenName` , `middleName` , `familyName` , 그리고`honorificSuffix`.
+
+### iOS 단점
+
+* **포맷**: 부분적으로 지원 합니다. IOS 복합 이름 반환 하지만 읽기 전용입니다.
+
+### 윈도우 8 단점
+
+* **형식**: 이것은 유일한 속성 이름과 동일 하다 `displayName` , 및`nickname`
+
+* **familyName**: 지원 되지 않음
+
+* **givenName**: 지원 되지 않음
+
+* **middleName**: 지원 되지 않음
+
+* **honorificPrefix**: 지원 되지 않음
+
+* **honorificSuffix**: 지원 되지 않음
+
+## ContactOrganization
+
+`ContactOrganization`개체를 연락처의 조직 속성을 저장 합니다. A `Contact` 개체 저장 하나 이상의 `ContactOrganization` 개체 배열에.
+
+### 속성
+
+* **pref**: 설정 `true` 이 경우 `ContactOrganization` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+* **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열입니다. _(DOMString)
+
+* **이름**: 조직 이름. *(DOMString)*
+
+* **부서**: 계약을 위해 일 하는 부서. *(DOMString)*
+
+* **제목**: 조직에서 연락처의 제목. *(DOMString)*
+
+### 지원 되는 플랫폼
+
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+
+### 예를 들어
+
+ 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);
+
+
+### 안 드 로이드 2.X 단점
+
+* **pref**: 반환 안 드 로이드 2.X 장치에 의해 지원 되지 않습니다`false`.
+
+### 블랙베리 10 단점
+
+* **pref**: 반환 블랙베리 장치에 의해 지원 되지 않습니다`false`.
+
+* **유형**: 반환 블랙베리 장치에 의해 지원 되지 않습니다`null`.
+
+* **이름**: 부분적으로 지원 합니다. 첫 번째 조직 이름 블랙베리 **회사** 필드에 저장 됩니다.
+
+* **부서**: 지원 되지 않는 반환`null`.
+
+* **제목**: 부분적으로 지원 합니다. 첫 번째 조직 제목 블랙베리 **jobTitle** 필드에 저장 됩니다.
+
+### 파이어 폭스 OS 단점
+
+* **pref**: 지원 되지 않음
+
+* **형식**: 지원 되지 않음
+
+* **부서**: 지원 되지 않음
+
+* 필드 **이름** 및 **제목** **org** 및 **jobTitle** 에 저장.
+
+### iOS 단점
+
+* **pref**: 반환 하는 iOS 장치에서 지원 되지 않습니다`false`.
+
+* **유형**: 반환 하는 iOS 장치에서 지원 되지 않습니다`null`.
+
+* **이름**: 부분적으로 지원 합니다. 첫 번째 조직 이름은 iOS **kABPersonOrganizationProperty** 필드에 저장 됩니다.
+
+* **부서**: 부분적으로 지원 합니다. 첫 번째 부서 이름은 iOS **kABPersonDepartmentProperty** 필드에 저장 됩니다.
+
+* **제목**: 부분적으로 지원 합니다. 첫 번째 타이틀 iOS **kABPersonJobTitleProperty** 필드에 저장 됩니다.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/efb6b948/doc/pl/index.md
----------------------------------------------------------------------
diff --git a/doc/pl/index.md b/doc/pl/index.md
new file mode 100644
index 0000000..529de86
--- /dev/null
+++ b/doc/pl/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
+
+Zapewnia dostęp do bazy danych kontaktów urządzenia.
+
+**Ostrzeżenie**: zbierania i wykorzystywania danych kontaktowych podnosi kwestie prywatności ważne. Polityka prywatności danej aplikacji należy Dyskutować, jak aplikacja używa danych kontaktowych i czy jest on dzielony z innymi stronami. Informacje kontaktowe uznaje wrażliwych, ponieważ ukazuje ludzi, z którymi osoba komunikuje się. W związku z tym oprócz aplikacji prywatności, zdecydowanie zaleca się zapewnienie just-in czas wypowiedzenia zanim aplikacja uzyskuje dostęp do lub używa danych kontaktowych, jeśli system operacyjny urządzenia nie robi już. Że ogłoszenie powinno zawierać te same informacje, o których wspomniano powyżej, jak również uzyskanie uprawnienia użytkownika (np. poprzez przedstawianie wyborów **OK** i **Nie dzięki**). Należy pamiętać, że niektóre platformy aplikacji może wymagać aplikacji powiadomienia just-in czas i uzyskać uprawnienia użytkownika przed uzyskaniem dostępu do danych kontaktowych. Jasne i łatwe do zrozumien
ia użytkownika doświadczenie, wykorzystanie kontaktów danych pomaga uniknąć nieporozumień użytkownik i postrzegane nadużycia danych kontaktowych. Aby uzyskać więcej informacji zobacz przewodnik prywatności.
+
+## Instalacji
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+### Firefox OS dziwactwa
+
+Tworzenie **www/manifest.webapp** , jak opisano w [Dokumentach Manifest][1]. Dodaj odpowiednie permisions. Istnieje również potrzeba zmienić typ webapp do "uprzywilejowanych" - [Manifest dokumenty][2]. **Ostrzeżenie**: wszystkie uprzywilejowany apps egzekwowania [Treści polityki bezpieczeństwa][3] , który zabrania skrypt. Zainicjować aplikacji w inny sposób.
+
+ [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"
+ }
+ }
+
+
+### Windows 8 dziwactwa
+
+Windows 8 kontaktów są tylko do odczytu. Poprzez kontakty Cordova API są nie queryable/wyszukiwania, należy poinformować użytkownika wybrać kontakt jako wezwanie do contacts.pickContact, która zostanie otwarta aplikacja 'Ludzie', gdzie użytkownik musi wybrać kontakt. Wszelkie kontakty, zwracane są tylko do odczytu, więc aplikacja nie mogą ich modyfikować.
+
+## Navigator.Contacts
+
+### Metody
+
+* navigator.contacts.create
+* navigator.contacts.find
+* navigator.contacts.pickContact
+
+### Obiekty
+
+* Kontakt
+* Przedstawiciel
+* ContactField
+* ContactAddress
+* ContactOrganization
+* ContactFindOptions
+* ContactError
+* ContactFieldType
+
+## Navigator.Contacts.Create
+
+`navigator.contacts.create`Metoda jest synchroniczna i zwraca nową `Contact` obiektu.
+
+Ta metoda nie zachowuje kontakt obiektu bazy danych kontaktów urządzenie, dla którego musisz wywołać `Contact.save` Metoda.
+
+### Obsługiwane platformy
+
+* Android
+* Jeżyna 10
+* Firefox OS
+* iOS
+* Windows Phone 7 i 8
+
+### Przykład
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## navigator.contacts.find
+
+`navigator.contacts.find`Metoda asynchronicznie, wykonuje kwerendy bazy danych kontaktów urządzenia i tablicę z `Contact` obiektów. Wynikowe obiekty są przekazywane do `contactSuccess` funkcji wywołania zwrotnego, określony przez parametr **contactSuccess** .
+
+Parametr **contactFields** określa pola, które mają być używane jako kwalifikator Szukaj. Zerowej długości **contactFields** parametr jest nieprawidłowy i wyniki w `ContactError.INVALID_ARGUMENT_ERROR` . **ContactFields** wartość `"*"` zwraca wszystkich pól.
+
+Ciąg **contactFindOptions.filter** może służyć jako filtr wyszukiwania, gdy kwerenda bazy danych kontaktów. Jeśli dostarczone, przypadek-niewrażliwe, częściowej wartości mecz jest stosowane do każdego pola określony w parametrze **contactFields** . Jeśli ma odpowiednika dla *każdego* pola określony, zwracany jest kontakt. Użycie **contactFindOptions.desiredFields** parametr do kontroli, które kontakt właściwości muszą zostać zwrócone ponownie.
+
+### Parametry
+
+* **contactSuccess**: sukcesu funkcji wywołania zwrotnego, wywoływane z tablicy obiektów kontaktów zwracane z bazy danych. [Wymagane]
+
+* **contactError**: Błąd funkcji wywołania zwrotnego, wywoływana, gdy wystąpi błąd. [Opcjonalnie]
+
+* **contactFields**: kontakt z pól do wykorzystania jako kwalifikator Szukaj. *(DOMString[])* [Wymagane]
+
+* **contactFindOptions**: Szukaj opcji filtrowania navigator.contacts. [Opcjonalnie] Klucze obejmuje:
+
+* **Filtr**: ciąg wyszukiwania umożliwia znalezienie navigator.contacts. *(DOMString)* (Domyślnie:`""`)
+
+* **wiele**: określa, czy operacja Znajdź zwraca wiele navigator.contacts. *(Wartość logiczna)* (Domyślnie:`false`)
+
+ * **desiredFields**: kontakt z pola, aby być zwrócona. Jeśli określony, wynikającego z `Contact` Obiekt dysponuje tylko wartości tych pól. *(DOMString[])* [Opcjonalnie]
+
+### Obsługiwane platformy
+
+* Android
+* Jeżyna 10
+* Firefox OS
+* iOS
+* Windows Phone 7 i 8
+
+### Przykład
+
+ 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
+
+`navigator.contacts.pickContact`Metoda uruchamia próbnika kontakt, wybierz jeden kontaktem. Wynikowy obiekt jest przekazywany do `contactSuccess` funkcji wywołania zwrotnego, określony przez parametr **contactSuccess** .
+
+### Parametry
+
+* **contactSuccess**: sukcesu funkcji wywołania zwrotnego, wywoływane z jednego obiektu kontakt. [Wymagane]
+
+* **contactError**: Błąd funkcji wywołania zwrotnego, wywoływana, gdy wystąpi błąd. [Opcjonalnie]
+
+### Obsługiwane platformy
+
+* Android
+* iOS
+* Windows Phone 8
+* Windows 8
+
+### Przykład
+
+ navigator.contacts.pickContact(function(contact){
+ console.log('The following contact has been selected:' + JSON.stringify(contact));
+ },function(err){
+ console.log('Error: ' + err);
+ });
+
+
+## Kontakt
+
+`Contact`Obiekt reprezentuje informacje kontaktowe. Kontakty mogą być tworzone, przechowywane lub usunięte z bazy danych kontaktów urządzenia. Kontakty można również pobrać (pojedynczo lub zbiorczo) bazy danych przez `navigator.contacts.find` Metoda.
+
+**Uwaga**: nie wszystkie pola kontaktowe wymienione powyżej są obsługiwane na każdej platformie urządzenia. Proszę sprawdzić każdej platformy *dziwactw* sekcji szczegółów.
+
+### Właściwości
+
+* **Identyfikator**: unikatowy identyfikator globalny. *(DOMString)*
+
+* **displayName**: Nazwa tego kontaktu, nadaje się do wyświetlania użytkownikom końcowym. *(DOMString)*
+
+* **Nazwa**: obiekt zawierający wszystkie składniki nazwy osób. *(Przedstawiciel)*
+
+* **nick**: dorywczo nazwy na adres kontakt. *(DOMString)*
+
+* **numery telefon≤w**: tablica numerów telefonów kontaktowych. *(ContactField[])*
+
+* **e-maile**: tablica adresów e-mail kontakt. *(ContactField[])*
+
+* **adresy**: tablica wszystkie adresy. *(ContactAddress[])*
+
+* **IMS**: tablica kontakt IM adresy. *(ContactField[])*
+
+* **organizacje**: tablicy wszystkie kontakty organizacji. *(ContactOrganization[])*
+
+* **urodziny**: urodziny kontakt. *(Data)*
+
+* **Uwaga**: Uwaga o kontakt. *(DOMString)*
+
+* **zdjęcia**: tablica zdjęcia kontaktu. *(ContactField[])*
+
+* **Kategorie**: tablica wszystkie zdefiniowane przez użytkownika kategorie związane z kontaktem. *(ContactField[])*
+
+* **adresy URL**: tablicy stron internetowych związanych z kontaktem. *(ContactField[])*
+
+### Metody
+
+* **klon**: Zwraca nowy `Contact` obiekt, który jest kopią głęboko obiektu wywołującego, z `id` Właściwość zestaw`null`.
+
+* **Usuń**: usuwa kontakt z bazy danych kontaktów urządzenia, w przeciwnym razie wykonuje błąd wywołania zwrotnego z `ContactError` obiektu.
+
+* **Zapisz**: zapisuje nowy kontakt do bazy kontaktów urządzenia, lub aktualizacje już istniejący kontakt, jeśli istnieje już kontakt o tym samym **identyfikatorze** .
+
+### Obsługiwane platformy
+
+* Amazon ogień OS
+* Android
+* Jeżyna 10
+* Firefox OS
+* iOS
+* Windows Phone 7 i 8
+* Windows 8
+
+### Zapisz przykład
+
+ 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);
+
+
+### Przykład klon
+
+ // 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);
+
+
+### Remove przykład
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### Android 2.X dziwactwa
+
+* **Kategorie**: nie obsługiwane na urządzeniach Android 2.X, powrót`null`.
+
+### Jeżyna 10 dziwactwa
+
+* **Identyfikator**: przypisany przez urządzenie podczas zapisywania kontaktu.
+
+### Osobliwości FirefoxOS
+
+* **Kategorie**: częściowo obsługiwane. Pola **pref** i **Typ** wracają`null`
+
+* **IMS**: nie obsługiwane
+
+* **zdjęcia**: nie obsługiwane
+
+### iOS dziwactwa
+
+* **displayName**: nie obsługiwane na iOS, powrót `null` chyba jest nie `ContactName` określony, w którym to przypadku zwraca nazwę kompozytowe, **nick** lub `""` , odpowiednio.
+
+* **urodziny**: należy wpisać jako JavaScript `Date` obiektu, tak samo jest zwracany.
+
+* **zdjęcia**: zwraca adres URL pliku obrazu, który jest przechowywany w katalogu tymczasowego stosowania. Zawartość katalogu tymczasowe są usuwane, kiedy kończy pracę aplikacji.
+
+* **Kategorie**: Ta właściwość obecnie jest nie obsługiwane, powrót`null`.
+
+### Windows Phone 7 i 8 dziwactwa
+
+* **displayName**: podczas tworzenia kontaktu, Źródło wartość podana dla parametru nazwy wyświetlania różni się od nazwy wyświetlanej, gdy znalezienie kontaktu.
+
+* **adresy URL**: podczas tworzenia kontaktu, użytkownicy mogą wpisać i zapisać więcej niż jeden adres sieci web, ale tylko jeden jest dostępne podczas wyszukiwania kontaktów.
+
+* **numery telefon≤w**: *pref* opcja nie jest obsługiwana. *Typ* nie jest obsługiwany w operacji *znaleźć* . Jedynym `phoneNumber` jest dozwolone dla każdego *typu*.
+
+* **e-maile**: *pref* opcja nie jest obsługiwana. Domu i osobiste odwołuje się w tym samym wpisu email. Dla każdego *typu* dozwolone jest tylko jeden wpis.
+
+* **adresy**: obsługuje tylko pracy i domu/osobisty *typu*. Domowych i osobistych *typu* odwołania tej samej pozycji adres. Dla każdego *typu* dozwolone jest tylko jeden wpis.
+
+* **organizacje**: tylko jeden jest dozwolone, a nie obsługuje * *pref*, *Typ*i* atrybuty.
+
+* **Uwaga**: nie obsługiwane, powrót`null`.
+
+* **IMS**: nie obsługiwane, powrót`null`.
+
+* **urodziny**: nie obsługiwane, powrót`null`.
+
+* **Kategorie**: nie obsługiwane, powrót`null`.
+
+## ContactAddress
+
+`ContactAddress`Obiektu przechowuje właściwości pojedynczego adresu kontaktu. A `Contact` obiektu może zawierać więcej niż jeden adres w `ContactAddress[]` tablicy.
+
+### Właściwości
+
+* **Pref**: zestaw `true` Jeśli `ContactAddress` zawiera wartości preferowanych użytkownika. *(wartość logiczna)*
+
+* **Typ**: string wskazującą typ pola, *do domu* na przykład. *(DOMString)*
+
+* **w formacie**: pełny adres w formacie wyświetlania. *(DOMString)*
+
+* **adres**: pełny adres. *(DOMString)*
+
+* **miejscowości**: miasta lub miejscowości. *(DOMString)*
+
+* **region**: Państwo lub region. *(DOMString)*
+
+* **Kod pocztowy**: kod pocztowy lub kod pocztowy. *(DOMString)*
+
+* **kraj**: nazwę kraju. *(DOMString)*
+
+### Obsługiwane platformy
+
+* Amazon ogień OS
+* Android
+* Jeżyna 10
+* Firefox OS
+* iOS
+* Windows Phone 7 i 8
+* Windows 8
+
+### Przykład
+
+ // 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);
+
+
+### Android 2.X dziwactwa
+
+* **Pref**: nie obsługiwane, powrót `false` na urządzeniach Android 2.X.
+
+### Jeżyna 10 dziwactwa
+
+* **Pref**: nie obsługiwane na urządzenia BlackBerry, powrót`false`.
+
+* **Typ**: częściowo obsługiwane. Tylko jeden z *pracy* i *Strona główna* wpisz adresy mogą być przechowywane na kontakt.
+
+* **w formacie**: częściowo obsługiwane. Zwraca łączenie wszystkich pól adres BlackBerry.
+
+* **adres**: obsługiwane. Zwraca łączenie BlackBerry **address1** i **Adres2** pola adresu.
+
+* **miejscowości**: obsługiwane. Przechowywane w polu adres **miasto** BlackBerry.
+
+* **region**: obsługiwane. Przechowywane w polu adres **stateProvince** BlackBerry.
+
+* **Kod pocztowy**: obsługiwane. Przechowywane w polu adres **zipPostal** BlackBerry.
+
+* **kraj**: obsługiwane.
+
+### Osobliwości FirefoxOS
+
+* **w formacie**: aktualnie nieobsługiwane
+
+### iOS dziwactwa
+
+* **Pref**: nie obsługiwane urządzenia iOS, powrót`false`.
+
+* **w formacie**: obecnie nie jest obsługiwane.
+
+### Windows 8 dziwactwa
+
+* **Pref**: nie obsługiwane
+
+## ContactError
+
+`ContactError`Zwracany jest obiekt użytkownika za pomocą `contactError` funkcji wywołania zwrotnego, gdy wystąpi błąd.
+
+### Właściwości
+
+* **Kod**: jeden z kodów błędów wstępnie zdefiniowanych poniżej.
+
+### Stałe
+
+* `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
+
+`ContactField`Obiekt jest składnikiem wielokrotnego użytku, że reprezentuje kontakt pola ogólnie. Każdy `ContactField` zawiera obiekt `value` , `type` , a `pref` Właściwość. A `Contact` obiektu przechowuje wiele właściwości w `ContactField[]` tablice, takie jak numery telefonu, adres e-mail.
+
+W większości przypadków, są nie wcześniej ustalonych wartości dla `ContactField` atrybut **typu** obiektu. Na przykład numer telefonu można określić **Typ** wartości *domu*, *pracy*, *mobile*, *iPhone*, lub jakąkolwiek inną wartość, który jest obsługiwany przez platformę danego urządzenia bazy danych kontaktów. Jednak dla `Contact` **zdjęcia** pola, pole **Typ** wskazuje format zwrócone obrazu: **url** **wartość** atrybut zawiera adres URL do zdjęć lub *base64* , gdy **wartość** zawiera ciąg base64 zakodowany obraz.
+
+### Właściwości
+
+* **Typ**: ciąg, który wskazuje typ pola, *do domu* , np. *(DOMString)*
+
+* **wartości**: wartość pola, na przykład adresu e-mail lub numer telefonu. *(DOMString)*
+
+* **Pref**: zestaw `true` Jeśli `ContactField` zawiera wartości preferowanych użytkownika. *(wartość logiczna)*
+
+### Obsługiwane platformy
+
+* Amazon ogień OS
+* Android
+* Jeżyna 10
+* Firefox OS
+* iOS
+* Windows Phone 7 i 8
+* Windows 8
+
+### Przykład
+
+ // 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();
+
+
+### Android dziwactwa
+
+* **Pref**: nie obsługiwane, powrót`false`.
+
+### Jeżyna 10 dziwactwa
+
+* **Typ**: częściowo obsługiwane. Używane numery telefonów.
+
+* **wartość**: obsługiwane.
+
+* **Pref**: nie obsługiwane, powrót`false`.
+
+### iOS dziwactwa
+
+* **Pref**: nie obsługiwane, powrót`false`.
+
+### Osobliwości Windows8
+
+* **Pref**: nie obsługiwane, powrót`false`.
+
+## Przedstawiciel
+
+Zawiera różne rodzaje informacji o `Contact` Nazwa obiektu.
+
+### Właściwości
+
+* **w formacie**: pełną nazwę kontaktu. *(DOMString)*
+
+* **danych**: nazwisko kontaktu. *(DOMString)*
+
+* **imię**: imię kontaktu. *(DOMString)*
+
+* **middleName**: nazwy bliskiego kontaktu. *(DOMString)*
+
+* **honorificPrefix**: kontakt prefiks (przykład *Pan* lub *Dr*) *(DOMString)*
+
+* **honorificSuffix**: kontakt sufiks (przykład *Esq.*). *(DOMString)*
+
+### Obsługiwane platformy
+
+* Amazon ogień OS
+* Android 2.X
+* Jeżyna 10
+* Firefox OS
+* iOS
+* Windows Phone 7 i 8
+* Windows 8
+
+### Przykład
+
+ 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);
+
+
+### Android dziwactwa
+
+* **w formacie**: częściowo obsługiwane i tylko do odczytu. Zwraca składa się z `honorificPrefix` , `givenName` , `middleName` , `familyName` , i`honorificSuffix`.
+
+### Jeżyna 10 dziwactwa
+
+* **w formacie**: częściowo obsługiwane. Zwraca łączenie pól **imię** i **nazwisko** BlackBerry.
+
+* **danych**: obsługiwane. Przechowywane w BlackBerry pola **nazwisko** .
+
+* **imię**: obsługiwane. Przechowywane w polu **imię** BlackBerry.
+
+* **middleName**: nie obsługiwane, powrót`null`.
+
+* **honorificPrefix**: nie obsługiwane, powrót`null`.
+
+* **honorificSuffix**: nie obsługiwane, powrót`null`.
+
+### Osobliwości FirefoxOS
+
+* **w formacie**: częściowo obsługiwane i tylko do odczytu. Zwraca składa się z `honorificPrefix` , `givenName` , `middleName` , `familyName` , i`honorificSuffix`.
+
+### iOS dziwactwa
+
+* **w formacie**: częściowo obsługiwane. Zwraca iOS nazwy, ale jest tylko do odczytu.
+
+### Windows 8 dziwactwa
+
+* **w formacie**: to jest tylko nazwa właściwość i jest taka sama, jak `displayName` , i`nickname`
+
+* **danych**: nie obsługiwane
+
+* **imię**: nie obsługiwane
+
+* **middleName**: nie obsługiwane
+
+* **honorificPrefix**: nie obsługiwane
+
+* **honorificSuffix**: nie obsługiwane
+
+## ContactOrganization
+
+`ContactOrganization`Obiektu przechowuje właściwości organizacji kontaktu. A `Contact` obiektu przechowuje jeden lub więcej `ContactOrganization` obiekty w tablicy.
+
+### Właściwości
+
+* **Pref**: zestaw `true` Jeśli `ContactOrganization` zawiera wartości preferowanych użytkownika. *(wartość logiczna)*
+
+* **Typ**: ciąg, który wskazuje typ pola, *do domu* , np. _(DOMString)
+
+* **Nazwa**: nazwa organizacji. *(DOMString)*
+
+* **w departamencie**: dziale umowy działa. *(DOMString)*
+
+* **tytuł**: tytuł kontaktu w organizacji. *(DOMString)*
+
+### Obsługiwane platformy
+
+* Android
+* Jeżyna 10
+* Firefox OS
+* iOS
+* Windows Phone 7 i 8
+
+### Przykład
+
+ 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);
+
+
+### Android 2.X dziwactwa
+
+* **Pref**: nie obsługiwane przez urządzenia Android 2.X, powrót`false`.
+
+### Jeżyna 10 dziwactwa
+
+* **Pref**: nie obsługiwane przez urządzenia BlackBerry, powrót`false`.
+
+* **Typ**: nie obsługiwane przez urządzenia BlackBerry, powrót`null`.
+
+* **Nazwa**: częściowo obsługiwane. Pierwsza nazwa organizacji są przechowywane w polu **firma** BlackBerry.
+
+* **w departamencie**: nie obsługiwane, powrót`null`.
+
+* **tytuł**: częściowo obsługiwane. Pierwszy tytuł organizacji są przechowywane w polu **jobTitle** BlackBerry.
+
+### Firefox OS dziwactwa
+
+* **Pref**: nie obsługiwane
+
+* **Typ**: nie obsługiwane
+
+* **w departamencie**: nie obsługiwane
+
+* Pola **Nazwa** i **tytuł** przechowywane w **org** i **jobTitle**.
+
+### iOS dziwactwa
+
+* **Pref**: nie obsługiwane urządzenia iOS, powrót`false`.
+
+* **Typ**: nie obsługiwane urządzenia iOS, powrót`null`.
+
+* **Nazwa**: częściowo obsługiwane. Pierwsza nazwa organizacji są przechowywane w polu **kABPersonOrganizationProperty** iOS.
+
+* **w departamencie**: częściowo obsługiwane. Pierwsza nazwa jest przechowywana w polu **kABPersonDepartmentProperty** iOS.
+
+* **tytuł**: częściowo obsługiwane. Pierwszy tytuł jest przechowywany w polu **kABPersonJobTitleProperty** iOS.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/efb6b948/doc/zh/index.md
----------------------------------------------------------------------
diff --git a/doc/zh/index.md b/doc/zh/index.md
new file mode 100644
index 0000000..0fdef4f
--- /dev/null
+++ b/doc/zh/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
+
+提供對設備的連絡人資料庫的訪問。
+
+**警告**： 連絡人資料的收集和使用提出了重要的隱私問題。 您的應用程式的隱私權原則應該討論如何應用程式使用的連絡人資料和它是否被共用與任何其他方。 聯繫資訊被視為敏感，因為它揭示了人與人通信的人們。 因此，除了應用程式的隱私權原則，您應強烈考慮提供-時間通知之前應用程式訪問或使用的連絡人資料，如果設備作業系統不會這樣做已經。 該通知應提供相同的資訊上文指出的並獲取該使用者的許可權 （例如，通過為**確定**並**不感謝**提出的選擇）。 請注意一些應用程式市場可能需要應用程式來提供只是在時間的通知，並獲得相應許可權的使用者在訪問連絡人資料之前。 周圍的連絡人資料可説明避免使用者混淆使用感知的和濫用的連絡人資料的清晰和易於理解的使用者體驗。 有關詳細資訊，請參閱隱私指南。
+
+## 安裝
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+### 火狐瀏覽器作業系統的怪癖
+
+在[清單檔][1]中所述創建**www/manifest.webapp** 。 添加相關許可權。 也是需要 web 應用程式的類型更改為"特權"-[清單文檔][2]。 **警告**： 所有特權應用程式強制執行禁止內聯腳本的[內容安全性原則][3]。 在另一種方式初始化應用程式。
+
+ [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"
+ }
+ }
+
+
+### Windows 8 的怪癖
+
+Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸不是可查詢/搜索，你應通知使用者挑選連絡人為 contacts.pickContact，將打開 '人民' 應用程式調用，使用者必須選擇一個連絡人。 返回任何連絡人均為唯讀，因此您的應用程式不能修改它們。
+
+## navigator.contacts
+
+### 方法
+
+* navigator.contacts.create
+* navigator.contacts.find
+* navigator.contacts.pickContact
+
+### 物件
+
+* 連絡人
+* 連絡人姓名
+* ContactField
+* ContactAddress
+* ContactOrganization
+* ContactFindOptions
+* ContactError
+* ContactFieldType
+
+## navigator.contacts.create
+
+`navigator.contacts.create`方法是同步的並返回一個新的 `Contact` 物件。
+
+此方法不會保留連絡人物件在設備的連絡人資料庫中，您需要為其調用 `Contact.save` 方法。
+
+### 支援的平臺
+
+* Android 系統
+* 黑莓 10
+* 火狐瀏覽器作業系統
+* iOS
+* Windows Phone 7 和 8
+
+### 示例
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## navigator.contacts.find
+
+`navigator.contacts.find`方法以非同步方式，執行設備的連絡人資料庫查詢並返回一個陣列的 `Contact` 物件。 所得到的物件傳遞給 `contactSuccess` **contactSuccess**參數所指定的回呼函數。
+
+**ContactFields**參數指定的欄位用作搜索的限定詞。 零長度**contactFields**參數是不正確結果在 `ContactError.INVALID_ARGUMENT_ERROR` 。 **ContactFields**值為 `"*"` 返回所有連絡人欄位。
+
+**ContactFindOptions.filter**字串查詢連絡人資料庫時，可以用作搜索篩選器。 如果提供，不區分大小寫，部分值匹配應用於在**contactFields**參數中指定的每個欄位。 如果有*任何*指定的欄位的匹配，則返回該連絡人。 使用**contactFindOptions.desiredFields**參數來控制哪些連絡人屬性必須回返回。
+
+### 參數
+
+* **contactSuccess**： 從資料庫返回成功回呼函數調用時使用的連絡人物件的陣列。[要求]
+
+* **contactError**： 錯誤回呼函數，當發生錯誤時調用。[可選]
+
+* **contactFields**： 連絡人欄位使用作為搜索的限定詞。*(DOMString[])*[要求]
+
+* **contactFindOptions**: 搜索選項來篩選 navigator.contacts。[可選]鍵包括：
+
+* **篩選器**： 用來查找 navigator.contacts 的搜索字串。*() DOMString*（預設值：`""`)
+
+* **多個**： 確定是否查找操作返回多個 navigator.contacts。*（布林）*（預設值：`false`)
+
+ * **desiredFields**: 聯繫要回返回的欄位。如果指定了，生成的 `Contact` 物件只能使用這些欄位的值。*(DOMString[])*[可選]
+
+### 支援的平臺
+
+* Android 系統
+* 黑莓 10
+* 火狐瀏覽器作業系統
+* iOS
+* Windows Phone 7 和 8
+
+### 示例
+
+ 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
+
+`navigator.contacts.pickContact`方法啟動連絡人選擇器來選擇一個連絡人。 所產生的物件傳遞給 `contactSuccess` **contactSuccess**參數所指定的回呼函數。
+
+### 參數
+
+* **contactSuccess**: 成功使用單個連絡人物件調用的回呼函數。[要求]
+
+* **contactError**： 錯誤回呼函數，當發生錯誤時調用。[可選]
+
+### 支援的平臺
+
+* Android 系統
+* iOS
+* Windows Phone 8
+* Windows 8
+
+### 示例
+
+ navigator.contacts.pickContact(function(contact){
+ console.log('The following contact has been selected:' + JSON.stringify(contact));
+ },function(err){
+ console.log('Error: ' + err);
+ });
+
+
+## 連絡人
+
+`Contact`物件表示使用者的連絡人。 可以創建、 存儲，或從設備的連絡人資料庫中刪除的連絡人。 連絡人可以還 (單獨或批量） 從資料庫中檢索通過調用 `navigator.contacts.find` 方法。
+
+**注**： 以上列出的連絡人欄位並不是所有平臺支援的每個設備。請檢查每個平臺*的怪癖*節瞭解詳細資訊。
+
+### 屬性
+
+* **id**： 一個全域唯一識別碼。*() DOMString*
+
+* **顯示名稱**： 此連絡人，適合於向最終使用者顯示的名稱。*() DOMString*
+
+* **名稱**： 包含所有元件的人的名稱的物件。*(連絡人姓名)*
+
+* **昵稱**: 休閒的解決連絡人名稱。*() DOMString*
+
+* **手機**： 一個陣列的所有連絡人的電話號碼。*(ContactField[])*
+
+* **電子郵件**： 所有連絡人的電子郵件地址的陣列。*(ContactField[])*
+
+* **位址**： 該連絡人的所有位址的陣列。*(ContactAddress[])*
+
+* **ims**： 所有連絡人的 IM 位址的陣列。*(ContactField[])*
+
+* **組織**： 該連絡人的所有組織的陣列。*(ContactOrganization[])*
+
+* **生日**： 連絡人的生日。*（日期）*
+
+* **注**： 有關連絡人的注釋。*() DOMString*
+
+* **照片**： 陣列連絡人的照片。*(ContactField[])*
+
+* **類別**： 陣列與連絡人關聯的所有使用者定義的類別。*(ContactField[])*
+
+* **url**： 陣列與連絡人關聯的 web 頁。*(ContactField[])*
+
+### 方法
+
+* **克隆**： 返回一個新的 `Contact` 物件就是調用物件的深層副本 `id` 屬性設置為`null`.
+
+* **刪除**： 從設備的連絡人資料庫中刪除連絡人，否則執行錯誤回檔與 `ContactError` 物件。
+
+* **保存**： 將一個新的連絡人保存到設備的連絡人資料庫中，或更新現有的連絡人 （如果已存在具有相同**id**的連絡人。
+
+### 支援的平臺
+
+* 亞馬遜火 OS
+* Android 系統
+* 黑莓 10
+* 火狐瀏覽器作業系統
+* iOS
+* Windows Phone 7 和 8
+* Windows 8
+
+### 保存示例
+
+ 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);
+
+
+### 克隆示例
+
+ // 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);
+
+
+### 刪除示例
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### Android 2.X 的怪癖
+
+* **類別**： 不支援 Android 2.X 的設備上，返回`null`.
+
+### 黑莓 10 怪癖
+
+* **id**： 由該設備分配時保存該連絡人。
+
+### FirefoxOS 的怪癖
+
+* **類別**： 部分支援。返回欄位**治安**和**類型**`null`
+
+* **ims**： 不支援
+
+* **照片**： 不支援
+
+### iOS 的怪癖
+
+* **顯示名稱**： 上返回的 iOS 不支援 `null` 除非有沒有 `ContactName` 指定，在這種情況下它將返回複合名稱，**綽號**或 `""` ，分別。
+
+* **生日**： 必須輸入 JavaScript 作為 `Date` 物件，它將返回相同的方式。
+
+* **照片**： 返回到圖像，存儲在應用程式的臨時目錄中的檔的 URL。當應用程式退出時刪除臨時目錄的內容。
+
+* **類別**： 這目前不支援屬性，返回`null`.
+
+### Windows Phone 7 和 8 怪癖
+
+* **顯示名稱**： 當創建一個連絡人，提供的顯示名稱參數不同于顯示名稱的值檢索查找連絡人時。
+
+* **url**： 當創建一個連絡人，使用者可以輸入和保存多個 web 位址，但只有一個是可用的搜索連絡人時。
+
+* **手機**： 不支援*參照*選項。 在*查找*操作中不是支援的*類型*。 只有一個 `phoneNumber` 允許為每個*類型*.
+
+* **電子郵件**：*參照*選項不受支援。家庭和個人使用引用同一電子郵件項。只有一項被允許為每個*類型*.
+
+* **位址**： 僅支援工作和家庭/個人*類型*。家庭和個人*類型*引用相同的位址條目。只有一項被允許為每個*類型*.
+
+* **組織**： 唯一一個允許的並且不支援的*治安*、*類型*和*新聞部*的屬性。
+
+* **注意**： 不支援返回`null`.
+
+* **ims**: 不受支援，返回`null`.
+
+* **生日**: 不受支援，返回`null`.
+
+* **類別**: 不受支援，返回`null`.
+
+## ContactAddress
+
+`ContactAddress`物件存儲的單一位址的連絡人的屬性。 A `Contact` 物件可能包括多個位址在 `ContactAddress[]` 陣列。
+
+### 屬性
+
+* **上一頁**: 設置為 `true` 如果此 `ContactAddress` 包含使用者的首選的值。*（布林）*
+
+* **類型**： 一個字串，例如指示哪種類型的欄位這是*回家*。*() DOMString*
+
+* **格式**： 顯示格式的完整位址。*() DOMString*
+
+* **streetAddress**： 完整的街道位址。*() DOMString*
+
+* **地點**： 城市或地點。*() DOMString*
+
+* **區域**： 國家或地區。*() DOMString*
+
+* **郵遞區號**： 郵遞區號或郵政代碼。*() DOMString*
+
+* **國家**： 國家名稱。*() DOMString*
+
+### 支援的平臺
+
+* 亞馬遜火 OS
+* Android 系統
+* 黑莓 10
+* 火狐瀏覽器作業系統
+* iOS
+* Windows Phone 7 和 8
+* Windows 8
+
+### 示例
+
+ // 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);
+
+
+### Android 2.X 的怪癖
+
+* **上一頁**: 不受支援，返回 `false` Android 2.X 的設備上。
+
+### 黑莓 10 怪癖
+
+* **上一頁**： 返回的黑莓設備上不支援`false`.
+
+* **類型**： 部分支援。*工作*和*家庭*類型位址的每個唯一一個可以存儲每個連絡人。
+
+* **格式化**： 部分支援。返回的串聯的所有黑莓手機位址欄位。
+
+* **streetAddress**: 支援。返回的串聯的黑莓**位址 1**和**位址 2**的位址欄位。
+
+* **現場**: 支援。黑莓手機**城**位址欄位中存儲。
+
+* **區域**： 支援。黑莓手機**stateProvince**位址欄位中存儲。
+
+* **郵遞區號**: 支援。黑莓手機**zipPostal**位址欄位中存儲。
+
+* **國家**： 支援。
+
+### FirefoxOS 的怪癖
+
+* **格式化**： 目前不支援
+
+### iOS 的怪癖
+
+* **上一頁**： 返回的 iOS 設備上不支援`false`.
+
+* **格式化**： 目前不支援。
+
+### Windows 8 的怪癖
+
+* **上一頁**： 不支援
+
+## ContactError
+
+`ContactError`物件返回到使用者通過 `contactError` 回呼函數時出現錯誤。
+
+### 屬性
+
+* **代碼**： 下面列出的預定義的錯誤代碼之一。
+
+### 常量
+
+* `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
+
+`ContactField`物件是可重用的元件表示泛指連絡人欄位。 每個 `ContactField` 物件包含 `value` ， `type` ，和 `pref` 屬性。 A `Contact` 物件存儲中的幾個屬性 `ContactField[]` 陣列，如電話號碼和電子郵件地址。
+
+在大多數情況下，沒有任何預先確定的值為 `ContactField` 物件的**type**屬性。 例如，電話號碼可以指定**類型**的*家庭*、*工作*、*手機*、 *iPhone*或由一個特定的設備平臺聯繫資料庫支援的任何其他值的值。 然而，對於 `Contact` **的照片**欄位，**類型**欄位指示返回圖像的格式： **url**的**值**屬性包含的照片圖像或*base64*的 URL 時的**值**包含一個 base64 編碼的圖像字串時。
+
+### 屬性
+
+* **類型**： 一個字串，例如指示哪種類型的欄位這是*回家*。*() DOMString*
+
+* **值**： 欄位的值，如電話號碼或電子郵件地址。*() DOMString*
+
+* **上一頁**: 設置為 `true` 如果此 `ContactField` 包含使用者的首選的值。*（布林）*
+
+### 支援的平臺
+
+* 亞馬遜火 OS
+* Android 系統
+* 黑莓 10
+* 火狐瀏覽器作業系統
+* iOS
+* Windows Phone 7 和 8
+* Windows 8
+
+### 示例
+
+ // 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();
+
+
+### Android 的怪癖
+
+* **上一頁**: 不受支援，返回`false`.
+
+### 黑莓 10 怪癖
+
+* **類型**： 部分支援。使用的電話號碼。
+
+* **值**： 支援。
+
+* **上一頁**: 不受支援，返回`false`.
+
+### iOS 的怪癖
+
+* **上一頁**: 不受支援，返回`false`.
+
+### Windows8 的怪癖
+
+* **上一頁**: 不受支援，返回`false`.
+
+## 連絡人姓名
+
+包含有關的不同種類的資訊 `Contact` 物件的名稱。
+
+### 屬性
+
+* **格式化**： 該連絡人的完整名稱。*() DOMString*
+
+* **家族**： 連絡人的姓氏。*() DOMString*
+
+* **givenName**： 連絡人的名字。*() DOMString*
+
+* **之間**： 連絡人的中間名。*() DOMString*
+
+* **honorificPrefix**： 連絡人的首碼 (例如*先生*或*博士*） *(DOMString)*
+
+* **honorificSuffix**： 連絡人的尾碼 （如*律師*）。*() DOMString*
+
+### 支援的平臺
+
+* 亞馬遜火 OS
+* Android 2.X
+* 黑莓 10
+* 火狐瀏覽器作業系統
+* iOS
+* Windows Phone 7 和 8
+* Windows 8
+
+### 示例
+
+ 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);
+
+
+### Android 的怪癖
+
+* **格式化**： 部分支援，和唯讀。 返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
+
+### 黑莓 10 怪癖
+
+* **格式化**： 部分支援。返回的串聯的黑莓手機**名字**和**姓氏**欄位。
+
+* **家族**: 支援。黑莓**姓氏**欄位中存儲。
+
+* **givenName**： 支援。黑莓**名字**欄位中存儲。
+
+* **之間**： 不受支援，返回`null`.
+
+* **honorificPrefix**: 不受支援，返回`null`.
+
+* **honorificSuffix**: 不受支援，返回`null`.
+
+### FirefoxOS 的怪癖
+
+* **格式化**： 部分支援，和唯讀。 返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
+
+### iOS 的怪癖
+
+* **格式化**： 部分支援。返回 iOS 複合名稱，但為唯讀。
+
+### Windows 8 的怪癖
+
+* **格式**： 這是唯一名稱屬性，並且是相同的 `displayName` ，和`nickname`
+
+* **家族**: 不支援
+
+* **givenName**: 不支援
+
+* **之間**： 不支援
+
+* **honorificPrefix**: 不支援
+
+* **honorificSuffix**: 不支援
+
+## ContactOrganization
+
+`ContactOrganization`物件存儲的連絡人的組織屬性。A `Contact` 物件存儲一個或多個 `ContactOrganization` 陣列中的物件。
+
+### 屬性
+
+* **上一頁**: 設置為 `true` 如果此 `ContactOrganization` 包含使用者的首選的值。*（布林）*
+
+* **類型**： 一個字串，例如指示哪種類型的欄位這是*回家*。_(DOMString)
+
+* **名稱**： 組織的名稱。*() DOMString*
+
+* **部門**： 新聞部的工程合約。*() DOMString*
+
+* **標題**： 在組織連絡人的標題。*() DOMString*
+
+### 支援的平臺
+
+* Android 系統
+* 黑莓 10
+* 火狐瀏覽器作業系統
+* iOS
+* Windows Phone 7 和 8
+
+### 示例
+
+ 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);
+
+
+### Android 2.X 的怪癖
+
+* **上一頁**: 不支援的 Android 2.X 的設備，返回`false`.
+
+### 黑莓 10 怪癖
+
+* **上一頁**: 不支援的黑莓設備，返回`false`.
+
+* **類型**： 不支援的黑莓設備，返回`null`.
+
+* **名稱**： 部分支援。第一次組織名稱存儲在黑莓**公司**欄位中。
+
+* **部**: 不受支援，返回`null`.
+
+* **標題**: 部分支援。第一次組織標題是黑莓**jobTitle**欄位中存儲的。
+
+### 火狐瀏覽器作業系統的怪癖
+
+* **上一頁**： 不支援
+
+* **類型**： 不支援
+
+* **新聞部**： 不支援
+
+* 欄位**名稱**和**標題**存儲在**組織結構圖**和**jobTitle**.
+
+### iOS 的怪癖
+
+* **上一頁**： 返回的 iOS 設備上不支援`false`.
+
+* **類型**： 返回的 iOS 設備上不支援`null`.
+
+* **名稱**： 部分支援。第一次組織名稱存儲在 iOS **kABPersonOrganizationProperty**欄位中。
+
+* **新聞部**： 部分支援。第一部名稱存儲在 iOS **kABPersonDepartmentProperty**欄位中。
+
+* **標題**: 部分支援。第一個標題是 iOS **kABPersonJobTitleProperty**欄位中存儲的。
\ No newline at end of file
[06/13] git commit: Merge branch 'master' of
https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts
Posted by ld...@apache.org.
Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/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/25f2d925
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/25f2d925
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/25f2d925
Branch: refs/heads/master
Commit: 25f2d925d7194a0123cce4507b5a6b2b8b94ba7d
Parents: 173bcab 6b19488
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue May 20 13:54:59 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue May 20 13:54:59 2014 -0400
----------------------------------------------------------------------
doc/index.md | 16 ----------------
plugin.xml | 17 +++++++++--------
2 files changed, 9 insertions(+), 24 deletions(-)
----------------------------------------------------------------------
[10/13] git commit: Lisa testing pulling in plugins for plugin:
cordova-plugin-contacts
Posted by ld...@apache.org.
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 <ld...@us.ibm.com>
Authored: Tue May 27 21:21:38 2014 -0400
Committer: ldeluca <ld...@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