cordova-plugin-contacts - npm Package Compare versions

Comparing version 0.2.16 to 1.0.0

.travis.yml

doc/de/index.md

		@@ -20,11 +20,19 @@ <!---

		# org.apache.cordova.contacts
		# cordova-plugin-contacts

		Ermöglicht den Zugriff auf die Kontaktdatenbank Gerät.
		Dieses Plugin definiert eine globale `navigator.contacts`-Objekt bietet Zugriff auf die Geräte-Kontakte-Datenbank.

		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 der Kontakt-Daten Benutzer Verwirrung zu vermeiden können und wahrgenommene Missbrauch der Kontaktdaten. Weitere Informationen finden Sie in der Datenschutz-Guide.
		Obwohl das Objekt mit der globalen Gültigkeitsbereich `navigator` verbunden ist, steht es nicht bis nach dem `Deviceready`-Ereignis.

		document.addEventListener("deviceready", onDeviceReady, false);
		function onDeviceReady() {
		console.log(navigator.contacts);
		}


		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 eine just-in-Time-Bekanntmachung, bevor die app zugreift oder Kontaktdaten verwendet, wenn Betriebssystem des Geräts nicht dies bereits tun. 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 der 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
		cordova plugin add cordova-plugin-contacts

		@@ -34,3 +42,3 @@

		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.
		Erstellen Sie www/manifest.webapp, wie in [Docs Manifest][1] beschrieben. Fügen Sie die entsprechenden Permisions. Es muss auch die Webapp um "privileged" - [Manifest Docs][2] ändern. Warnung: alle privilegierten apps [Content Security Policy][3], welche Inlineskript verbietet zu erzwingen. Initialisieren Sie die Anwendung auf andere Weise.

		@@ -52,3 +60,3 @@ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest

		Alle Kontakte von zurückgegebenen `find` und `pickContact` Methoden sind schreibgeschützt, so dass sie von die Anwendung nicht geändert werden kann. `find`Methode nur auf Windows Phone 8.1-Geräten verfügbar.
		Keine Kontakte von `find` und `pickContact`-Methoden zurückgegebenen sind schreibgeschützt, so die Anwendung geändert werden kann. `find`-Methode nur auf Windows Phone 8.1-Geräten verfügbar.

		@@ -80,5 +88,5 @@ ### Windows 8 Macken

		Die `navigator.contacts.create` Methode ist synchron und gibt eine neue `Contact` Objekt.
		Die `navigator.contacts.create`-Methode ist synchron und gibt ein neues `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.
		Diese Methode behält nicht das Kontakt-Objekt in der Gerät-Kontakte-Datenbank, für die Sie benötigen, um die `Contact.save`-Methode aufzurufen.

		@@ -100,23 +108,25 @@ ### Unterstützte Plattformen

		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.
		Die `navigator.contacts.find`-Methode führt asynchron, Abfragen der Gerät-Kontakte-Datenbank und gibt ein Array von `Contact`-Objekte. Die resultierenden Objekte werden an die durch den contactSuccess-Parameter angegebenen `contactSuccess`-Callback-Funktion übergeben.

		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.
		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 Wert `"*"` sucht 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.
		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]
		* contactFields: Kontaktfelder als Qualifizierer Suche verwenden. (DOMString[]) [Required]

		* ContactError: Fehler-Callback-Funktion wird aufgerufen, wenn ein Fehler auftritt. [Optional]
		* contactSuccess: Erfolg-Callback-Funktion aufgerufen, die mit dem Array von Contact-Objekte aus der Datenbank zurückgegeben. [Required]

		* ContactFields: Kontaktfelder als Qualifizierer Suche verwenden. (DOMString[]) [Erforderlich]
		* contactError: Fehler-Callback-Funktion wird aufgerufen, wenn ein Fehler auftritt.[Optional]

		* 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`)
		* contactFindOptions: Optionen zum Filtern von navigator.contacts zu suchen. [Optional]

		* 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]
		Schlüssel enthalten:

		* filter: die zu suchende Zeichenfolge verwendet, um navigator.contacts zu finden. (DOM-String und enthält) (Standard: `""`)

		* multiple: bestimmt, ob der Suchvorgang mehrere navigator.contacts gibt. (Boolesch) (Standard: `false`)

		* desiredFields: Kontaktfelder wieder zurückgegeben werden. Wenn angegeben, Objekt der daraus resultierenden `Contact` nur Funktionen Werte für diese Felder. (DOMString[]) [Optional]

		@@ -157,3 +167,3 @@ ### Unterstützte Plattformen

		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.
		Die `navigator.contacts.pickContact`-Methode startet im Kontakt Farbwähler wählen Sie einen einzigen Ansprechpartner. Das resultierende Objekt wird an die durch den contactSuccess-Parameter angegebenen `contactSuccess`-Callback-Funktion übergeben.

		@@ -185,3 +195,3 @@ ### Parameter

		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.
		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 (einzeln oder als Gruppe) aus der Datenbank abgerufen werden durch Aufrufen der `navigator.contacts.find`-Methode.

		@@ -222,7 +232,7 @@ 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.

		* Klon: gibt eine neue `Contact` Objekt, das eine tiefe Kopie des aufrufenden Objekts, mit der `id` -Eigenschaft festgelegt`null`.
		* clone: 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.
		* remove: 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.
		* save: speichert einen neuen Kontakt in der Gerätedatenbank Kontakte, oder einen vorhandenen Kontakt aktualisiert, wenn ein Kontakt mit der gleichen Id bereits vorhanden ist.

		@@ -346,3 +356,3 @@ ### Unterstützte Plattformen

		Das `ContactAddress` -Objekt speichert die Eigenschaften einer einzelnen Adresse eines Kontakts. A `Contact` Objekt gehören mehr als eine Adresse in ein `ContactAddress[]` Array.
		Das `ContactAddress`-Objekt speichert die Eigenschaften einer einzelnen Adresse eines Kontakts. Ein `Contact` objekt kann mehr als eine Adresse in einem `ContactAddress []`-Array enthalten.

		@@ -450,3 +460,3 @@ ### Eigenschaften

		Das `ContactError` -Objekt wird zurückgegeben, die der Benutzer über die `contactError` Callback-Funktion, wenn ein Fehler auftritt.
		Das `ContactError`-Objekt wird dem Benutzer über die `contactError`-Callback-Funktion zurückgegeben, wenn ein Fehler auftritt.

		@@ -469,13 +479,13 @@ ### Eigenschaften

		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.
		Das `ContactField`-Objekt ist eine wieder verwendbare Komponenten stellt Felder generisch kontaktieren. Jedes `ContactField`-Objekt enthält eine Eigenschaft `value`, `type` und `pref`. Ein `Contact`-Objekt speichert mehrere Eigenschaften in `ContactField []`-Arrays, wie Telefonnummern 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, iPhoneoder 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.
		In den meisten Fällen gibt es keine vorher festgelegten Werte für ein `ContactField`-Objekt-Type-Attribut. Beispielsweise kann eine Telefonnummer angeben type werte von home, work, mobile, iPhone oder ein beliebiger anderer Wert, der von einem bestimmten Geräteplattform Kontaktdatenbank unterstützt wird. Jedoch für die `Contact`-photos-Feld, das type-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)
		* type: 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)
		* value: 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)
		* pref: Legen Sie auf `true` Wenn dieses `ContactField` des Benutzers bevorzugten Wert enthält. (boolesch)

		@@ -535,3 +545,3 @@ ### Unterstützte Plattformen

		Enthält verschiedene Arten von Informationen über ein `Contact` Name des Objekts.
		Enthält verschiedene Arten von Informationen über `ein Kontaktobjekt` Namen.

		@@ -555,3 +565,3 @@ ### Eigenschaften
		* Amazon Fire OS
		* Android 2.X
		* Android
		* BlackBerry 10
		@@ -633,3 +643,3 @@ * Firefox OS

		Das `ContactOrganization` -Objekt speichert Organisationseigenschaften eines Kontakts. A `Contact` -Objekt speichert eine oder mehrere `ContactOrganization` Objekte in einem Array.
		Das `ContactOrganization`-Objekt speichert Organisationseigenschaften eines Kontakts. Ein `Contact` objekt werden ein oder mehrere `ContactOrganization`-Objekte in einem Array gespeichert.

		@@ -723,2 +733,2 @@ ### Eigenschaften

		* Typ: nicht unterstützt, Rückgabe`null`.
		* Typ: nicht unterstützt, Rückgabe`null`.

211

doc/es/index.md

		@@ -20,11 +20,17 @@ <!---

		# org.apache.cordova.contacts
		# cordova-plugin-contacts

		Proporciona acceso a la base de datos de contactos de dispositivo.
		Este plugin define un global `navigator.contacts` objeto que 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, consulte a la guía de privacidad.
		Aunque el objeto está unido al ámbito global `navigator` , no estará disponible hasta después de la `deviceready` evento.

		document.addEventListener ("deviceready", onDeviceReady, false);
		function onDeviceReady() {console.log(navigator.contacts)};


		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
		Cordova plugin agregar cordova-plugin-contacts

		@@ -40,9 +46,3 @@

		"type": "privileged",
		"permissions": {
		"contacts": {
		"access": "readwrite",
		"description": "Describe why there is a need for such permission"
		}
		}
		"tipo": "el privilegio", "permisos": {"contactos": {"acceso": "readwrite", "Descripción": "describir por qué hay una necesidad de tal autorización"}}

		@@ -52,3 +52,3 @@

		Cualquier contacto regresado de `find` y `pickContact` los métodos son readonly, así que su aplicación no puede modificarlos. `find`método disponible sólo en dispositivos Windows Phone 8.1.
		Cualquier contacto regresado de `find` y `pickContact` métodos son readonly, por lo que su aplicación no puede modificarlos. `find`método disponible sólo en dispositivos Windows Phone 8.1.

		@@ -82,3 +82,3 @@ ### Rarezas de Windows 8

		Este método no retener el objeto de contacto en la base de contactos de dispositivo, para lo cual necesitas invocar el método `Contact.save`.
		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.

		@@ -95,3 +95,3 @@ ### Plataformas soportadas

		var myContact = navigator.contacts.create({"displayName": "Test User"});
		var myContact = navigator.contacts.create ({"displayName": "Test User"});

		@@ -101,23 +101,25 @@

		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 función de callback `contactSuccess` especificada por el parámetro contactSuccess.
		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. 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 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 `"*"` busca campos todo contactos.

		La cadena de contactFindOptions.filter puede ser usada como un filtro de búsqueda al consultar la base de datos de contactos. Si proporciona, 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.
		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

		* contactSuccess: función de callback de éxito se invoca con la matriz de objetos contacto devueltos desde la base de datos. [Obligatorio]
		* contactFields: póngase en contacto con campos para usar como un calificador de búsqueda. (DOMString[]) [Required]

		* contactError: función de callback de Error, se invoca cuando se produce un error. [Opcional]
		* contactSuccess: función de callback de éxito se invoca con la matriz de objetos contacto devueltos desde la base de datos. [Required]

		* contactFields: póngase en contacto con campos para usar como un calificador de búsqueda. (DOMString[]) [Obligatorio]
		* contactError: función de callback de Error, se invoca cuando se produce un error. [Optional]

		* 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`)
		* contactFindOptions: buscar opciones para filtrar navigator.contacts. [Optional]

		* 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]
		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`)

		* 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[]) [Optional]

		@@ -135,17 +137,12 @@ ### Plataformas soportadas

		function onSuccess(contacts) {
		alert('Found ' + contacts.length + ' contacts.');
		};
		function onSuccess(contacts) {alert ('Encontrados' + contacts.length + 'contactos de.');};

		function onError(contactError) {
		alert('onError!');
		};
		function onError(contactError) {alert('onError!');};

		// find all contacts with 'Bob' in any name field
		var options = new ContactFindOptions();
		options.filter = "Bob";
		options.multiple = true;
		encuentra todos los contactos con 'Bob' en cualquier nombre campo var opciones = 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(fields, onSuccess, onError, options);
		campos var = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
		Navigator.contacts.Find (campos, onSuccess, onError, opciones);

		@@ -177,6 +174,4 @@

		navigator.contacts.pickContact(function(contact){
		console.log('The following contact has been selected:' + JSON.stringify(contact));
		},function(err){
		console.log('Error: ' + err);
		navigator.contacts.pickContact(function(contact) {console.log (' se ha seleccionado el siguiente contacto: "+ JSON.stringify(contact));
		}, function(err) {console.log ('Error: ' + err);
		});
		@@ -242,23 +237,14 @@

		function onSuccess(contact) {
		alert("Save Success");
		};
		function onSuccess(contact) {alert ("salvar con éxito");};

		function onError(contactError) {
		alert("Error = " + contactError.code);
		};
		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();
		crear un nuevo objeto contacto var contacto = navigator.contacts.create();
		contact.displayName = "Plomero";
		Contact.nickname = "Plomero"; especificar tanto para todos los dispositivos de apoyo / / rellenar algún nombre var campos = new ContactName();
		name.givenName = "Jane";
		name.familyName = "Doe";
		contact.name = name;
		Contact.name = nombre;

		// save to device
		contact.save(onSuccess,onError);
		guardar en el dispositivo contact.save(onSuccess,onError);

		@@ -268,7 +254,6 @@

		// clone the contact object
		var clone = contact.clone();
		clon del clon de contacto objeto var = contact.clone();
		clone.name.givenName = "John";
		console.log("Original contact name = " + contact.name.givenName);
		console.log("Cloned contact name = " + clone.name.givenName);
		Console.log ("contacto Original nombre =" + contact.name.givenName);
		Console.log ("Cloned contacto nombre =" + clone.name.givenName);

		@@ -278,12 +263,7 @@

		function onSuccess() {
		alert("Removal Success");
		};
		function onSuccess() {alert ("retiro el éxito");};

		function onError(contactError) {
		alert("Error = " + contactError.code);
		};
		function onError(contactError) {alert ("Error =" + contactError.code);};

		// remove the contact from the device
		contact.remove(onSuccess,onError);
		quitar el contacto de la contact.remove(onSuccess,onError) del dispositivo;

		@@ -349,3 +329,3 @@

		El objeto `ContactAddress` almacena las propiedades de una única dirección de un contacto. Un objeto de `Contact` puede incluir más de una dirección en un array `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.

		@@ -383,15 +363,3 @@ ### Propiedades

		// 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);
		Mostrar la información de dirección para el funcionan de todos los contactos onSuccess(contacts) {para (var = 0; < contacts.length; i ++) {para (var j = 0; j < contacts[i].addresses.length; j ++) {alert ("Pref:" + contacts[i].addresses[j].pref + "\n" + "tipo:" + contacts[i].addresses[j].type + "\n" + "formato:" + contacts[i].addresses[j].formatted + "\n" + "dirección: "+ contacts[i].addresses[j].streetAddress +"\n"+" localidad: "+ contacts[i].addresses[j].locality +"\n"+" región: "+ contacts[i].addresses[j].region +"\n"+" Código Postal: "+ contacts[i].addresses[j].postalCode +"\n"+" país: "+ contacts[i].addresses[j].country);
		}
		@@ -401,11 +369,8 @@ }

		function onError(contactError) {
		alert('onError!');
		};
		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);
		encontrar todos los contactos var opciones = new ContactFindOptions();
		options.Filter = "";
		filtro var = ["displayName", "direcciones"];
		Navigator.contacts.Find (filtro, onSuccess, onError, opciones);

		@@ -498,14 +463,10 @@

		// create a new contact
		var contact = navigator.contacts.create();
		crear un nuevo contacto contacto var = 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;
		almacenar números de teléfono de contacto en números de var ContactField [] = [];
		phoneNumbers[0] = new ContactField ('trabajo', ' 212-555-1234', false);
		phoneNumbers[1] = new ContactField ('móviles', ' 917-555-5432', true); recomendado: número phoneNumbers[2] = new ContactField ('home', ' 203-555-7890', false);
		contact.phoneNumbers = números;

		// save the contact
		contact.save();
		guardar el contacto contact.save();

		@@ -558,3 +519,3 @@
		* Amazon fire OS
		* Android 2.X
		* Android
		* BlackBerry 10
		@@ -569,21 +530,12 @@ * Firefox OS

		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);
		función onSuccess(contacts) {para (var = 0; < contacts.length; i ++) {alert ("formateada:" + contacts[i].name.formatted + "\n" + "Apellido:" + contacts[i].name.familyName + "\n" + "nombre:" + contacts[i].name.givenName + "\n" + "segundo nombre:" + contacts[i].name.middleName + "\n" + "sufijo:" + contacts[i].name.honorificSuffix + "\n" + "prefijo:" + contacts[i].name.honorificSuffix);
		}
		};

		function onError(contactError) {
		alert('onError!');
		};
		function onError(contactError) {alert('onError!');};

		var options = new ContactFindOptions();
		options.filter = "";
		filter = ["displayName", "name"];
		navigator.contacts.find(filter, onSuccess, onError, options);
		var opciones = new ContactFindOptions();
		options.Filter = "";
		filtro = ["displayName", "nombre"];
		Navigator.contacts.Find (filtro, onSuccess, onError, opciones);

		@@ -662,10 +614,3 @@

		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 onSuccess(contacts) {para (var = 0; < contacts.length; i ++) {para (var j = 0; j < contacts[i].organizations.length; j ++) {alert ("Pref:" + contacts[i].organizations[j].pref + "\n" + "tipo:" + contacts[i].organizations[j].type + "\n" + "nombre:" + contacts[i].organizations[j].name + "\n" + "Departamento:" + contacts[i].organizations[j].department + "\n" + "título: "+ contacts[i].organizations[j].title);
		}
		@@ -675,10 +620,8 @@ }

		function onError(contactError) {
		alert('onError!');
		};
		function onError(contactError) {alert('onError!');};

		var options = new ContactFindOptions();
		options.filter = "";
		filter = ["displayName", "organizations"];
		navigator.contacts.find(filter, onSuccess, onError, options);
		var opciones = new ContactFindOptions();
		options.Filter = "";
		filtro = ["displayName", "organizaciones"];
		Navigator.contacts.Find (filtro, onSuccess, onError, opciones);

		@@ -728,2 +671,2 @@

		* tipo: no soportado, regresando`null`.
		* tipo: no soportado, regresando`null`.

209

doc/fr/index.md

		@@ -20,11 +20,17 @@ <!---

		# org.apache.cordova.contacts
		# cordova-plugin-contacts

		Donne accès à la base de données de contacts de dispositif.
		Ce plugin définit un global `navigator.contacts` objet, ce qui permet d'accéder à 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-à-temps 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.
		Bien que l'objet est attaché à la portée globale `navigator` , il n'est pas disponible jusqu'après la `deviceready` événement.

		document.addEventListener (« deviceready », onDeviceReady, false) ;
		function onDeviceReady() {console.log(navigator.contacts);}


		Avertissement: collecte et utilisation des données de contact soulève des questions importantes de la vie privée. Politique de confidentialité de votre application doit examiner comment l'application utilise les données de contact et si il est partagé avec d'autres parties. Information de contact est considéré comme sensible parce qu'il révèle 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 susmentionnées, ainsi que d'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-à-temps 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
		Cordova plugin ajouter cordova-plugin-contacts

		@@ -40,9 +46,3 @@

		"type": "privileged",
		"permissions": {
		"contacts": {
		"access": "readwrite",
		"description": "Describe why there is a need for such permission"
		}
		}
		« type »: "le privilège", "autorisations": {« contacts »: {« accès »: "readwrite", "description": "décrire pourquoi il est nécessaire pour obtenir cette permission"}}

		@@ -93,3 +93,3 @@

		var myContact = navigator.contacts.create({"displayName": "Test User"});
		myContact var = navigator.contacts.create ({« displayName »: « Test User »}) ;

		@@ -101,3 +101,3 @@

		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.
		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 `"*"` recherche dans les champs de tout contact.

		@@ -108,15 +108,17 @@ 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.

		* contactSuccess: fonction de rappel de succès avec le tableau d'objets Contact appelée retournée par la base de données. [Obligatoire]
		* contactFields: communiquer avec les champs à utiliser comme un qualificateur de recherche. (DOMString[]) [Required]

		* contactError: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Facultatif]
		* contactSuccess: fonction de rappel de succès avec le tableau d'objets Contact appelée retournée par la base de données. [Required]

		* contactFields: communiquer avec les champs à utiliser comme un qualificateur de recherche. (DOMString[]) [Obligatoire]
		* contactError: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Optional]

		* 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`)
		* contactFindOptions: recherche d'options pour filtrer navigator.contacts. [Optional]

		* 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]
		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`)

		* desiredFields: Contactez champs soit retourné en arrière. Si spécifié, l'entraînant `Contact` objet dispose seulement des valeurs de ces champs. (DOMString[]) [Optional]

		@@ -134,17 +136,12 @@ ### Plates-formes prises en charge

		function onSuccess(contacts) {
		alert('Found ' + contacts.length + ' contacts.');
		};
		function onSuccess(contacts) {alert (« Found » + contacts.length + « contacts. »);} ;

		function onError(contactError) {
		alert('onError!');
		};
		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(fields, onSuccess, onError, options);
		trouver tous les contacts avec « Bob » dans toute option de var de champ nom = new ContactFindOptions() ;
		options.Filter = « Bob » ;
		options.multiple = true ;
		options.desiredFields = [navigator.contacts.fieldType.id] ;
		champs var = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name] ;
		Navigator.contacts.Find (champs, onSuccess, onError, options) ;

		@@ -176,6 +173,4 @@

		navigator.contacts.pickContact(function(contact){
		console.log('The following contact has been selected:' + JSON.stringify(contact));
		},function(err){
		console.log('Error: ' + err);
		navigator.contacts.pickContact(function(contact) {console.log ("le contact suivant a été retenu:" + JSON.stringify(contact)) ;
		}, function(err) {console.log ("Error:" + err) ;
		});
		@@ -241,32 +236,22 @@

		function onSuccess(contact) {
		alert("Save Success");
		};
		function onSuccess(contact) {alert ("sauver succès");} ;

		function onError(contactError) {
		alert("Error = " + contactError.code);
		};
		function onError(contactError) {alert ("erreur =" + contactError.code);} ;

		// create a new contact object
		var contact = navigator.contacts.create();
		contact.displayName = "Plumber";
		contact.nickname = "Plumber"; // specify both to support all devices
		créer un objet contact contact var = navigator.contacts.create() ;
		contact.displayName = « Plombier » ;
		contact.Nickname = « Plombier » ; spécifier à la fois pour prendre en charge tous les périphériques / / renseigner certains champs var nom = new ContactName() ;
		name.givenName = « Jane » ;
		name.familyName = « Doe » ;
		contact.name = nom ;

		// populate some fields
		var name = new ContactName();
		name.givenName = "Jane";
		name.familyName = "Doe";
		contact.name = name;
		enregistrer dans contact.save(onSuccess,onError) de l'appareil ;

		// 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);
		Clone clone objet contact var = contact.clone() ;
		clone.name.givenName = « John » ;
		Console.log ("contact Original nom =" + contact.name.givenName) ;
		Console.log ("nom de contact clonés =" + clone.name.givenName) ;

		@@ -276,12 +261,7 @@

		function onSuccess() {
		alert("Removal Success");
		};
		fonction onSuccess() {alert ("succès");} ;

		function onError(contactError) {
		alert("Error = " + contactError.code);
		};
		function onError(contactError) {alert ("erreur =" + contactError.code);} ;

		// remove the contact from the device
		contact.remove(onSuccess,onError);
		supprimer le contact de l'appareil contact.remove(onSuccess,onError) ;

		@@ -380,15 +360,3 @@

		// 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);
		Affichez les informations d'adresse pour tous les contacts fonctionnent onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {pour (var j = 0; j < contacts[i].addresses.length; j ++) {alert ("Pref:" + contacts[i].addresses[j].pref + « \n » + "Type:" + contacts[i].addresses[j].type + « \n » + "au format:" + contacts[i].addresses[j].formatted + « \n » + "adresse de rue: "+ contacts[i].addresses[j].streetAddress +"\n"+" localité: "+ contacts[i].addresses[j].locality +"\n"+" région: "+ contacts[i].addresses[j].region +"\n"+" Code Postal: "+ contacts[i].addresses[j].postalCode +"\n"+" pays: "+ contacts[i].addresses[j].country) ;
		}
		@@ -398,11 +366,8 @@ }

		function onError(contactError) {
		alert('onError!');
		};
		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);
		trouver tous les contacts options var = new ContactFindOptions() ;
		options.Filter = "" ;
		filtre var = ["name", « adresses »] ;
		Navigator.contacts.Find (filtre, onSuccess, onError, options) ;

		@@ -495,14 +460,10 @@

		// create a new contact
		var contact = navigator.contacts.create();
		créer un nouveau contact contact var = 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;
		stocker des numéros de téléphone de contact en ContactField [] var phoneNumbers = [] ;
		phoneNumbers[0] = new ContactField (« travail », ' 212-555-1234', false) ;
		phoneNumbers[1] = new ContactField (« mobile », ' 917-555-5432', true) ; phoneNumbers[2] numéro préféré = new ContactField (« home », ' 203-555-7890', false) ;
		contact.phoneNumbers = phoneNumbers ;

		// save the contact
		contact.save();
		enregistrer le contact contact.save() ;

		@@ -555,3 +516,3 @@
		* Amazon Fire OS
		* Android 2.X
		* Android
		* BlackBerry 10
		@@ -566,21 +527,12 @@ * Firefox OS

		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 onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {alert ("Formatted:" + contacts[i].name.formatted + « \n » + "patronyme:" + contacts[i].name.familyName + « \n » + "Prénom:" + contacts[i].name.givenName + « \n » + "Prénom:" + contacts[i].name.middleName + « \n » + "suffixe:" + contacts[i].name.honorificSuffix + « \n » + "préfixe:" + contacts[i].name.honorificSuffix) ;
		}
		};

		function onError(contactError) {
		alert('onError!');
		};
		function onError(contactError) {alert('onError!');} ;

		var options = new ContactFindOptions();
		options.filter = "";
		filter = ["displayName", "name"];
		navigator.contacts.find(filter, onSuccess, onError, options);
		options de var = new ContactFindOptions() ;
		options.Filter = "" ;
		filtre = ["name", « nom »] ;
		Navigator.contacts.Find (filtre, onSuccess, onError, options) ;

		@@ -659,10 +611,3 @@

		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 onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {pour (var j = 0; j < contacts[i].organizations.length; j ++) {alert ("Pref:" + contacts[i].organizations[j].pref + « \n » + "Type:" + contacts[i].organizations[j].type + « \n » + "nom:" + contacts[i].organizations[j].name + « \n » + "Département:" + contacts[i].organizations[j].department + « \n » + "Title: "+ contacts[i].organizations[j].title) ;
		}
		@@ -672,10 +617,8 @@ }

		function onError(contactError) {
		alert('onError!');
		};
		function onError(contactError) {alert('onError!');} ;

		var options = new ContactFindOptions();
		options.filter = "";
		filter = ["displayName", "organizations"];
		navigator.contacts.find(filter, onSuccess, onError, options);
		options de var = new ContactFindOptions() ;
		options.Filter = "" ;
		filtre = ["displayName", « organisations »] ;
		Navigator.contacts.Find (filtre, onSuccess, onError, options) ;

		@@ -725,2 +668,2 @@

		* type: ne pas pris en charge, retour`null`.
		* type: ne pas pris en charge, retour`null`.

doc/it/index.md

		@@ -20,6 +20,14 @@ <!---

		# org.apache.cordova.contacts
		# cordova-plugin-contacts

		Fornisce l'accesso al database di contatti del dispositivo.
		Questo plugin definisce un oggetto globale `navigator.contacts`, che fornisce l'accesso al database di contatti del dispositivo.

		Anche se l'oggetto è associato con ambito globale del `navigator`, non è disponibile fino a dopo l'evento `deviceready`.

		document.addEventListener("deviceready", onDeviceReady, false);
		function onDeviceReady() {
		console.log(navigator.contacts);
		}


		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 confusione dell'utente e percepito un uso improprio dei dati di contatto. Per ulteriori informazioni, vedere la guida sulla Privacy.
		@@ -29,3 +37,3 @@

		cordova plugin add org.apache.cordova.contacts
		cordova plugin add cordova-plugin-contacts

		@@ -35,3 +43,3 @@

		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.
		Creare www/manifest.webapp come descritto nel [Manifest Docs][1]. Aggiungi permisions rilevanti. C'è anche la necessità di modificare il tipo di webapp in "privilegiato" - [Manifest Docs][2]. AVVERTENZA: tutte le apps privilegiato applicare [Content Security Policy][3] che vieta script inline. Inizializzare l'applicazione in un altro modo.

		@@ -53,3 +61,3 @@ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest

		Eventuali contatti restituiti da `find` e `pickContact` metodi sono readonly, quindi l'applicazione non può modificarli. `find`Metodo disponibile solo sui dispositivi Windows Phone 8.1.
		Eventuali contatti restituiti dai metodi `find` e `pickContact` sono readonly, quindi l'applicazione non può modificarli. Metodo `find` disponibile solo sui dispositivi Windows Phone 8.1.

		@@ -70,3 +78,3 @@ ### Stranezze di Windows 8

		* Contatto
		* Contact
		* ContactName
		@@ -80,7 +88,7 @@ * ContactField

		## Navigator.contacts.Create
		## navigator.contacts.create

		Il `navigator.contacts.create` metodo sincrono e restituisce un nuovo `Contact` oggetto.
		Il metodo `navigator.contacts.create` è sincrono e restituisce un nuovo oggetto di `Contact`.

		Questo metodo non mantiene l'oggetto contatto nel database contatti dispositivo, per cui è necessario richiamare il `Contact.save` metodo.
		Questo metodo non mantiene l'oggetto contatto nel database contatti dispositivo, per cui è necessario richiamare il metodo `Contact.save`.

		@@ -102,23 +110,25 @@ ### Piattaforme supportate

		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 metodo `navigator.contacts.find` in modo asincrono, esegue una query sul database di contatti del dispositivo e restituisce una matrice di oggetti `Contact`. Gli oggetti risultanti vengono passati alla funzione di callback `contactSuccess` specificata 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.
		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 `"*"` ricerche campi tutti i contatti.

		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.
		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]
		* contactFields: contattare campi da utilizzare come un qualificatore di ricerca. (DOMString[]) [Required]

		* contactSuccess: funzione di callback successo richiamato con la matrice di oggetti contatto restituiti dal database. [Required]

		* 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`)
		* contactFindOptions: opzioni per filtrare navigator.contacts di ricerca. [Optional]

		* desiredFields: contattare i campi per essere tornato indietro. Se specificato, il conseguente `Contact` oggetto presenta solo i valori per questi campi. (DOMString[]) [Facoltativo]
		I tasti sono:

		* filter: la stringa di ricerca utilizzata per trovare navigator.contacts. (DOMString) (Default: `""`)

		* multiple: determina se l'operazione di ricerca restituisce più navigator.contacts. (Boolean) (Default: `false`)

		* desiredFields: contattare i campi per essere tornato indietro. Se specificato, il risultante `contatto` oggetto solo caratteristiche valori per questi campi. (DOMString[]) [Optional]

		@@ -159,3 +169,3 @@ ### Piattaforme supportate

		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 .
		Il metodo `navigator.contacts.pickContact` lancia il contatto selettore per selezionare un singolo contatto. L'oggetto risultante viene passato alla funzione di callback `contactSuccess` specificata dal parametro contactSuccess.

		@@ -185,5 +195,5 @@ ### Parametri

		## Contatto
		## Contact

		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.
		L'oggetto `Contact` 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 metodo `navigator.contacts.find`.

		@@ -347,3 +357,3 @@ 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.

		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.
		L'oggetto `ContactAddress` memorizza le proprietà di un singolo indirizzo di un contatto. Un oggetto `Contact` può includere più di un indirizzo in una matrice `[] ContactAddress`.

		@@ -451,3 +461,3 @@ ### Proprietà

		Il `ContactError` oggetto viene restituito all'utente attraverso la `contactError` funzione di callback quando si verifica un errore.
		L'oggetto `ContactError` viene restituito all'utente tramite la funzione di callback `contactError` quando si verifica un errore.

		@@ -470,5 +480,5 @@ ### Proprietà

		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.
		L'oggetto `ContactField` è un componente riutilizzabile che rappresenta Contatta campi genericamente. Ogni oggetto `ContactField` contiene una proprietà di `value`, `type` e `pref`. Un oggetto `Contact` memorizza diverse proprietà in matrici `[] ContactField`, come numeri di telefono e indirizzi email.

		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, iPhoneo 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.
		Nella maggior parte dei casi, esistono pre-determinati valori per l'attributo `type` di un oggetto ContactField. Ad esempio, un numero di telefono può specificare valori di type di casa, lavoro, mobile, iPhone o qualsiasi altro valore che è supportato dal database dei contatti su una piattaforma particolare dispositivo. Tuttavia, per il campo di photo del `Contacto`, il campo type indica il formato dell'immagine restituita: url quando il value di attributo contiene un URL per l'immagine fotografica, o base64, quando il value contiene una stringa con codifica base64 immagine.

		@@ -536,3 +546,3 @@ ### Proprietà

		Contiene diversi tipi di informazioni circa un `Contact` nome dell'oggetto.
		Contiene diversi tipi di informazioni sul nome di un oggetto `Contact`.

		@@ -556,3 +566,3 @@ ### Proprietà
		* Amazon fuoco OS
		* Android 2. x
		* Android
		* BlackBerry 10
		@@ -634,3 +644,3 @@ * Firefox OS

		Il `ContactOrganization` oggetto memorizza la proprietà di organizzazione di un contatto. A `Contact` oggetto memorizza uno o più `ContactOrganization` gli oggetti in una matrice.
		L'oggetto `ContactOrganization` memorizza la proprietà di organizzazione di un contatto. Un oggetto `Contact` memorizza uno o più oggetti `ContactOrganization` in una matrice.

		@@ -724,2 +734,2 @@ ### Proprietà

		* tipo: non supportato, restituendo`null`.
		* tipo: non supportato, restituendo`null`.

doc/ja/index.md

		@@ -20,11 +20,19 @@ <!---

		# org.apache.cordova.contacts
		# cordova-plugin-contacts

		デバイスの連絡先データベースへのアクセスを提供します。
		このプラグインは、デバイスの連絡先データベースへのアクセスを提供するグローバル `navigator.contacts` オブジェクトを定義します。

		警告: 連絡先データの収集と利用を重要なプライバシーの問題を発生させます。アプリのプライバシーポリシーアプリが連絡先データを使用する方法と、他の当事者では共有されているかどうかを話し合う必要があります。人誰と通信する人々を明らかにするために、連絡先情報が機密と見なされます。したがって、アプリのプライバシーポリシーに加えて、強くする必要がありますデバイスのオペレーティングシステムが既にしない場合アプリにアクセスまたは連絡先のデータを使用する前に - 時間のお知らせを提供します。その通知は、上記の (例えば、 [ok]をおかげで選択肢を提示する) によってユーザーのアクセス許可を取得するだけでなく、同じ情報を提供する必要があります。いくつかのアプリのマーケットプレース - 時間の通知を提供して、連絡先データにアクセスする前にユーザーの許可を取得するアプリをする必要がありますに注意してください。連絡先データは、ユーザーの混乱を避けるのに役立ちますの使用および連絡先データの知覚の誤用を囲む明確でわかりやすいユーザーエクスペリエンス。詳細については、プライバシーに関するガイドを参照してください。
		オブジェクトは、グローバルスコープの `ナビゲーター` に添付、それがないまで `deviceready` イベントの後。

		document.addEventListener("deviceready", onDeviceReady, false);
		function onDeviceReady() {
		console.log(navigator.contacts);
		}


		警告: 連絡先データの収集と利用を重要なプライバシーの問題を発生させます。アプリのプライバシーポリシーアプリが連絡先データを使用する方法と、他の当事者では共有されているかどうかを話し合う必要があります。人誰と通信する人々を明らかにするために、連絡先情報が機密と見なされます。したがって、アプリのプライバシーポリシーに加えて、強くお勧めデバイスのオペレーティングシステムが既にしない場合アプリにアクセスまたは連絡先のデータを使用する前に - 時間のお知らせを提供します。その通知は、上記の (例えば、[ok] をおかげで選択肢を提示する) によってユーザーのアクセス許可を取得するだけでなく、同じ情報を提供する必要があります。いくつかのアプリのマーケットプレース - 時間の通知を提供して、連絡先データにアクセスする前にユーザーの許可を取得するアプリをする必要がありますに注意してください。連絡先データは、ユーザーの混乱を避けるのに役立ちますの使用および連絡先データの知覚の誤用を囲む明確でわかりやすいユーザーエクスペリエンス。詳細については、プライバシーに関するガイドを参照してください。

		## インストール

		cordova plugin add org.apache.cordova.contacts
		cordova plugin add cordova-plugin-contacts

		@@ -34,3 +42,3 @@

		[マニフェストのドキュメント][1]で説明されているように、 www/manifest.webappを作成します。関連する権限を追加します。 [マニフェストのドキュメント][2]「特権」- に web アプリケーションの種類を変更する必要も。警告: すべての特権を持つアプリケーションインラインスクリプトを禁止している[コンテンツのセキュリティポリシー][3]を適用します。別の方法で、アプリケーションを初期化します。
		[マニフェストのドキュメント][1] で説明されているように、www/manifest.webapp を作成します。関連する権限を追加します。 [マニフェストのドキュメント][2]「特権」- に web アプリケーションの種類を変更する必要も。警告: すべての特権を持つアプリケーションインラインスクリプトを禁止している [コンテンツのセキュリティポリシー][3] を適用します。別の方法で、アプリケーションを初期化します。

		@@ -52,3 +60,3 @@ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest

		返されるすべての連絡先 `find` および `pickContact` メソッドは、読み取り専用アプリケーションを変更することはできませんので。 `find`8.1 の Windows Phone デバイス上でのみ利用可能な方法。
		`find` し、`pickContact` メソッドから返されるすべての連絡先は readonly、アプリケーションを変更することはできません。 `find` メソッド 8.1 の Windows Phone デバイスでのみ使用できます。

		@@ -80,5 +88,5 @@ ### Windows 8 の癖

		`navigator.contacts.create`メソッドは同期的にし、新しいを返します `Contact` オブジェクト。
		`navigator.contacts.create` メソッドは同期的に、新しい `連絡先` オブジェクトを返します。

		このメソッドを呼び出す必要があるデバイスの連絡先データベースに連絡先オブジェクトを保持しない、 `Contact.save` メソッド。
		このメソッドは、`Contact.save` メソッドを呼び出す必要があるデバイスの連絡先データベースに連絡先オブジェクトを保持しません。

		@@ -100,23 +108,25 @@ ### サポートされているプラットフォーム

		`navigator.contacts.find`デバイスの連絡先データベースをクエリの配列を返すメソッドは、非同期的に実行されます `Contact` オブジェクト。結果として得られるオブジェクトに渡される、 `contactSuccess` 、 contactSuccessパラメーターで指定されたコールバック関数。
		デバイスの連絡先データベースを照会して、`Contact` オブジェクトの配列を返す `navigator.contacts.find` メソッドを非同期的に実行します。結果として得られるオブジェクトは、contactSuccess パラメーターで指定された `contactSuccess` コールバック関数に渡されます。

		連絡先パラメーター検索の修飾子として使用するフィールドを指定します。ゼロ長さ連絡先パラメーターが有効になり `ContactError.INVALID_ARGUMENT_ERROR` 。連絡先値 `"*"` すべての連絡先フィールドを返します。
		contactFields パラメーター検索の修飾子として使用するフィールドを指定します。ゼロ長さ contactFields パラメーターは有効で、`ContactError.INVALID_ARGUMENT_ERROR` の結果します。 contactFields 値 `"*"` すべての連絡先フィールドが検索されます。

		ContactFindOptions.filter文字列の連絡先データベースを照会するときに検索フィルターとして使用できます。指定した場合、大文字と小文字、部分的な値の一致する連絡先パラメーターで指定されたフィールドごとに適用されます。一致する任意指定のフィールドがある場合は、連絡先が返されます。バック連絡先プロパティを制御するcontactFindOptions.desiredFieldsパラメーターを使用しますが返される必要があります。
		contactFindOptions.filter 文字列の連絡先データベースを照会するときに検索フィルターとして使用できます。指定した場合、大文字と小文字、部分的な値の一致する contactFields パラメーターで指定されたフィールドごとに適用されます。一致する任意指定のフィールドがある場合は、連絡先が返されます。バック連絡先プロパティを制御する contactFindOptions.desiredFields パラメーターを使用しますが返される必要があります。

		### パラメーター

		* contactSuccess: Contact オブジェクトの配列に呼び出される成功コールバック関数は、データベースから返されます。[必須]
		* contactFields: 連絡先検索修飾子として使用するフィールド。(DOMString[]) [Required]

		* contactSuccess: Contact オブジェクトの配列に呼び出される成功コールバック関数は、データベースから返されます。[Required]

		* contactError: エラーコールバック関数は、エラーが発生したときに呼び出されます。[オプション]

		* 連絡先: 連絡先検索修飾子として使用するフィールド。(DOMString[])[必須]

		* contactFindOptions: navigator.contacts をフィルターするオプションを検索します。[オプション]キーは次のとおりです。

		* フィルター: navigator.contacts の検索に使用する検索文字列。（，）(既定値します。`""`)

		* 複数: 複数 navigator.contacts かどうかは、検索操作に返すを決定します。(ブール値)(既定値します。`false`)
		* contactFindOptions: navigator.contacts をフィルターするオプションを検索します。[Optional]

		* desiredFields：戻って返されるフィールドに問い合わせてください。指定した場合、結果として `Contact` オブジェクトのみ機能のこれらのフィールドの値。(DOMString[])[オプション]
		キーは次のとおりです。

		* filter: navigator.contacts の検索に使用する検索文字列。（，）(デフォルト: `""`)

		* multiple: 複数 navigator.contacts かどうかは、検索操作に返すを決定します。(ブール値)(デフォルト: `false`)

		* desiredFields：戻って返されるフィールドに問い合わせてください。指定した場合、結果 `Contact` オブジェクトこれらのフィールドの値でのみ機能します。(DOMString[]) [Optional]

		@@ -157,3 +167,3 @@ ### サポートされているプラットフォーム

		`navigator.contacts.pickContact`メソッド連絡先ピッカーを起動します 1 つの連絡先を選択します。結果として得られるオブジェクトに渡される、 `contactSuccess` 、 contactSuccessパラメーターで指定されたコールバック関数。
		`navigator.contacts.pickContact` メソッドは単一の連絡先を選択する連絡先ピッカーを起動します。結果として得られるオブジェクトは、contactSuccess パラメーターで指定された `contactSuccess` コールバック関数に渡されます。

		@@ -185,5 +195,5 @@ ### パラメーター

		`Contact`オブジェクトは、ユーザーの連絡先を表します。連絡先の作成、格納、またはデバイスの連絡先データベースから削除することができます。連絡先も取得できます (個別にまたは一括）をデータベースから呼び出すことによって、 `navigator.contacts.find` メソッド。
		`Contact` オブジェクトは、ユーザーの連絡先を表します。連絡先の作成、格納、またはデバイスの連絡先データベースから削除することができます。連絡先も取得できます (個別にまたは一括で) データベースから `navigator.contacts.find` メソッドを呼び出すことによって。

		注: すべて上記の連絡先フィールドのすべてのデバイスプラットフォームでサポートされます。詳細については各プラットフォームの互換セクションを確認してください。
		注: すべて上記の連絡先フィールドのすべてのデバイスプラットフォームでサポートされます。詳細については各プラットフォームの互換セクションを確認してください。

		@@ -345,3 +355,3 @@ ### プロパティ

		`ContactAddress`オブジェクトの連絡先の 1 つのアドレスのプロパティが格納されます。 A `Contact` オブジェクトで 1 つ以上のアドレスを含めることができます、 `ContactAddress[]` 配列。
		`ContactAddress` オブジェクトは、連絡先の 1 つのアドレスのプロパティを格納します。 `Contact` オブジェクトは、`ContactAddress` 配列の 1 つ以上のアドレスなどがあります。

		@@ -449,3 +459,3 @@ ### プロパティ

		`ContactError`オブジェクトを介してユーザーに返されます、 `contactError` コールバック関数でエラーが発生したとき。
		`ContactError` オブジェクトにエラーが発生したときに `contactError` コールバック関数を通じてユーザーに返されます。

		@@ -468,5 +478,5 @@ ### プロパティ

		`ContactField`オブジェクトは連絡先フィールドを総称を表す再利用可能なコンポーネントです。各 `ContactField` オブジェクトが含まれています、 `value` 、 `type` 、および `pref` プロパティ。 A `Contact` オブジェクトのいくつかのプロパティに格納されます `ContactField[]` 携帯電話番号、メールアドレスなどの配列。
		`ContactField` オブジェクトは連絡先フィールドを総称を表す再利用可能なコンポーネントです。各 `ContactField` オブジェクトには `値` `型`、および `県` プロパティが含まれています。 `連絡先` オブジェクトは、`ContactField` 配列に、電話番号、メールアドレスなどのいくつかのプロパティを格納します。

		ほとんどの場合、事前に決められた値がない、 `ContactField` オブジェクトのtype属性。たとえば、電話番号がホーム、仕事、モバイル、 iPhone、または特定のデバイスプラットフォームの連絡先データベースでサポートされている他の値の型の値を指定できます。ただし、ため、 `Contact` 写真] フィールドに、種類フィールド、返されるイメージの形式を示します: url 値属性値を base64 でエンコードされたイメージの文字列が含まれる場合に写真イメージまたはbase64に URL が含まれる場合。
		ほとんどの場合、`ContactField` オブジェクトの type 属性のあらかじめ決められた値はありません。たとえば、電話番号がホーム、仕事、モバイル、iPhone、または特定のデバイスプラットフォームの連絡先データベースでサポートされている他の値の型の値を指定できます。ただし、`連絡先` の写真] のフィールドの種類] フィールドを示します返される画像の形式: url 値属性値を base64 でエンコードされたイメージの文字列が含まれる場合に写真イメージまたは base64 に URL が含まれる場合。

		@@ -534,3 +544,3 @@ ### プロパティ

		についての異なる種類情報にはが含まれています、 `Contact` オブジェクトの名前。
		異なる種類 `Contact` オブジェクトの名前についての情報にはが含まれています。

		@@ -554,3 +564,3 @@ ### プロパティ
		* アマゾン火 OS
		* アンドロイド 2.X
		* アンドロイド
		* ブラックベリー 10
		@@ -632,3 +642,3 @@ * Firefox の OS

		`ContactOrganization`オブジェクトは、連絡先の組織のプロパティを格納します。A `Contact` 1 つまたは複数のオブジェクトに格納されます `ContactOrganization` 配列内のオブジェクト。
		`ContactOrganization` オブジェクトは、連絡先の組織のプロパティを格納します。`連絡先` オブジェクトは、配列の 1 つ以上の `ContactOrganization` オブジェクトを格納します。

		@@ -722,2 +732,2 @@ ### プロパティ

		* タイプ: サポートされていないを返す`null`.
		* タイプ: サポートされていないを返す`null`.

doc/ko/index.md

		@@ -20,11 +20,19 @@ <!---

		# org.apache.cordova.contacts
		# cordova-plugin-contacts

		장치 연락처 데이터베이스에 대 한 액세스를 제공합니다.
		이 플러그인 장치 연락처 데이터베이스에 대 한 액세스를 제공 하는 글로벌 `navigator.contacts` 개체를 정의 합니다.

		경고: 중요 한 개인 정보 보호 문제를 제기 하는 연락처 데이터의 수집 및 사용 합니다. 응용 프로그램의 개인 정보 보호 정책 응용 프로그램 연락처 데이터를 사용 하는 방법 및 다른 당사자와 함께 공유 하는 여부를 토론 해야 한다. 연락처 정보 누구와 통신 하는 사람이 사람들 보여 때문에 민감한으로 간주 됩니다. 따라서 애플 리 케이 션의 개인 정보 보호 정책 뿐만 아니라 강하게 해야 장치 운영 체제는 이렇게 이미 하지 않는 경우 응용 프로그램 액세스 또는 연락처 데이터를 사용 하기 전에 그냥--시간 통지를 제공 합니다. 그 통지는 (예를 들어, 확인 및 아니오선택 제시) 하 여 사용자의 허가 취득 뿐만 아니라, 위에서 언급 된 동일한 정보를 제공 해야 합니다. Note 일부 애플 리 케이 션 장 터 그냥--시간 공지 및 연락처 데이터에 액세스 하기 전에 사용자의 허가 받아야 응용 프로그램에 필요할 수 있습니다. 연락처 데이터는 사용자의 혼동을 방지할 수의 사용 및 연락처 데이터의 인식된 오용 명확 하 고 이해 하기 쉬운 사용자 경험. 자세한 내용은 개인 정보 보호 가이드를 참조 하십시오.
		개체 `navigator` 글로벌 범위 첨부 아니에요 때까지 사용할 수 있는 `deviceready` 이벤트 후.

		document.addEventListener("deviceready", onDeviceReady, false);
		function onDeviceReady() {
		console.log(navigator.contacts);
		}


		경고: 중요 한 개인 정보 보호 문제를 제기 하는 연락처 데이터의 수집 및 사용 합니다. 응용 프로그램의 개인 정보 보호 정책 응용 프로그램 연락처 데이터를 사용 하는 방법 및 다른 당사자와 함께 공유 하는 여부를 토론 해야 한다. 연락처 정보 누구와 통신 하는 사람이 사람들 보여 때문에 민감한으로 간주 됩니다. 따라서, 애플 리 케이 션의 개인 정보 보호 정책 뿐만 아니라 강력 하 게 고려해 야 장치 운영 체제는 이렇게 이미 하지 않는 경우 응용 프로그램 액세스 또는 연락처 데이터를 사용 하기 전에 그냥--시간 통지를 제공 합니다. 그 통지는 (예를 들어, 확인 및 아니오 선택 제시) 하 여 사용자의 허가 취득 뿐만 아니라, 위에서 언급 된 동일한 정보를 제공 해야 합니다. Note 일부 애플 리 케이 션 장 터 그냥--시간 공지 및 연락처 데이터에 액세스 하기 전에 사용자의 허가 받아야 응용 프로그램에 필요할 수 있습니다. 연락처 데이터는 사용자의 혼동을 방지할 수의 사용 및 연락처 데이터의 인식된 오용 명확 하 고 이해 하기 쉬운 사용자 경험. 자세한 내용은 개인 정보 보호 가이드를 참조 하십시오.

		## 설치

		cordova plugin add org.apache.cordova.contacts
		cordova plugin add cordova-plugin-contacts

		@@ -34,3 +42,3 @@

		[참고 문서][1]에 설명 된 대로 www/manifest.webapp 를 만듭니다. 관련 부여할 추가 합니다. [참고 문서][2]에 "권한"-webapp 유형을 변경 하려면 필요가 하다. 경고: 모든 훌륭한 애플 리 케이 션 인라인 스크립트를 금지 하는 [콘텐츠 보안 정책][3] 을 적용 합니다. 다른 방법으로 응용 프로그램을 초기화 합니다.
		[참고 문서][1]에 설명 된 대로 www/manifest.webapp를 만듭니다. 관련 부여할 추가 합니다. [참고 문서][2]에 "privileged"-webapp 유형을 변경 하려면 필요가 하다. 경고: 모든 훌륭한 애플 리 케이 션 인라인 스크립트를 금지 하는 [콘텐츠 보안 정책][3]을 적용 합니다. 다른 방법으로 응용 프로그램을 초기화 합니다.

		@@ -52,3 +60,3 @@ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest

		모든 연락처에서 반환 된 `find` 및 `pickContact` 메서드는 읽기 전용 응용 프로그램을 수정할 수 없습니다. `find`Windows Phone 8.1 장치에만 사용할 수 있는 방법.
		`find` 및 `pickContact` 메서드에서 반환 하는 모든 연락처는 읽기 전용 응용 프로그램을 수정할 수 없습니다. `찾을` 방법은 Windows Phone 8.1 장치에만 사용할 수 있습니다.

		@@ -80,5 +88,5 @@ ### 윈도우 8 단점

		`navigator.contacts.create`메서드는 동기적, 및 새로운 반환 합니다 `Contact` 개체.
		`navigator.contacts.create` 메서드는 동기적 및 새 `연락처` 개체를 반환 합니다.

		이 메서드를 호출 해야 장치 연락처 데이터베이스에 연락처 개체를 유지 하지 않습니다는 `Contact.save` 방법.
		이 메서드는 `Contact.save` 메서드를 호출 해야 장치 연락처 데이터베이스에 연락처 개체를 유지 하지 않습니다.

		@@ -100,23 +108,25 @@ ### 지원 되는 플랫폼

		`navigator.contacts.find`장치 연락처 데이터베이스 쿼리 및의 배열을 반환 메서드가 비동기적으로 실행 될 `Contact` 개체. 결과 객체에 전달 되는 `contactSuccess` contactSuccess 매개 변수로 지정 된 콜백 함수.
		장치 연락처 데이터베이스 쿼리 및 `Contact` 개체의 배열을 반환 `navigator.contacts.find` 메서드를 비동기적으로 실행 합니다. 결과 개체는 contactSuccess 매개 변수에서 지정한 `contactSuccess` 콜백 함수에 전달 됩니다.

		ContactFields 매개 변수는 검색 한정자로 사용할 필드를 지정 합니다. 길이가 0 인 contactFields 매개 변수 유효 하지 않습니다 및 결과 `ContactError.INVALID_ARGUMENT_ERROR` . ContactFields 값이 `"*"` 모든 연락처 필드를 반환 합니다.
		contactFields 매개 변수는 검색 한정자로 사용할 필드를 지정 합니다. 길이가 0 인 contactFields 매개 변수가 유효 하 고 `ContactError.INVALID_ARGUMENT_ERROR`에서 결과. contactFields 값 `"*"` 모든 연락처 필드를 검색 합니다.

		ContactFindOptions.filter 문자열 연락처 데이터베이스를 쿼리할 때 검색 필터로 사용할 수 있습니다. 제공 된, 대/소문자, 부분 값 일치 contactFields 매개 변수에 지정 된 각 필드에 적용 됩니다. 모든 지정 된 필드의 일치 하는 경우 연락처 반환 됩니다. 사용 하 여 contactFindOptions.desiredFields 매개 변수 속성 문의 제어를 다시 반환 해야 합니다.
		contactFindOptions.filter 문자열 연락처 데이터베이스를 쿼리할 때 검색 필터로 사용할 수 있습니다. 제공 된, 대/소문자, 부분 값 일치 contactFields 매개 변수에 지정 된 각 필드에 적용 됩니다. 모든 지정 된 필드의 일치 하는 경우 연락처 반환 됩니다. 사용 하 여 contactFindOptions.desiredFields 매개 변수 속성 문의 제어를 다시 반환 해야 합니다.

		### 매개 변수

		* contactSuccess: 연락처 개체의 배열에 표시 되는 성공 콜백 함수는 데이터베이스에서 반환 된. [필수]
		* contactFields: 검색 한정자로 사용 하는 필드에 문의. (DOMString[]) [Required]

		* contactSuccess: 연락처 개체의 배열에 표시 되는 성공 콜백 함수는 데이터베이스에서 반환 된. [Required]

		* contactError: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]

		* contactFields: 검색 한정자로 사용 하는 필드에 문의. (DOMString[]) [필수]

		* contactFindOptions: navigator.contacts 필터링 옵션을 검색 합니다. [선택 사항] 키 다음과 같습니다.

		* 필터: 검색 문자열 navigator.contacts를 찾는 데 사용 합니다. (DOMString) (기본:`""`)

		* 여러: 여러 navigator.contacts 찾기 작업을 반환 합니다 경우 결정 합니다. (부울) (기본:`false`)
		* contactFindOptions: navigator.contacts 필터링 옵션을 검색 합니다. [Optional]

		* desiredFields: 연락처 필드를 다시 반환 합니다. 그 결과 지정 된 경우 `Contact` 만이 필드의 값을 보유 하는 개체. (DOMString[]) [선택 사항]
		키 다음과 같습니다.

		* filter: 검색 문자열 navigator.contacts를 찾는 데 사용 합니다. (DOMString) (기본: `""`)

		* multiple: 여러 navigator.contacts 찾기 작업을 반환 합니다 경우 결정 합니다. (부울) (기본값: `false`)

		* desiredFields: 연락처 필드를 다시 반환 합니다. 지정 된 경우 결과 `Contact` 기능 값만이 필드 개체입니다. (DOMString[]) [Optional]

		@@ -157,3 +167,3 @@ ### 지원 되는 플랫폼

		`navigator.contacts.pickContact`메서드가 단일 연락처 선택 문의 선택 시작. 결과 개체에 전달 되는 `contactSuccess` contactSuccess 매개 변수로 지정 된 콜백 함수.
		`navigator.contacts.pickContact` 메서드를 사용 하면 단일 연락처 선택 문의 선택 시작 합니다. 결과 개체는 contactSuccess 매개 변수에서 지정한 `contactSuccess` 콜백 함수에 전달 됩니다.

		@@ -185,3 +195,3 @@ ### 매개 변수

		`Contact`개체는 사용자의 연락처를 나타냅니다. 연락처 생성 수, 저장 또는 장치 연락처 데이터베이스에서 제거 합니다. 연락처도 검색할 수 있습니다 (개별적으로 또는 일괄적으로) 데이터베이스에서 호출 하 여는 `navigator.contacts.find` 방법.
		`Contact` 개체는 사용자의 연락처를 나타냅니다. 연락처 생성 수, 저장 또는 장치 연락처 데이터베이스에서 제거 합니다. 연락처도 검색할 수 있습니다 (개별적으로 또는 일괄적으로) 데이터베이스에서 `navigator.contacts.find` 메서드를 호출 하 여.

		@@ -345,3 +355,3 @@ 참고: 모든 연락처 필드 위에 나열 된 모든 장치 플랫폼에서 지원 됩니다. 자세한 내용은 각 플랫폼의 단점이 섹션을 확인 하시기 바랍니다.

		`ContactAddress`개체는 연락처의 단일 주소 속성을 저장 합니다. A `Contact` 개체에 하나 이상의 주소가 포함 될 수 있습니다는 `ContactAddress[]` 배열.
		`ContactAddress` 개체는 연락처의 단일 주소 속성을 저장합니다. `연락처` 개체는 `ContactAddress` 배열에 있는 하나 이상의 주소를 포함할 수 있습니다.

		@@ -449,3 +459,3 @@ ### 속성

		`ContactError`개체를 통해 사용자에 게 반환 되는 `contactError` 콜백 함수는 오류가 발생 한 경우.
		`ContactError` 개체는 오류가 발생 하면 `contactError` 콜백 함수를 통해 사용자에 게 반환 됩니다.

		@@ -468,5 +478,5 @@ ### 속성

		`ContactField`개체는 재사용 가능한 구성 요소를 나타내는 필드를 일반적으로 문의. 각 `ContactField` 개체에 포함 되어 있는 `value` , `type` , 및 `pref` 속성. A `Contact` 개체에 여러 속성이 저장 `ContactField[]` 배열, 전화 번호 및 이메일 주소.
		`ContactField` 개체는 재사용 가능한 구성 요소를 나타내는 필드를 일반적으로 문의입니다. 각 `ContactField` 개체에는 `value`, `type` 및 `pref` 속성을 포함 되어 있습니다. `Contact` 개체는 전화 번호 및 이메일 주소와 같은 `ContactField` 배열에서 몇 가지 속성을 저장합니다.

		대부분의 경우에는 미리 결정 된 값에 대 한는 `ContactField` 개체의 type 속성. 예를 들어 전화 번호 홈, 작품, 모바일, 아이폰또는 특정 장치 플랫폼의 연락처 데이터베이스에서 지원 되는 다른 값의 유형 값을 지정할 수 있습니다. 그러나는 `Contact` 사진 필드 유형 필드 나타냅니다 반환 된 이미지 형식: url 값 특성 값 이미지 base64 인코딩된 문자열을 포함 하는 경우 사진 이미지 또는 base64 URL이 포함 된 경우.
		대부분의 경우에서는 `ContactField` 개체의 type 속성에 대 한 미리 정해진된 값이 없습니다. 예를 들어 전화 번호 홈, 작품, 모바일, 아이폰 또는 특정 장치 플랫폼의 연락처 데이터베이스에서 지원 되는 다른 값의 유형 값을 지정할 수 있습니다. 그러나, `연락처` 사진 필드 유형 필드 나타냅니다 반환 된 이미지 형식: url 값 특성 값 이미지 base64 인코딩된 문자열을 포함 하는 경우 사진 이미지 또는 base64 URL이 포함 된 경우.

		@@ -534,3 +544,3 @@ ### 속성

		에 대 한 다양 한 정보를 포함 한 `Contact` 개체의 이름.
		여러 종류의 `Contact` 개체의 이름에 대 한 정보를 포함합니다.

		@@ -554,3 +564,3 @@ ### 속성
		* 아마존 화재 운영 체제
		* 안 드 로이드 2.X
		* 안 드 로이드
		* 블랙베리 10
		@@ -632,3 +642,3 @@ * Firefox 운영 체제

		`ContactOrganization`개체를 연락처의 조직 속성을 저장 합니다. A `Contact` 개체 저장 하나 이상의 `ContactOrganization` 개체 배열에.
		`ContactOrganization` 개체는 연락처의 조직 속성을 저장합니다. `Contact` 개체 배열에 하나 이상의 `ContactOrganization` 개체를 저장합니다.

		@@ -722,2 +732,2 @@ ### 속성

		* 형식: 지원 되지 않는 반환`null`.
		* 형식: 지원 되지 않는 반환`null`.

doc/pl/index.md

		@@ -20,6 +20,14 @@ <!---

		# org.apache.cordova.contacts
		# cordova-plugin-contacts

		Zapewnia dostęp do bazy danych kontaktów urządzenia.
		Ten plugin definiuje obiekt globalny `navigator.contacts`, która zapewnia dostęp do bazy danych kontaktów urządzenia.

		Mimo, że obiekt jest dołączony do globalnego zakresu `navigator`, to nie dostępne dopiero po zdarzeniu `deviceready`.

		document.addEventListener("deviceready", onDeviceReady, false);
		function onDeviceReady() {
		console.log(navigator.contacts);
		}


		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 zrozumienia 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.
		@@ -29,3 +37,3 @@

		cordova plugin add org.apache.cordova.contacts
		cordova plugin add cordova-plugin-contacts

		@@ -35,3 +43,3 @@

		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.
		Tworzenie www/manifest.webapp, jak opisano w [Dokumentach Manifest][1]. Dodaj odpowiednie permisions. Istnieje również potrzeba zmienić typ webapp do "privileged" - [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.

		@@ -53,3 +61,3 @@ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest

		Wszelkie kontakty wrócił z `find` i `pickContact` metody są tylko do odczytu, więc aplikacja nie mogą ich modyfikować. `find`Metoda jest dostępna tylko na urządzenia Windows Phone 8.1.
		Wszelkie kontakty wrócił z `pickContact` i `find` metody są tylko do odczytu, więc aplikacja nie mogą ich modyfikować. `find` metody dostępne tylko na urządzenia Windows Phone 8.1.

		@@ -81,5 +89,5 @@ ### Windows 8 dziwactwa

		`navigator.contacts.create`Metoda jest synchroniczna i zwraca nową `Contact` obiektu.
		Metoda `navigator.contacts.create` jest synchroniczna i zwraca nowy obiekt `Contact`.

		Ta metoda nie zachowuje kontakt obiektu bazy danych kontaktów urządzenie, dla którego musisz wywołać `Contact.save` Metoda.
		Ta metoda nie zachowuje kontakt obiektu bazy danych kontaktów urządzenie, dla którego należy wywołać metodę `Contact.save`.

		@@ -101,23 +109,25 @@ ### Obsługiwane platformy

		`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 .
		Metoda `navigator.contacts.find` asynchronicznie, wykonuje kwerendy bazy danych kontaktów urządzenia i tablicę obiektów `kontaktów`. Wynikowe obiekty są przekazywane do funkcji wywołania zwrotnego `contactSuccess`, 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.
		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ść `"*"` przeszukuje wszystkie kontakt z pola.

		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.
		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]
		* contactFields: kontakt z pól do wykorzystania jako kwalifikator Szukaj. (DOMString[]) [Required]

		* contactSuccess: sukcesu funkcji wywołania zwrotnego, wywoływane z tablicy obiektów kontaktów zwracane z bazy danych. [Required]

		* 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`)
		* contactFindOptions: Szukaj opcji filtrowania navigator.contacts. [Optional]

		* 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]
		Klucze obejmuje:

		* filter: ciąg wyszukiwania umożliwia znalezienie navigator.contacts. (DOMString) (Domyślnie: `""`)

		* multiple: 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, wynikowy `kontakt` obiekt tylko funkcje wartości tych pól. (DOMString[]) [Optional]

		@@ -158,3 +168,3 @@ ### Obsługiwane platformy

		`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 .
		Metoda `navigator.contacts.pickContact` uruchamia próbnika kontakt, wybierz jeden kontaktem. Wynikowy obiekt jest przekazywany do funkcji wywołania zwrotnego `contactSuccess`, określony przez parametr contactSuccess.

		@@ -186,3 +196,3 @@ ### Parametry

		`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.
		`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 wywołanie metody `navigator.contacts.find`.

		@@ -346,3 +356,3 @@ 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.

		`ContactAddress`Obiektu przechowuje właściwości pojedynczego adresu kontaktu. A `Contact` obiektu może zawierać więcej niż jeden adres w `ContactAddress[]` tablicy.
		Obiekt `ContactAddress` przechowuje właściwości pojedynczego adresu kontaktu. Obiekt `Contact` może zawierać więcej niż jeden adres w tablicy `[ContactAddress]`.

		@@ -450,3 +460,3 @@ ### Właściwości

		`ContactError`Zwracany jest obiekt użytkownika za pomocą `contactError` funkcji wywołania zwrotnego, gdy wystąpi błąd.
		`ContactError` obiekt jest zwracany użytkownikowi za pośrednictwem funkcji wywołania zwrotnego `contactError`, gdy wystąpi błąd.

		@@ -469,5 +479,5 @@ ### Właściwości

		`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.
		Obiekt `ContactField` jest składnikiem wielokrotnego użytku, że reprezentuje kontakt pola ogólnie. Każdy obiekt `ContactField` zawiera `wartość`, `Typ` i `pref` Właściwość. Obiekt `Contact` sklepy kilku właściwości w tablicach `[ContactField]`, takich jak numery telefonów i adresy 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 większości przypadków są nie wcześniej ustalonych wartości atrybutu type obiektu `ContactField`. Na przykład numer telefonu można określić type wartości home, work, mobile, iPhone, lub jakąkolwiek inną wartość, który jest obsługiwany przez platformę danego urządzenia bazy danych kontaktów. Jednak `Contact` photos pola, pole type wskazuje format zwrócone obrazu: url, gdy value atrybut zawiera adres URL, do zdjęć, lub base64, gdy value zawiera ciąg zakodowany base64 obrazu.

		@@ -535,3 +545,3 @@ ### Właściwości

		Zawiera różne rodzaje informacji o `Contact` Nazwa obiektu.
		Zawiera różne rodzaje informacji o nazwę obiektu `Contact`.

		@@ -555,3 +565,3 @@ ### Właściwości
		* Amazon Fire OS
		* Android 2.X
		* Android
		* BlackBerry 10
		@@ -633,3 +643,3 @@ * Firefox OS

		`ContactOrganization`Obiektu przechowuje właściwości organizacji kontaktu. A `Contact` obiektu przechowuje jeden lub więcej `ContactOrganization` obiekty w tablicy.
		Obiekt `ContactOrganization` przechowuje właściwości organizacji kontaktu. Obiekt `Contact` sklepy jeden lub więcej obiektów `ContactOrganization` w tablicy.

		@@ -723,2 +733,2 @@ ### Właściwości

		* Typ: nie obsługiwane, powrót`null`.
		* Typ: nie obsługiwane, powrót`null`.

doc/ru/index.md

		@@ -20,3 +20,3 @@ <!---

		# org.apache.cordova.contacts
		# cordova-plugin-contacts

		@@ -29,3 +29,3 @@ Обеспечивает доступ к базе данных контактов устройства.

		cordova plugin add org.apache.cordova.contacts
		cordova plugin add cordova-plugin-contacts

		@@ -711,2 +711,2 @@

		* тип: не поддерживается, возвращая`null`.
		* тип: не поддерживается, возвращая`null`.

274

doc/zh/index.md

		@@ -20,11 +20,19 @@ <!---

		# org.apache.cordova.contacts
		# cordova-plugin-contacts

		提供對設備的連絡人資料庫的訪問。
		這個外掛程式定義了一個全域 `navigator.contacts` 物件，提供對設備連絡人資料庫的訪問。

		警告：連絡人資料的收集和使用提出了重要的隱私問題。您的應用程式的隱私權原則應該討論如何應用程式使用的連絡人資料和它是否被共用與任何其他方。聯繫資訊被視為敏感，因為它揭示了人與人通信的人們。因此，除了應用程式的隱私權原則，您應強烈考慮提供-時間通知之前應用程式訪問或使用的連絡人資料，如果設備作業系統不會這樣做已經。該通知應提供相同的資訊上文指出的並獲取該使用者的許可權（例如，通過為確定並不感謝提出的選擇）。請注意一些應用程式市場可能需要應用程式來提供只是在時間的通知，並獲得相應許可權的使用者在訪問連絡人資料之前。周圍的連絡人資料可説明避免使用者混淆使用感知的和濫用的連絡人資料的清晰和易於理解的使用者體驗。有關詳細資訊，請參閱隱私指南。
		雖然該物件附加到全球範圍內 `導航器`，它不可用直到 `deviceready` 事件之後。

		document.addEventListener("deviceready", onDeviceReady, false);
		function onDeviceReady() {
		console.log(navigator.contacts);
		}


		警告：連絡人資料的收集和使用提出了重要的隱私問題。您的應用程式的隱私權原則應該討論應用程式如何使用連絡人資料和它是否被共用與任何其他締約方。聯繫資訊被認為是敏感，因為它揭示了的人與人溝通了。因此，除了隱私權原則的應用程式，您應強烈考慮提供時間只是通知之前應用程式訪問或使用連絡人的資料，如果設備作業系統不已經這樣做了。該通知應提供相同的資訊，如上所述，以及獲取該使用者的許可權（例如，通過提出選擇確定並不感謝）。請注意一些應用程式市場可能需要應用程式提供只是時間的通知，並獲得使用者的許可才能訪問連絡人資料。周圍的連絡人資料可以説明避免使用者混淆使用和連絡人資料感知的濫用的清楚和容易理解的使用者體驗。有關詳細資訊，請參閱隱私指南。

		## 安裝

		cordova plugin add org.apache.cordova.contacts
		cordova plugin add cordova-plugin-contacts

		@@ -34,3 +42,3 @@

		在[清單檔][1]中所述創建www/manifest.webapp 。添加相關許可權。也是需要 web 應用程式的類型更改為"特權"-[清單文檔][2]。警告：所有特權應用程式強制執行禁止內聯腳本的[內容安全性原則][3]。在另一種方式初始化應用程式。
		在 [清單檔][1] 中所述創建 www/manifest.webapp。添加相關的許可權。也是需要的 web 應用程式類型更改為"privileged"— — [顯化的文檔][2]。警告：所有的特權應用程式強制執行禁止內聯腳本的 [內容的安全性原則][3]。在另一種方式初始化您的應用程式。

		@@ -52,7 +60,7 @@ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest

		從返回的任何連絡人 `find` 和 `pickContact` 方法是唯讀，因此您的應用程式不能修改它們。 `find`僅在 Windows Phone 8.1 設備上可用的方法。
		從 `find` 和 `pickContact` 方法返回任何連絡人是唯讀，因此您的應用程式不能修改它們。僅在 Windows Phone 8.1 設備上可用的 `find` 方法。

		### Windows 8 的怪癖

		Windows 8 連絡人是唯讀的。透過科爾多瓦 API 接觸的不是可查詢/搜索，你應通知使用者挑選連絡人作為對 contacts.pickContact 這將打開的 '人' 應用程式的調用，使用者必須選擇一個連絡人。返回任何連絡人是唯讀，因此您的應用程式不能修改它們。
		Windows 8 連絡人是唯讀的。透過科爾多瓦 API 接觸的不是可查詢/搜索，您應通知使用者挑選連絡人作為調用 contacts.pickContact，將會打開 '人' 的應用程式，使用者必須選擇一個連絡人。返回任何連絡人是唯讀，因此您的應用程式不能修改它們。

		@@ -80,5 +88,5 @@ ## navigator.contacts

		`navigator.contacts.create`方法是同步的並返回一個新的 `Contact` 物件。
		`navigator.contacts.create` 方法是同步的並返回一個新的 `Contact` 物件。

		這種方法不會保留在設備的連絡人資料庫中，您需要為其調用該連絡人物件 `Contact.save` 的方法。
		此方法將不會保留在設備連絡人資料庫中，需要調用 `Contact.save` 方法的聯繫物件。

		@@ -100,23 +108,25 @@ ### 支援的平臺

		`navigator.contacts.find`方法以非同步方式，執行設備的連絡人資料庫查詢並返回一個陣列的 `Contact` 物件。生成的物件被傳遞給 `contactSuccess` 的contactSuccess參數所指定的回呼函數。
		`navigator.contacts.find` 方法以非同步方式，執行設備連絡人資料庫查詢並返回 `Contact` 物件的陣列。生成的物件被傳遞到由 contactSuccess 參數指定的 `contactSuccess` 回呼函數。

		ContactFields參數指定的欄位用作搜索的限定詞。一個長度為零的contactFields參數是不正確結果在 `ContactError.INVALID_ARGUMENT_ERROR` 。 ContactFields值為 `"*"` 返回所有連絡人欄位。
		contactFields 參數指定的欄位用作搜索限定詞。長度為零的 contactFields 參數是不正確並導致 `ContactError.INVALID_ARGUMENT_ERROR`。 contactFields 值為 `"*"` 搜索所有連絡人欄位。

		ContactFindOptions.filter字串查詢連絡人資料庫時，可以用作搜索篩選器。如果提供，不區分大小寫，部分值匹配被應用於在contactFields參數中指定的每個欄位。如果有任何指定的欄位的匹配，則返回該連絡人。使用contactFindOptions.desiredFields參數來控制哪些連絡人屬性必須回來。
		在連絡人資料庫查詢時，contactFindOptions.filter 字串可以用作搜索篩選器。如果提供，不區分大小寫，部分值匹配被適用于在 contactFields 參數中指定的每個欄位。如果存在匹配的任何指定的欄位，則返回連絡人。使用 contactFindOptions.desiredFields 參數來控制哪些連絡人屬性必須回來。

		### 參數

		* contactSuccess：從資料庫返回成功回呼函數調用時使用的連絡人物件的陣列。[要求]
		* contactFields： '連絡人' 欄位用作搜索限定詞。(DOMString[]) [Required]

		* contactSuccess：從資料庫返回的成功回呼函數調用時使用的連絡人物件的陣列。[Required]

		* contactError：錯誤回呼函數，當發生錯誤時調用。[可選]

		* contactFields：連絡人欄位使用作為搜索的限定詞。(DOMString[])[要求]

		* contactFindOptions: 搜索選項來篩選 navigator.contacts。[可選]鍵包括：

		* 篩選器：用來查找 navigator.contacts 的搜索字串。() DOMString（預設值：`""`)

		* 多個：確定是否查找操作返回多個 navigator.contacts。（布林）（預設值：`false`)
		* contactFindOptions：搜索選項來篩選 navigator.contacts。[Optional]

		* desiredFields: 聯繫要回返回的欄位。如果指定了，生成的 `Contact` 物件只能使用這些欄位的值。(DOMString[])[可選]
		鍵包括：

		* filter：用來找到 navigator.contacts 的搜索字串。() DOMString（預設： `""`)

		* multiple：確定是否查找操作返回多個 navigator.contacts。(布林值)（預設值： `false`)

		* desiredFields： '連絡人' 欄位，又折回來。如果指定，由此產生的 `Contact` 物件只有這些欄位的功能值。(DOMString[]) [Optional]

		@@ -157,3 +167,3 @@ ### 支援的平臺

		`navigator.contacts.pickContact`方法啟動連絡人選擇器來選擇一個連絡人。所產生的物件傳遞給 `contactSuccess` 的contactSuccess參數所指定的回呼函數。
		`navigator.contacts.pickContact` 方法啟動連絡人選取器來選擇一個連絡人。將生成的物件傳遞給 contactSuccess 參數所指定的 `contactSuccess` 回呼函數。

		@@ -185,5 +195,5 @@ ### 參數

		`Contact`物件表示使用者的連絡人。連絡人可以創建、存儲，或從設備的連絡人資料庫中刪除。連絡人可以也被 (單獨或批量）從資料庫中檢索通過調用 `navigator.contacts.find` 方法。
		`Contact` 物件表示使用者的連絡人。可以創建、存儲，或從設備的連絡人資料庫中刪除連絡人。連絡人可以也被（單獨或批量）從資料庫中檢索通過調用 `navigator.contacts.find` 方法。

		注意：並不是所有上面列出的連絡人欄位平臺支援的每個設備。請檢查每個平臺的怪癖節瞭解詳細資訊。
		注：並不是所有上面列出的連絡人欄位支援的每個設備的平臺。請檢查每個平臺的怪癖節瞭解詳細資訊。

		@@ -194,25 +204,25 @@ ### 屬性

		* 顯示名稱：此連絡人，適合於向最終使用者顯示的名稱。() DOMString
		* displayName：此連絡人，適合於向最終使用者顯示的名稱。() DOMString

		* 名稱：一個物件，包含所有元件的一個人的名字。（連絡人姓名）
		* name：一個物件，包含所有元件的一個人的名字。（連絡人姓名）

		* 昵稱：休閒的位址連絡人名稱。() DOMString
		* nickname：休閒的位址連絡人名稱。() DOMString

		* 手機號碼：陣列的所有連絡人的電話號碼。(ContactField[])
		* phoneNumbers：陣列的所有連絡人的電話號碼。(ContactField[])

		* 電子郵件：所有連絡人的電子郵件地址的陣列。(ContactField[])
		* emails：所有連絡人的電子郵件地址的陣列。(ContactField[])

		* 位址：該連絡人的所有位址的陣列。(ContactAddress[])
		* addresses：該連絡人的所有位址的陣列。(ContactAddress[])

		* ims：所有連絡人的 IM 位址的陣列。(ContactField[])

		* 組織：該連絡人的所有組織的陣列。(ContactOrganization[])
		* organizations：該連絡人的所有組織的陣列。(ContactOrganization[])

		* 生日：連絡人的生日。（日期）
		* birthday：連絡人的生日。(Date)

		* 注意：注意有關的聯繫。() DOMString
		* note：注意有關的聯繫。() DOMString

		* 照片：陣列的連絡人的照片。(ContactField[])
		* photos：陣列的連絡人的照片。(ContactField[])

		* 類別：陣列與連絡人關聯的所有使用者定義的類別。(ContactField[])
		* categories：陣列與連絡人關聯的所有使用者定義的類別。(ContactField[])

		@@ -223,7 +233,7 @@ * url：陣列與連絡人關聯的 web 頁。(ContactField[])

		* 克隆：返回一個新的 `Contact` 物件就是調用物件的深層副本 `id` 屬性設置為`null`.
		* clone：返回一個新的 `Contact` 物件就是調用物件的深層副本 `id` 屬性設置為`null`.

		* 刪除：從設備的連絡人資料庫中刪除連絡人，否則執行錯誤回檔與 `ContactError` 物件。
		* remove：從設備的連絡人資料庫中刪除連絡人，否則執行錯誤回檔與 `ContactError` 物件。

		* 保存：將一個新的連絡人保存到設備的連絡人資料庫中，或更新現有的連絡人，如果已存在具有相同id的連絡人。
		* save：將一個新的連絡人保存到設備的連絡人資料庫中，或更新現有的連絡人，如果已存在具有相同 id 的連絡人。

		@@ -291,3 +301,3 @@ ### 支援的平臺

		* 類別：不支援 Android 2.X 在設備上，返回`null`.
		* categories：不支援 Android 2.X 在設備上，返回`null`.

		@@ -300,69 +310,69 @@ ### 黑莓 10 的怪癖

		* 類別：部分支援。返回欄位設定和類型`null`
		* categories：部分支援。返回欄位pref和type`null`

		* ims：不支援

		* 照片：不支援
		* photos：不支援

		### iOS 的怪癖

		* 顯示名稱：上返回的 iOS 不支援 `null` 除非有沒有 `ContactName` 指定，在這種情況下它將返回複合名稱，昵稱或 `""` ，分別。
		* displayName：上返回的 iOS 不支援 `null` 除非有沒有 `ContactName` 指定，在這種情況下它將返回複合名稱，nickname或 `""` ，分別。

		* 生日：必須輸入 JavaScript 作為 `Date` 物件，它將返回相同的方式。
		* birthday：必須輸入 JavaScript 作為 `Date` 物件，它將返回相同的方式。

		* 照片：返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。當應用程式退出時刪除臨時目錄的內容。
		* photos：返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。當應用程式退出時刪除臨時目錄的內容。

		* 類別：目前不支援此屬性，返回`null`.
		* categories：目前不支援此屬性，返回`null`.

		### Windows Phone 7 和 8 的怪癖

		* 顯示名稱：當創建一個連絡人，提供的顯示名稱參數不同于顯示名稱的值檢索查找連絡人時。
		* displayName：當創建一個連絡人，提供的顯示名稱參數不同于顯示名稱的值檢索查找連絡人時。

		* url：當創建一個連絡人，使用者可以輸入和保存多個 web 位址，但只有一個是可用的搜索連絡人時。

		* 聯繫電話嘛：究竟選項不受支援。在查找操作中不是支援的類型。只有一個 `phoneNumber` 允許的每個類型.
		* phoneNumbers：pref選項不受支援。在type操作中不是支援的find。只有一個 `phoneNumber` 允許的每個type.

		* 電子郵件：究竟選項不受支援。家庭和個人使用引用同一電子郵件項。只有一項是允許的每個類型.
		* emails：pref選項不受支援。家庭和個人使用引用同一電子郵件項。只有一項是允許的每個type.

		* 位址：僅支援的工作和家庭/個人類型。家庭和個人類型引用相同的位址條目。只有一項是允許的每個類型.
		* addresses：僅支援的工作和家庭/個人type。家庭和個人type引用相同的位址條目。只有一項是允許的每個type.

		* 組織：唯一一個允許的和不支援的那個 + 號、類型和部門的屬性。
		* organizations：唯一一個允許的和不支援的pref、type和department的屬性。

		* 注意：不支援，返回`null`.
		* note：不支援，返回`null`.

		* ims：不受支援，返回`null`.

		* 生日: 不受支援，返回`null`.
		* birthdays: 不受支援，返回`null`.

		* 類別：不受支援，返回`null`.
		* categories：不受支援，返回`null`.

		### Windows 的怪癖

		* 照片：返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。
		* photos：返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。

		* 生日: 不受支援，返回`null`.
		* birthdays: 不受支援，返回`null`.

		* 類別：不受支援，返回`null`.
		* categories：不受支援，返回`null`.

		## ContactAddress

		`ContactAddress`物件存儲的單一位址的連絡人的屬性。 A `Contact` 物件可能包括多個位址在 `ContactAddress[]` 陣列。
		`ContactAddress` 物件存儲單個位址的連絡人的屬性。 `Contact` 物件可能包括多個位址 `ContactAddress []` 陣列中。

		### 屬性

		* 那個 + 號：設置為 `true` 如果這個 `ContactAddress` 包含使用者的首選的價值。（布林）
		* pref：設置為 `true` 如果這個 `ContactAddress` 包含使用者的首選的價值。（Boolean）

		* 類型：一個字串，例如指示哪種類型的欄位，這是回家。() DOMString
		* type：一個字串，例如指示哪種類型的欄位，這是home。() DOMString

		* 格式：顯示格式的完整位址。() DOMString
		* formatted：顯示格式的完整位址。() DOMString

		* streetAddress：完整的街道位址。() DOMString

		* 地點：城市或地點。() DOMString
		* locality：城市或地點。() DOMString

		* 區域：國家或地區。() DOMString
		* region：國家或地區。() DOMString

		* 郵遞區號：郵遞區號。() DOMString
		* postalCode：郵遞區號。() DOMString

		* 國家：國家名稱。() DOMString
		* country：國家名稱。() DOMString

		@@ -412,47 +422,47 @@ ### 支援的平臺

		* 究竟: 不受支援，返回 `false` Android 2.X 的設備上。
		* pref: 不受支援，返回 `false` Android 2.X 的設備上。

		### 黑莓 10 的怪癖

		* 設定：在返回的黑莓設備上不支援`false`.
		* pref：在返回的黑莓設備上不支援`false`.

		* 類型：部分支援。只有一個工作和家裡類型位址可以存儲每個連絡人。
		* type：部分支援。只有一個Word和Home類型位址可以存儲每個連絡人。

		* 格式化：部分支援。返回的串聯的所有黑莓手機位址欄位。
		* formatted：部分支援。返回的串聯的所有黑莓手機位址欄位。

		* streetAddress：支援。返回和串聯組成的黑莓位址 1 位址 2位址欄位。
		* streetAddress：支援。返回和串聯組成的黑莓address1 address2位址欄位。

		* 所在地：支援。黑莓手機城位址欄位中存儲。
		* locality：支援。黑莓手機city位址欄位中存儲。

		* 區域：支援。黑莓stateProvince位址欄位中存儲。
		* region：支援。黑莓stateProvince位址欄位中存儲。

		* 郵遞區號：支援。黑莓zipPostal位址欄位中存儲。
		* postalCode：支援。黑莓zipPostal位址欄位中存儲。

		* 國家：支援。
		* country：支援。

		### FirefoxOS 的怪癖

		* 格式化：目前不支援
		* formatted：目前不支援

		### iOS 的怪癖

		* 那個 + 號：不支援在 iOS 設備上，返回`false`.
		* pref：不支援在 iOS 設備上，返回`false`.

		* 格式化：目前不支援。
		* formatted：目前不支援。

		### Windows 8 的怪癖

		* 那個 + 號：不支援
		* pref：不支援

		### Windows 的怪癖

		* 那個 + 號：不支援
		* pref：不支援

		## ContactError

		`ContactError`物件返回到使用者通過 `contactError` 發生錯誤時的回呼函數。
		當發生錯誤時，通過 `contactError` 回呼函數為使用者情況下會返回的 `ContactError` 物件。

		### 屬性

		* 代碼：下面列出的預定義的錯誤代碼之一。
		* code：下面列出的預定義的錯誤代碼之一。

		@@ -471,13 +481,13 @@ ### 常量

		`ContactField`物件是可重用的元件代表一般連絡人欄位。每個 `ContactField` 物件包含 `value` ， `type` ，和 `pref` 屬性。 A `Contact` 物件存儲中的幾個屬性 `ContactField[]` 陣列，例如電話號碼和電子郵件地址。
		`ContactField` 物件是可重用的元件代表一般連絡人欄位。每個 `ContactField` 物件包含一個 `value`、 `type` 和 `pref` 的屬性。 `Contacat` 物件將幾個屬性存儲在 `ContactField []` 陣列，例如電話號碼和電子郵件地址。

		在大多數情況下，有沒有預先確定的值 `ContactField` 物件的type屬性。例如，電話號碼可以指定類型的家庭、工作、手機、 iPhone或由一個特定的設備平臺接觸資料庫系統支援的任何其他值的值。然而，對於 `Contact` 的照片欄位，類型欄位指示返回圖像的格式： url的值屬性包含的照片圖像或base64的 URL 時的值包含一個 base64 編碼圖像字串時。
		在大多數情況下，沒有預先確定的 `ContactField` 物件的 type 屬性值。例如，一個電話號碼可以指定 type 值的 home、 work、 mobile、 iPhone 或由一個特定的設備平臺接觸資料庫系統支援的任何其他值。然而，為 `photos` 照片欄位中，type 欄位指示返回圖像的格式：當 value 屬性包含一個指向的照片圖像或 base64 URL 時的 value 包含 string base64 編碼的圖像的 url。

		### 屬性

		* 類型：一個字串，例如指示哪種類型的欄位，這是回家。() DOMString
		* type：一個字串，例如指示哪種類型的欄位，這是home。() DOMString

		* 價值：欄位的值，如電話號碼或電子郵件地址。() DOMString
		* value：欄位的值，如電話號碼或電子郵件地址。() DOMString

		* 那個 + 號：設置為 `true` 如果這個 `ContactField` 包含使用者的首選的價值。（布林）
		* pref：設置為 `true` 如果這個 `ContactField` 包含使用者的首選的價值。（布林）

		@@ -513,37 +523,37 @@ ### 支援的平臺

		* 上一頁: 不受支援，返回`false`.
		* pref: 不受支援，返回`false`.

		### 黑莓 10 的怪癖

		* 類型：部分支援。使用的電話號碼。
		* type：部分支援。使用的電話號碼。

		* 價值：支援。
		* value：支援。

		* 究竟: 不受支援，返回`false`.
		* pref: 不受支援，返回`false`.

		### iOS 的怪癖

		* 究竟: 不受支援，返回`false`.
		* pref: 不受支援，返回`false`.

		### Windows8 的怪癖

		* 究竟: 不受支援，返回`false`.
		* pref: 不受支援，返回`false`.

		### Windows 的怪癖

		* 究竟: 不受支援，返回`false`.
		* pref: 不受支援，返回`false`.

		## 連絡人姓名
		## ContactName

		關於包含不同種類的資訊 `Contact` 物件的名稱。
		包含不同種類的 `Contact` 物件名稱有關的資訊。

		### 屬性

		* 格式化：該連絡人的完整名稱。() DOMString
		* formatted：該連絡人的完整名稱。() DOMString

		* 字體集：連絡人的姓氏。() DOMString
		* familyName：連絡人的姓氏。() DOMString

		* givenName：連絡人的名字。() DOMString

		* 連絡人：連絡人的中間名。() DOMString
		* middleName：連絡人的中間名。() DOMString

		@@ -557,3 +567,3 @@ * honorificPrefix：連絡人的首碼（例如先生或博士） (DOMString)
		* 亞馬遜火 OS
		* Android 2.X
		* Android 系統
		* 黑莓 10
		@@ -591,13 +601,13 @@ * 火狐瀏覽器的作業系統

		* 格式化：部分受支援，並為唯讀。返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
		* formatted：部分受支援，並為唯讀。返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.

		### 黑莓 10 的怪癖

		* 格式化：部分支援。返回的串聯的黑莓手機名字和姓氏欄位。
		* formatted：部分支援。返回的串聯的黑莓手機firstName和lastName欄位。

		* 字體集：支援。黑莓姓氏欄位中存儲。
		* familyName：支援。黑莓lastName欄位中存儲。

		* givenName：支援。黑莓名字欄位中存儲。
		* givenName：支援。黑莓firstName欄位中存儲。

		* 連絡人: 不受支援，返回`null`.
		* middleName: 不受支援，返回`null`.

		@@ -610,17 +620,17 @@ * honorificPrefix: 不受支援，返回`null`.

		* 格式化：部分受支援，並為唯讀。返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
		* formatted：部分受支援，並為唯讀。返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.

		### iOS 的怪癖

		* 格式化：部分支援。返回 iOS 複合名稱，但為唯讀。
		* formatted：部分支援。返回 iOS 複合名稱，但為唯讀。

		### Windows 8 的怪癖

		* 格式：這是唯一名稱屬性，並且是相同的 `displayName` ，和`nickname`
		* formatted：這是唯一名稱屬性，並且是相同的 `displayName` ，和`nickname`

		* 字體集：不支援
		* familyName：不支援

		* givenName：不支援

		* 連絡人：不支援
		* middleName：不支援

		@@ -633,19 +643,19 @@ * honorificPrefix: 不支援

		* 格式：它是完全相同`displayName`
		* formatted：它是完全相同`displayName`

		## ContactOrganization

		`ContactOrganization`物件存儲連絡人的組織屬性。A `Contact` 物件存儲一個或多個 `ContactOrganization` 陣列中的物件。
		`ContactOrganization` 物件存儲連絡人的組織屬性。`Contact` 物件將一個或多個 `ContactOrganization` 物件存儲在一個陣列中。

		### 屬性

		* 那個 + 號：設置為 `true` 如果這個 `ContactOrganization` 包含使用者的首選的價值。（布林）
		* pref：設置為 `true` 如果這個 `ContactOrganization` 包含使用者的首選的價值。（布林）

		* 類型：一個字串，例如指示哪種類型的欄位，這是回家。_(DOMString)
		* type：一個字串，例如指示哪種類型的欄位，這是回家。_(DOMString)

		* 名稱：組織的名稱。() DOMString
		* name：組織的名稱。() DOMString

		* 部門：合同工作為的部門。() DOMString
		* department：合同工作為的部門。() DOMString

		* 標題：在組織連絡人的標題。() DOMString
		* title：在組織連絡人的標題。() DOMString

		@@ -687,42 +697,42 @@ ### 支援的平臺

		* 那個 + 號：不支援的 Android 2.X 的設備，返回`false`.
		* pref：不支援的 Android 2.X 的設備，返回`false`.

		### 黑莓 10 的怪癖

		* 那個 + 號：不支援的黑莓手機，返回`false`.
		* pref：不支援的黑莓手機，返回`false`.

		* 類型：不支援的黑莓手機，返回`null`.
		* type：不支援的黑莓手機，返回`null`.

		* 名稱：部分支援。第一次組織名稱存儲在黑莓公司欄位中。
		* name：部分支援。第一次組織名稱存儲在黑莓company欄位中。

		* 部: 不受支援，返回`null`.
		* department: 不受支援，返回`null`.

		* 標題：部分支援。第一次組織標題存儲在欄位中黑莓渺小。
		* title：部分支援。第一次組織標題存儲在欄位中黑莓jobTitle。

		### 火狐瀏覽器作業系統的怪癖

		* 那個 + 號：不支援
		* pref：不支援

		* 類型：不支援
		* type：不支援

		* 部門：不支援
		* department：不支援

		* 欄位名稱和標題存儲在組織結構圖和渺小.
		* 欄位name和title存儲在org和jobTitle.

		### iOS 的怪癖

		* 那個 + 號：不支援在 iOS 設備上，返回`false`.
		* pref：不支援在 iOS 設備上，返回`false`.

		* 類型：不支援在 iOS 設備上，返回`null`.
		* type：不支援在 iOS 設備上，返回`null`.

		* 名稱：部分支援。第一次組織名稱存儲在 iOS kABPersonOrganizationProperty欄位中。
		* name：部分支援。第一次組織名稱存儲在 iOS kABPersonOrganizationProperty欄位中。

		* 部門：部分支援。第一部門名稱存儲在 iOS kABPersonDepartmentProperty欄位中。
		* department：部分支援。第一部門名稱存儲在 iOS kABPersonDepartmentProperty欄位中。

		* 標題：部分支援。第一個標題存儲在 iOS kABPersonJobTitleProperty欄位中。
		* title：部分支援。第一個標題存儲在 iOS kABPersonJobTitleProperty欄位中。

		### Windows 的怪癖

		* 究竟: 不受支援，返回`false`.
		* pref: 不受支援，返回`false`.

		* 類型：不受支援，返回`null`.
		* type：不受支援，返回`null`.

package.json

		{
		"name": "cordova-plugin-contacts",
		"version": "0.2.16",
		"description": "Cordova Contacts Plugin",
		"cordova": {
		"id": "org.apache.cordova.contacts",
		"platforms": [
		"android",
		"amazon-fireos",
		"ubuntu",
		"ios",
		"blackberry10",
		"wp7",
		"wp8",
		"firefoxos",
		"windows8",
		"windows"
		]
		},
		"repository": {
		"type": "git",
		"url": "https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git"
		},
		"keywords": [
		"cordova",
		"contacts",
		"ecosystem:cordova",
		"cordova-android",
		"cordova-amazon-fireos",
		"cordova-ubuntu",
		"cordova-ios",
		"cordova-blackberry10",
		"cordova-wp7",
		"cordova-wp8",
		"cordova-firefoxos",
		"cordova-windows8",
		"cordova-windows"
		],
		"author": "Apache Software Foundation",
		"license": "Apache 2.0"
		}
		"name": "cordova-plugin-contacts",
		"version": "1.0.0",
		"description": "Cordova Contacts Plugin",
		"cordova": {
		"id": "cordova-plugin-contacts",
		"platforms": [
		"android",
		"amazon-fireos",
		"ubuntu",
		"ios",
		"blackberry10",
		"wp7",
		"wp8",
		"firefoxos",
		"windows8",
		"windows"
		]
		},
		"repository": {
		"type": "git",
		"url": "https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git"
		},
		"keywords": [
		"cordova",
		"contacts",
		"ecosystem:cordova",
		"cordova-android",
		"cordova-amazon-fireos",
		"cordova-ubuntu",
		"cordova-ios",
		"cordova-blackberry10",
		"cordova-wp7",
		"cordova-wp8",
		"cordova-firefoxos",
		"cordova-windows8",
		"cordova-windows"
		],
		"author": "Apache Software Foundation",
		"license": "Apache 2.0"
		}

757

README.md

		@@ -20,4 +20,757 @@ <!---

		# org.apache.cordova.contacts
		# cordova-plugin-contacts

		Plugin documentation: [doc/index.md](doc/index.md)
		[![Build Status](https://travis-ci.org/apache/cordova-plugin-contacts.svg)](https://travis-ci.org/apache/cordova-plugin-contacts)

		This plugin defines a global `navigator.contacts` object, which provides access to the device contacts database.

		Although the object is attached to the global scoped `navigator`, it is not available until after the `deviceready` event.

		document.addEventListener("deviceready", onDeviceReady, false);
		function onDeviceReady() {
		console.log(navigator.contacts);
		}

		__WARNING__: Collection and use of contact data raises
		important privacy issues. Your app's privacy policy should discuss
		how the app uses contact data and whether it is shared with any other
		parties. Contact information is considered sensitive because it
		reveals the people with whom a person communicates. Therefore, in
		addition to the app's privacy policy, you should strongly consider
		providing a just-in-time notice before the app accesses or uses
		contact data, if the device operating system doesn't do so
		already. That notice should provide the same information noted above,
		as well as obtaining the user's permission (e.g., by presenting
		choices for __OK__ and __No Thanks__). Note that some app
		marketplaces may require the app to provide a just-in-time notice and
		obtain the user's permission before accessing contact data. A
		clear and easy-to-understand user experience surrounding the use of
		contact data helps avoid user confusion and perceived misuse of
		contact data. For more information, please see the Privacy Guide.

		## Installation

		cordova plugin add cordova-plugin-contacts

		### Firefox OS Quirks

		Create __www/manifest.webapp__ as described in
		[Manifest Docs](https://developer.mozilla.org/en-US/Apps/Developing/Manifest).
		Add relevant permisions.
		There is also a need to change the webapp type to "privileged" - [Manifest Docs](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type).
		__WARNING__: All privileged apps enforce [Content Security Policy](https://developer.mozilla.org/en-US/Apps/CSP) which forbids inline script. Initialize your application in another way.

		"type": "privileged",
		"permissions": {
		"contacts": {
		"access": "readwrite",
		"description": "Describe why there is a need for such permission"
		}
		}

		### Windows Quirks

		Any contacts returned from `find` and `pickContact` methods are readonly, so your application cannot modify them.
		`find` method available only on Windows Phone 8.1 devices.

		### Windows 8 Quirks

		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.pickContact which will open the 'People' app where the user must choose a contact.
		Any contacts returned are readonly, so your application cannot modify them.

		## navigator.contacts

		### Methods

		- navigator.contacts.create
		- navigator.contacts.find
		- navigator.contacts.pickContact

		### Objects

		- Contact
		- ContactName
		- ContactField
		- ContactAddress
		- ContactOrganization
		- ContactFindOptions
		- ContactError
		- ContactFieldType

		## navigator.contacts.create

		The `navigator.contacts.create` method is synchronous, and returns a new `Contact` object.

		This method does not retain the Contact object in the device contacts
		database, for which you need to invoke the `Contact.save` method.

		### Supported Platforms

		- Android
		- BlackBerry 10
		- Firefox OS
		- iOS
		- Windows Phone 7 and 8

		### Example

		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.
		The resulting objects are passed to the `contactSuccess` callback
		function specified by the __contactSuccess__ parameter.

		The __contactFields__ parameter specifies the fields to be used as a
		search qualifier. A zero-length __contactFields__ parameter is invalid and results in
		`ContactError.INVALID_ARGUMENT_ERROR`. A __contactFields__ value of
		`"*"` searches all contact fields.

		The __contactFindOptions.filter__ string can be used as a search
		filter when querying the contacts database. If provided, a
		case-insensitive, partial value match is applied to each field
		specified in the __contactFields__ parameter. If there's a match for
		_any_ of the specified fields, the contact is returned. Use __contactFindOptions.desiredFields__
		parameter to control which contact properties must be returned back.

		### Parameters

		- __contactFields__: Contact fields to use as a search qualifier. _(DOMString[])_ [Required]

		- __contactSuccess__: Success callback function invoked with the array of Contact objects returned from the database. [Required]

		- __contactError__: Error callback function, invoked when an error occurs. [Optional]

		- __contactFindOptions__: Search options to filter navigator.contacts. [Optional]

		Keys include:

		- __filter__: The search string used to find navigator.contacts. _(DOMString)_ (Default: `""`)

		- __multiple__: Determines if the find operation returns multiple navigator.contacts. _(Boolean)_ (Default: `false`)

		- __desiredFields__: Contact fields to be returned back. If specified, the resulting `Contact` object only features values for these fields. _(DOMString[])_ [Optional]

		### Supported Platforms

		- Android
		- BlackBerry 10
		- Firefox OS
		- iOS
		- Windows Phone 7 and 8
		- Windows (Windows Phone 8.1 devices only)

		### Example

		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(fields, onSuccess, onError, options);

		### Windows Quirks

		- `__contactFields__` is not supported and will be ignored. `find` method will always attempt to match the name, email address, or phone number of a contact.

		## navigator.contacts.pickContact

		The `navigator.contacts.pickContact` method launches the Contact Picker to select a single contact.
		The resulting object is passed to the `contactSuccess` callback
		function specified by the __contactSuccess__ parameter.

		### Parameters

		- __contactSuccess__: Success callback function invoked with the single Contact object. [Required]

		- __contactError__: Error callback function, invoked when an error occurs. [Optional]

		### Supported Platforms

		- Android
		- iOS
		- Windows Phone 8
		- Windows 8
		- Windows

		### Example

		navigator.contacts.pickContact(function(contact){
		console.log('The following contact has been selected:' + JSON.stringify(contact));
		},function(err){
		console.log('Error: ' + err);
		});

		## Contact

		The `Contact` object represents a user's contact. Contacts can be
		created, stored, or removed from the device contacts database.
		Contacts can also be retrieved (individually or in bulk) from the
		database by invoking the `navigator.contacts.find` method.

		__NOTE__: Not all of the contact fields listed above are supported on
		every device platform. Please check each platform's _Quirks_ section
		for details.


		### Properties

		- __id__: A globally unique identifier. _(DOMString)_

		- __displayName__: The name of this Contact, suitable for display to end users. _(DOMString)_

		- __name__: An object containing all components of a persons name. _(ContactName)_

		- __nickname__: A casual name by which to address the contact. _(DOMString)_

		- __phoneNumbers__: An array of all the contact's phone numbers. _(ContactField[])_

		- __emails__: An array of all the contact's email addresses. _(ContactField[])_

		- __addresses__: An array of all the contact's addresses. _(ContactAddress[])_

		- __ims__: An array of all the contact's IM addresses. _(ContactField[])_

		- __organizations__: An array of all the contact's organizations. _(ContactOrganization[])_

		- __birthday__: The birthday of the contact. _(Date)_

		- __note__: A note about the contact. _(DOMString)_

		- __photos__: An array of the contact's photos. _(ContactField[])_

		- __categories__: An array of all the user-defined categories associated with the contact. _(ContactField[])_

		- __urls__: An array of web pages associated with the contact. _(ContactField[])_

		### Methods

		- __clone__: Returns a new `Contact` object that is a deep copy of the calling object, with the `id` property set to `null`.

		- __remove__: Removes the contact from the device contacts database, otherwise executes an error callback with a `ContactError` object.

		- __save__: Saves a new contact to the device contacts database, or updates an existing contact if a contact with the same __id__ already exists.

		### Supported Platforms

		- Amazon Fire OS
		- Android
		- BlackBerry 10
		- Firefox OS
		- iOS
		- Windows Phone 7 and 8
		- Windows 8
		- Windows

		### 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);


		### Android 2.X Quirks

		- __categories__: Not supported on Android 2.X devices, returning `null`.

		### BlackBerry 10 Quirks

		- __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 Quirks

		- __displayName__: Not supported on iOS, returning `null` unless there is no `ContactName` specified, in which case it returns the composite name, __nickname__ or `""`, respectively.

		- __birthday__: Must be input as a JavaScript `Date` object, the same way it is returned.

		- __photos__: Returns a File URL to the image, which is stored in the application's temporary directory. Contents of the temporary directory are removed when the application exits.

		- __categories__: This property is currently not supported, returning `null`.

		### Windows Phone 7 and 8 Quirks

		- __displayName__: When creating a contact, the value provided for the display name parameter differs from the display name retrieved when finding the contact.

		- __urls__: When creating a contact, users can input and save more than one web address, but only one is available when searching the contact.

		- __phoneNumbers__: The _pref_ option is not supported. The _type_ is not supported in a _find_ operation. Only one `phoneNumber` is allowed for each _type_.

		- __emails__: The _pref_ option is not supported. Home and personal references same email entry. Only one entry is allowed for each _type_.

		- __addresses__: Supports only work, and home/personal _type_. The home and personal _type_ reference the same address entry. Only one entry is allowed for each _type_.

		- __organizations__: Only one is allowed, and does not support the _pref_, _type_, and _department_ attributes.

		- __note__: Not supported, returning `null`.

		- __ims__: Not supported, returning `null`.

		- __birthdays__: Not supported, returning `null`.

		- __categories__: Not supported, returning `null`.

		- __remove__: Method is not supported

		### Windows Quirks

		- __photos__: Returns a File URL to the image, which is stored in the application's temporary directory.

		- __birthdays__: Not supported, returning `null`.

		- __categories__: Not supported, returning `null`.

		- __remove__: Method is not supported

		## ContactAddress

		The `ContactAddress` object stores the properties of a single address
		of a contact. A `Contact` object may include more than one address in
		a `ContactAddress[]` array.


		### Properties

		- __pref__: Set to `true` if this `ContactAddress` contains the user's preferred value. _(boolean)_

		- __type__: A string indicating what type of field this is, _home_ for example. _(DOMString)_

		- __formatted__: The full address formatted for display. _(DOMString)_

		- __streetAddress__: The full street address. _(DOMString)_

		- __locality__: The city or locality. _(DOMString)_

		- __region__: The state or region. _(DOMString)_

		- __postalCode__: The zip code or postal code. _(DOMString)_

		- __country__: The country name. _(DOMString)_

		### Supported Platforms

		- Amazon Fire OS
		- Android
		- BlackBerry 10
		- Firefox OS
		- iOS
		- Windows Phone 7 and 8
		- Windows 8
		- Windows

		### Example

		// 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 Quirks

		- __pref__: Not supported, returning `false` on Android 2.X devices.

		### BlackBerry 10 Quirks

		- __pref__: Not supported on BlackBerry devices, returning `false`.

		- __type__: Partially supported. Only one each of _Work_ and _Home_ type addresses can be stored per contact.

		- __formatted__: Partially supported. Returns a concatenation of all BlackBerry address fields.

		- __streetAddress__: Supported. Returns a concatenation of BlackBerry __address1__ and __address2__ address fields.

		- __locality__: Supported. Stored in BlackBerry __city__ address field.

		- __region__: Supported. Stored in BlackBerry __stateProvince__ address field.

		- __postalCode__: Supported. Stored in BlackBerry __zipPostal__ address field.

		- __country__: Supported.

		### FirefoxOS Quirks

		- __formatted__: Currently not supported

		### iOS Quirks

		- __pref__: Not supported on iOS devices, returning `false`.

		- __formatted__: Currently not supported.

		### Windows 8 Quirks

		- __pref__: Not supported

		### Windows Quirks

		- __pref__: Not supported


		## ContactError

		The `ContactError` object is returned to the user through the
		`contactError` callback function when an error occurs.

		### Properties

		- __code__: One of the predefined error codes listed below.

		### Constants

		- `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

		The `ContactField` object is a reusable component that represents
		contact fields generically. Each `ContactField` object contains a
		`value`, `type`, and `pref` property. A `Contact` object stores
		several properties in `ContactField[]` arrays, such as phone numbers
		and email addresses.

		In most instances, there are no pre-determined values for a
		`ContactField` object's __type__ attribute. For example, a phone
		number can specify __type__ values of _home_, _work_, _mobile_,
		_iPhone_, or any other value that is supported by a particular device
		platform's contact database. However, for the `Contact` __photos__
		field, the __type__ field indicates the format of the returned image:
		__url__ when the __value__ attribute contains a URL to the photo
		image, or _base64_ when the __value__ contains a base64-encoded image
		string.

		### Properties

		- __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)_

		### Supported Platforms

		- Amazon Fire OS
		- Android
		- BlackBerry 10
		- Firefox OS
		- iOS
		- Windows Phone 7 and 8
		- Windows 8
		- Windows

		### Example

		// 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 Quirks

		- __pref__: Not supported, returning `false`.

		### BlackBerry 10 Quirks

		- __type__: Partially supported. Used for phone numbers.

		- __value__: Supported.

		- __pref__: Not supported, returning `false`.

		### iOS Quirks

		- __pref__: Not supported, returning `false`.

		### Windows8 Quirks

		- __pref__: Not supported, returning `false`.

		### Windows Quirks

		- __pref__: Not supported, returning `false`.


		## ContactName

		Contains different kinds of information about a `Contact` object's name.

		### Properties

		- __formatted__: The complete name of the contact. _(DOMString)_

		- __familyName__: The contact's family name. _(DOMString)_

		- __givenName__: The contact's given name. _(DOMString)_

		- __middleName__: The contact's middle name. _(DOMString)_

		- __honorificPrefix__: The contact's prefix (example _Mr._ or _Dr._) _(DOMString)_

		- __honorificSuffix__: The contact's suffix (example _Esq._). _(DOMString)_

		### Supported Platforms

		- Amazon Fire OS
		- Android
		- BlackBerry 10
		- Firefox OS
		- iOS
		- Windows Phone 7 and 8
		- Windows 8
		- Windows

		### Example

		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 Quirks

		- __formatted__: Partially supported, and read-only. Returns a concatenation of `honorificPrefix`, `givenName`, `middleName`, `familyName`, and `honorificSuffix`.

		### BlackBerry 10 Quirks

		- __formatted__: Partially supported. Returns a concatenation of BlackBerry __firstName__ and __lastName__ fields.

		- __familyName__: Supported. Stored in BlackBerry __lastName__ field.

		- __givenName__: Supported. Stored in BlackBerry __firstName__ field.

		- __middleName__: Not supported, returning `null`.

		- __honorificPrefix__: Not supported, returning `null`.

		- __honorificSuffix__: Not supported, returning `null`.

		### FirefoxOS Quirks

		- __formatted__: Partially supported, and read-only. Returns a concatenation of `honorificPrefix`, `givenName`, `middleName`, `familyName`, and `honorificSuffix`.


		### iOS Quirks

		- __formatted__: Partially supported. Returns iOS Composite Name, but is read-only.

		### Windows 8 Quirks

		- __formatted__: This is the only name property, and is identical to `displayName`, and `nickname`

		- __familyName__: not supported

		- __givenName__: not supported

		- __middleName__: not supported

		- __honorificPrefix__: not supported

		- __honorificSuffix__: not supported

		### Windows Quirks

		- __formatted__: It is identical to `displayName`


		## ContactOrganization

		The `ContactOrganization` object stores a contact's organization
		properties. A `Contact` object stores one or more
		`ContactOrganization` objects in an array.

		### Properties

		- __pref__: Set to `true` if this `ContactOrganization` contains the user's preferred value. _(boolean)_

		- __type__: A string that indicates what type of field this is, _home_ for example. _(DOMString)

		- __name__: The name of the organization. _(DOMString)_

		- __department__: The department the contract works for. _(DOMString)_

		- __title__: The contact's title at the organization. _(DOMString)_


		### Supported Platforms

		- Android
		- BlackBerry 10
		- Firefox OS
		- iOS
		- Windows Phone 7 and 8
		- Windows (Windows 8.1 and Windows Phone 8.1 devices only)

		### Example

		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 Quirks

		- __pref__: Not supported by Android 2.X devices, returning `false`.

		### BlackBerry 10 Quirks

		- __pref__: Not supported by BlackBerry devices, returning `false`.

		- __type__: Not supported by BlackBerry devices, returning `null`.

		- __name__: Partially supported. The first organization name is stored in the BlackBerry __company__ field.

		- __department__: Not supported, returning `null`.

		- __title__: Partially supported. The first organization title is stored in the BlackBerry __jobTitle__ field.

		### Firefox OS Quirks

		- __pref__: Not supported

		- __type__: Not supported

		- __department__: Not supported

		- Fields __name__ and __title__ stored in __org__ and __jobTitle__.

		### iOS Quirks

		- __pref__: Not supported on iOS devices, returning `false`.

		- __type__: Not supported on iOS devices, returning `null`.

		- __name__: Partially supported. The first organization name is stored in the iOS __kABPersonOrganizationProperty__ field.

		- __department__: Partially supported. The first department name is stored in the iOS __kABPersonDepartmentProperty__ field.

		- __title__: Partially supported. The first title is stored in the iOS __kABPersonJobTitleProperty__ field.

		### Windows Quirks

		- __pref__: Not supported, returning `false`.

		- __type__: Not supported, returning `null`.

RELEASENOTES.md

		@@ -147,1 +147,18 @@ <!--
		* Updated the comments for ContactOrganization constructor.

		### 1.0.0 (Apr 15, 2015)
		* CB-8746 gave plugin major version bump
		* CB-8683 updated wp specific references of old id to new id
		* CB-8683 changed plugin-id to pacakge-name
		* CB-8653 properly updated translated docs to use new id
		* CB-8653 updated translated docs to use new id
		* Use TRAVIS_BUILD_DIR, install paramedic by npm
		* CB-8653 Updated Readme
		* CB-8659: ios: 4.0.x Compatibility: Remove use of initWebView method
		* CB-8659: ios: 4.0.x Compatibility: Remove use of deprecated headers
		* CB-8604 Pended unsupported test for wp8, updated documentation
		* CB-8561 Integrate TravisCI
		* CB-8438 cordova-plugin-contacts documentation translation: cordova-plugin-contacts
		* CB-8538 Added package.json file
		* windows: pended .remove test as it is not supported on windows
		* CB-8395 marked unsupported tests pending on wp8

tests/tests.js

		@@ -115,11 +115,6 @@ /*
		// also this test will be skipped for Windows Phone 8.1 because function "save" not supported on WP8.1
		if (isWindows) {
		if (isWindows \|\| isWindowsPhone8) {
		pending();
		return;
		}

		if (isWindowsPhone8) {
		done();
		return;
		}
		var foundName = function(result) {
		@@ -298,10 +293,6 @@ var bFound = false;
		// Save method is not supported on Windows platform
		if (isWindows) {
		if (isWindows \|\| isWindowsPhone8) {
		pending();
		return;
		}
		if (isWindowsPhone8) {
		done();
		return;
		}

		var bDay = new Date(1976, 6,4);
		@@ -331,10 +322,6 @@ gContactObj = navigator.contacts.create({"gender": "male", "note": "my note", "name": {"familyName": "Delete", "givenName": "Test"}, "emails": [{"value": "here@there.com"}, {"value": "there@here.com"}], "birthday": bDay});
		// Save method is not supported on Windows platform
		if (isWindows) {
		if (isWindows \|\| isWindowsPhone8) {
		pending();
		return;
		}
		if (isWindowsPhone8) {
		done();
		return;
		}

		expect(gContactObj).toBeDefined();
		@@ -379,2 +366,6 @@
		it("contacts.spec.23 calling remove on a contact that does not exist should return ContactError.UNKNOWN_ERROR", function(done) {
		// remove method is not supported on Windows platform
		if (isWindows \|\| isWindowsPhone8) {
		pending();
		}
		var rmWin = fail;
		@@ -397,10 +388,6 @@ var rmFail = function(result) {
		// Save method is not supported on Windows platform
		if (isWindows) {
		if (isWindows \|\| isWindowsPhone8) {
		pending();
		return;
		}
		if (isWindowsPhone8) {
		done();
		return;
		}

		gContactObj = new Contact();
		@@ -407,0 +394,0 @@ gContactObj.name = new ContactName();

doc/index.md

plugin.xml