You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by vi...@apache.org on 2015/06/12 16:39:39 UTC
[3/3] cordova-plugin-contacts git commit: CB-9128
cordova-plugin-contacts documentation translation: cordova-plugin-contacts
CB-9128 cordova-plugin-contacts documentation translation: cordova-plugin-contacts
Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/commit/1871eed4
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/1871eed4
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/1871eed4
Branch: refs/heads/master
Commit: 1871eed4eaa4b6857deeec52954067c568892ced
Parents: 7e224b6
Author: Victor Sosa <vi...@apache.org>
Authored: Fri Jun 12 09:39:30 2015 -0500
Committer: Victor Sosa <vi...@apache.org>
Committed: Fri Jun 12 09:39:30 2015 -0500
----------------------------------------------------------------------
doc/de/README.md | 735 ++++++++++++++++++++++++++++++++++++++++++++++++++
doc/es/README.md | 732 +++++++++++++++++++++++++++++++++++++++++++++++++
doc/fr/README.md | 668 +++++++++++++++++++++++++++++++++++++++++++++
doc/it/README.md | 735 ++++++++++++++++++++++++++++++++++++++++++++++++++
doc/ja/README.md | 735 ++++++++++++++++++++++++++++++++++++++++++++++++++
doc/ko/README.md | 735 ++++++++++++++++++++++++++++++++++++++++++++++++++
doc/pl/README.md | 735 ++++++++++++++++++++++++++++++++++++++++++++++++++
doc/zh/README.md | 735 ++++++++++++++++++++++++++++++++++++++++++++++++++
8 files changed, 5810 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/1871eed4/doc/de/README.md
----------------------------------------------------------------------
diff --git a/doc/de/README.md b/doc/de/README.md
new file mode 100644
index 0000000..676ca2e
--- /dev/null
+++ b/doc/de/README.md
@@ -0,0 +1,735 @@
+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+-->
+
+# cordova-plugin-contacts
+
+[](https://travis-ci.org/apache/cordova-plugin-contacts)
+
+Dieses Plugin definiert eine globale `navigator.contacts`-Objekt bietet Zugriff auf die Geräte-Kontakte-Datenbank.
+
+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 d
er Kontakt-Daten Benutzer Verwirrung zu vermeiden können und wahrgenommene Missbrauch der Kontaktdaten. Weitere Informationen finden Sie in der Datenschutz-Guide.
+
+## Installation
+
+Dies erfordert Cordova 5.0 + (aktuelle stabile v1)
+
+ cordova plugin add cordova-plugin-contacts
+
+
+Ältere Versionen von Cordova können noch über die Id **veraltet** (veraltet v0.2.16) installieren.
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+Es ist auch möglich, über Repo Url direkt zu installieren (unstable)
+
+ cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+
+
+### Firefox OS Macken
+
+Erstellen Sie **www/manifest.webapp**, wie in [Docs Manifest](https://developer.mozilla.org/en-US/Apps/Developing/Manifest) beschrieben. Fügen Sie die entsprechenden Permisions. Es muss auch die Webapp um "privileged" - [Manifest Docs](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type) ändern. **Warnung**: alle privilegierten apps [Content Security Policy](https://developer.mozilla.org/en-US/Apps/CSP), welche Inlineskript verbietet zu erzwingen. Initialisieren Sie die Anwendung auf andere Weise.
+
+ "type": "privileged",
+ "permissions": {
+ "contacts": {
+ "access": "readwrite",
+ "description": "Describe why there is a need for such permission"
+ }
+ }
+
+
+### Windows-Eigenheiten
+
+**Vor Windows 10:** Alle Kontakte von `finden` und `PickContact` -Methoden zurückgegebenen sind Readonly, so dass sie von die Anwendung nicht geändert werden kann. `find`-Methode nur auf Windows Phone 8.1-Geräten verfügbar.
+
+**Windows 10 und höher:** Kontakte können gespeichert werden und in den app-lokale Kontakte-Speicher gespeichert werden. Kontakte können auch gelöscht werden.
+
+### Windows 8 Macken
+
+Windows 8 Kontakte sind Readonly. Über die Cordova-API-Kontakte nicht abgefragt werden/können durchsucht werden, Sie sollten den Benutzer informieren, wählen Sie einen Kontakt als Aufruf an contacts.pickContact, die 'People'-app öffnet, wo muss der Benutzer einen Kontakt auswählen. Alle zurückgegebenen Kontakte sind Readonly, so dass sie von die Anwendung nicht geändert werden kann.
+
+## Navigator.Contacts
+
+### Methoden
+
+ * navigator.contacts.create
+ * navigator.contacts.find
+ * navigator.contacts.pickContact
+
+### Objekte
+
+ * Kontakt
+ * ContactName
+ * ContactField
+ * ContactAddress
+ * ContactOrganization
+ * ContactFindOptions
+ * ContactError
+ * ContactFieldType
+
+## navigator.contacts.create
+
+Die `navigator.contacts.create`-Methode ist synchron und gibt ein neues `Contact` objekt.
+
+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.
+
+### Unterstützte Plattformen
+
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 und 8
+
+### Beispiel
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## navigator.contacts.find
+
+Die `navigator.contacts.find`-Methode 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** 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.
+
+### Parameter
+
+ * **contactFields**: Kontaktfelder als Qualifizierer Suche verwenden. *(DOMString[])* [Required]
+
+ * **contactSuccess**: Erfolg-Callback-Funktion aufgerufen, die mit dem Array von Contact-Objekte aus der Datenbank zurückgegeben. [Required]
+
+ * **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: `""`)
+
+ * **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]
+
+### Unterstützte Plattformen
+
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 und 8
+ * Windows (Windows Phone 8.1 und Windows 10)
+
+### Beispiel
+
+ function onSuccess(contacts) {
+ alert('Found ' + contacts.length + ' contacts.');
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ // find all contacts with 'Bob' in any name field
+ var options = new ContactFindOptions();
+ options.filter = "Bob";
+ options.multiple = true;
+ options.desiredFields = [navigator.contacts.fieldType.id];
+ var fields = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+ navigator.contacts.find(fields, onSuccess, onError, options);
+
+
+### Windows-Eigenheiten
+
+ * `__contactFields__`wird nicht unterstützt und wird ignoriert. `find`Methode wird immer versucht, die Namen, e-Mail-Adresse oder Telefonnummer eines Kontakts übereinstimmen.
+
+## navigator.contacts.pickContact
+
+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.
+
+### Parameter
+
+ * **ContactSuccess**: Erfolg-Callback-Funktion, die mit den einzelnen Kontakt-Objekt aufgerufen. [Erforderlich]
+
+ * **ContactError**: Fehler-Callback-Funktion wird aufgerufen, wenn ein Fehler auftritt. [Optional]
+
+### Unterstützte Plattformen
+
+ * Android
+ * iOS
+ * Windows Phone 8
+ * Windows 8
+ * Windows
+
+### Beispiel
+
+ navigator.contacts.pickContact(function(contact){
+ console.log('The following contact has been selected:' + JSON.stringify(contact));
+ },function(err){
+ console.log('Error: ' + err);
+ });
+
+
+## Kontakt
+
+Das `Contact`-Objekt repräsentiert einen Benutzer Kontakt. Kontakte können erstellt, gespeichert oder aus der Gerät-Kontakte-Datenbank entfernt werden. Kontakte können auch (einzeln oder als Gruppe) aus der Datenbank abgerufen werden durch Aufrufen der `navigator.contacts.find`-Methode.
+
+**Hinweis**: nicht alle oben aufgeführten Kontaktfelder werden auf jedes Geräteplattform unterstützt. Bitte überprüfen Sie jede Plattform *Quirks* Abschnitt für Details.
+
+### Eigenschaften
+
+ * **ID**: einen globally unique Identifier. *(DOM-String und enthält)*
+
+ * **DisplayName**: der Name dieses Kontakts, geeignet für die Anzeige für Endbenutzer. *(DOM-String und enthält)*
+
+ * **Name**: ein Objekt, das alle Komponenten eines Personen-Namen enthält. *(Kontaktperson)*
+
+ * **Nickname**: einen lässig ein, um den Kontakt zu adressieren. *(DOM-String und enthält)*
+
+ * **Telefonnummern**: ein Array von der Kontakt-Telefonnummern. *(ContactField[])*
+
+ * **Email**: ein Array von e-Mail-Adressen des Kontakts. *(ContactField[])*
+
+ * **Adressen**: ein Array von allen Kontaktadressen. *(ContactAddress[])*
+
+ * **IMS**: ein Array von IM-Adressen des Kontakts. *(ContactField[])*
+
+ * **Organisationen**: ein Array von Organisationen des Kontakts. *(ContactOrganization[])*
+
+ * **Geburtstag**: der Geburtstag des Kontakts. *(Datum)*
+
+ * **Anmerkung**: eine Anmerkung über den Kontakt. *(DOM-String und enthält)*
+
+ * **Fotos**: ein Array mit den Kontakt-Fotos. *(ContactField[])*
+
+ * **Kategorien**: ein Array mit allen benutzerdefinierten Kategorien zugeordnet den Kontakt. *(ContactField[])*
+
+ * **URLs**: ein Array von Web-Seiten, die den Kontakt zugeordnet. *(ContactField[])*
+
+### Methoden
+
+ * **clone**: gibt eine neue `Contact` Objekt, das eine tiefe Kopie des aufrufenden Objekts, mit der `id` -Eigenschaft festgelegt`null`.
+
+ * **remove**: entfernt den Kontakt aus der Gerät-Kontakte-Datenbank, ansonsten führt eine Fehler-Callback mit einem `ContactError` Objekt.
+
+ * **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.
+
+### Unterstützte Plattformen
+
+ * Amazon Fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 und 8
+ * Windows 8
+ * Windows
+
+### Speichern Sie Beispiel
+
+ function onSuccess(contact) {
+ alert("Save Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // create a new contact object
+ var contact = navigator.contacts.create();
+ contact.displayName = "Plumber";
+ contact.nickname = "Plumber"; // specify both to support all devices
+
+ // populate some fields
+ var name = new ContactName();
+ name.givenName = "Jane";
+ name.familyName = "Doe";
+ contact.name = name;
+
+ // save to device
+ contact.save(onSuccess,onError);
+
+
+### Clone-Beispiel
+
+ // clone the contact object
+ var clone = contact.clone();
+ clone.name.givenName = "John";
+ console.log("Original contact name = " + contact.name.givenName);
+ console.log("Cloned contact name = " + clone.name.givenName);
+
+
+### Beispiel zu entfernen
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### Android 2.X Macken
+
+ * **Kategorien**: Android 2.X Geräten, Rückgabe nicht unterstützt`null`.
+
+### BlackBerry 10 Macken
+
+ * **ID**: vom Gerät zugewiesen werden, wenn den Kontakt zu speichern.
+
+### FirefoxOS Macken
+
+ * **Kategorien**: teilweise unterstützt. Felder **Pref** und **Typ** kehren zurück`null`
+
+ * **IMS**: nicht unterstützt
+
+ * **Fotos**: nicht unterstützt
+
+### iOS Macken
+
+ * **DisplayName**: nicht auf iOS, Rückkehr unterstützt `null` es sei kein `ContactName` angegeben, in welchem Fall es gibt den zusammengesetzten Namen, **Spitznamen** oder `""` bzw..
+
+ * **Geburtstag**: muss eingegeben werden, als JavaScript `Date` Objekt, die gleiche Weise zurückgegeben wird.
+
+ * **Fotos**: gibt einen Datei-URL auf das Bild, das im temporären Verzeichnis der Anwendung gespeichert ist. Inhalt des temporären Verzeichnisses werden entfernt, wenn die Anwendung beendet wird.
+
+ * **Kategorien**: Diese Eigenschaft wird derzeit nicht unterstützt, Rückgabe`null`.
+
+### Windows Phone 7 und 8 Eigenarten
+
+ * **DisplayName**: Wenn Sie einen Kontakt erstellen, der Nutzen für den Anzeigenamen der Display-Name-Parameter unterscheidet abgerufen, wenn den Kontakt zu finden.
+
+ * **URLs**: Wenn Sie einen Kontakt erstellen, können Benutzer eingegeben und mehrere Web-Adressen zu speichern, aber nur einer ist verfügbar, wenn Sie den Kontakt zu suchen.
+
+ * **Telefonnummern**: die *Pref* -Option wird nicht unterstützt. Der *Typ* wird in eine *find* -Operation nicht unterstützt. Nur ein `phoneNumber` ist erlaubt für jeden *Typ*.
+
+ * **Email**: *Pref* -Option wird nicht unterstützt. Haus und persönliche verweist auf dasselbe e-Mail-Eintrag. Nur ein Eintrag ist für jeden *Typ* zulässig..
+
+ * **Adressen**: unterstützt nur Arbeit und Home/persönliche *Art*. Den gleichen Adresseintrag auf den privaten und persönlichen *Typ* verweisen. Nur ein Eintrag ist für jeden *Typ* zulässig..
+
+ * **Organisationen**: nur zulässig ist, und unterstützt nicht die Attribute *Pref*, *Typ*und *Abteilung* .
+
+ * **Hinweis**: nicht unterstützt, Rückgabe`null`.
+
+ * **IMS**: nicht unterstützt, Rückgabe`null`.
+
+ * **Geburtstage**: nicht unterstützt, Rückgabe`null`.
+
+ * **Kategorien**: nicht unterstützt, Rückgabe`null`.
+
+ * **remove**: Methode wird nicht unterstützt
+
+### Windows-Eigenheiten
+
+ * **Fotos**: gibt einen Datei-URL auf das Bild, das im temporären Verzeichnis der Anwendung gespeichert ist.
+
+ * **Geburtstage**: nicht unterstützt, Rückgabe`null`.
+
+ * **Kategorien**: nicht unterstützt, Rückgabe`null`.
+
+ * **remove**: Methode ist nur in Windows 10 oder höher unterstützt.
+
+## ContactAddress
+
+Das `ContactAddress`-Objekt speichert die Eigenschaften einer einzelnen Adresse eines Kontakts. Ein `Contact` objekt kann mehr als eine Adresse in einem `ContactAddress []`-Array enthalten.
+
+### Eigenschaften
+
+ * **Pref**: Legen Sie auf `true` Wenn dieses `ContactAddress` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+
+ * **Typ**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. *(DOM-String und enthält)*
+
+ * **formatiert**: die vollständige Adresse, die für die Anzeige formatiert. *(DOM-String und enthält)*
+
+ * **StreetAddress**: die vollständige Postanschrift. *(DOM-String und enthält)*
+
+ * **Ort**: die Stadt oder Gemeinde. *(DOM-String und enthält)*
+
+ * **Region**: dem Staat oder der Region. *(DOM-String und enthält)*
+
+ * **Postleitzahl**: die Postleitzahl oder Postleitzahl. *(DOM-String und enthält)*
+
+ * **Land**: den Ländernamen. *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+ * Amazon Fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 und 8
+ * Windows 8
+ * Windows
+
+### Beispiel
+
+ // display the address information for all contacts
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ for (var j = 0; j < contacts[i].addresses.length; j++) {
+ alert("Pref: " + contacts[i].addresses[j].pref + "\n" +
+ "Type: " + contacts[i].addresses[j].type + "\n" +
+ "Formatted: " + contacts[i].addresses[j].formatted + "\n" +
+ "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+ "Locality: " + contacts[i].addresses[j].locality + "\n" +
+ "Region: " + contacts[i].addresses[j].region + "\n" +
+ "Postal Code: " + contacts[i].addresses[j].postalCode + "\n" +
+ "Country: " + contacts[i].addresses[j].country);
+ }
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ // find all contacts
+ var options = new ContactFindOptions();
+ options.filter = "";
+ var filter = ["displayName", "addresses"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### Android 2.X Macken
+
+ * **Pref**: nicht unterstützt, Rückkehr `false` auf Android 2.X Geräten.
+
+### BlackBerry 10 Macken
+
+ * **Pref**: BlackBerry-Geräten, Rückgabe nicht unterstützt`false`.
+
+ * **Typ**: teilweise unterstützt. Nur eine *Arbeit* und *Home* Typ Adressen kann pro Kontakt gespeichert werden.
+
+ * **formatiert**: teilweise unterstützt. Gibt eine Verkettung von allen BlackBerry-Adressfelder.
+
+ * **StreetAddress**: unterstützt. Gibt eine Verkettung von BlackBerry **Adresse1** und **Adresse2** Adressfelder.
+
+ * **Ort**: unterstützt. Gespeichert in BlackBerry **Stadt** Adressfeld.
+
+ * **Region**: unterstützt. Gespeichert in BlackBerry **StateProvince** Adressfeld.
+
+ * **Postleitzahl**: unterstützt. Im Feld für die Adresse des BlackBerry- **ZipPostal** gespeichert.
+
+ * **Land**: unterstützt.
+
+### FirefoxOS Macken
+
+ * **formatiert**: derzeit nicht unterstützt
+
+### iOS Macken
+
+ * **Pref**: iOS-Geräten, Rückgabe nicht unterstützt`false`.
+
+ * **formatiert**: derzeit nicht unterstützt.
+
+### Windows 8 Macken
+
+ * **Pref**: nicht unterstützt
+
+### Windows-Eigenheiten
+
+ * **Pref**: nicht unterstützt
+
+## ContactError
+
+Das `ContactError`-Objekt wird dem Benutzer über die `contactError`-Callback-Funktion zurückgegeben, wenn ein Fehler auftritt.
+
+### Eigenschaften
+
+ * **Code**: einer der vordefinierten Fehlercodes aufgeführt.
+
+### Konstanten
+
+ * `ContactError.UNKNOWN_ERROR` (code 0)
+ * `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+ * `ContactError.TIMEOUT_ERROR` (code 2)
+ * `ContactError.PENDING_OPERATION_ERROR` (code 3)
+ * `ContactError.IO_ERROR` (code 4)
+ * `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+ * `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+Das `ContactField`-Objekt ist eine wieder verwendbare Komponenten stellt Felder generisch kontaktieren. 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`-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
+
+ * **type**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. *(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)*
+
+### Unterstützte Plattformen
+
+ * Amazon Fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 und 8
+ * Windows 8
+ * Windows
+
+### Beispiel
+
+ // create a new contact
+ var contact = navigator.contacts.create();
+
+ // store contact phone numbers in ContactField[]
+ var phoneNumbers = [];
+ phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+ phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+ phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+ contact.phoneNumbers = phoneNumbers;
+
+ // save the contact
+ contact.save();
+
+
+### Android Eigenarten
+
+ * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### BlackBerry 10 Macken
+
+ * **Typ**: teilweise unterstützt. Für Telefonnummern verwendet.
+
+ * **Wert**: unterstützt.
+
+ * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### iOS Macken
+
+ * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### Windows8 Macken
+
+ * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+### Windows-Eigenheiten
+
+ * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+## ContactName
+
+Enthält verschiedene Arten von Informationen über `ein Kontaktobjekt` Namen.
+
+### Eigenschaften
+
+ * **formatiert**: den vollständigen Namen des Kontakts. *(DOM-String und enthält)*
+
+ * **Nachname**: Familienname des Kontakts. *(DOM-String und enthält)*
+
+ * **GivenName**: Given Name des Kontaktes. *(DOM-String und enthält)*
+
+ * **MiddleName**: Middle Name des Kontaktes. *(DOM-String und enthält)*
+
+ * **HonorificPrefix**: der Kontakt-Präfix (z.B. *Mr.* oder *Dr.*) *(DOM-String und enthält)*
+
+ * **HonorificSuffix**: der Kontakt-Suffix (Beispiel *Esq.*). *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+ * Amazon Fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 und 8
+ * Windows 8
+ * Windows
+
+### Beispiel
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ alert("Formatted: " + contacts[i].name.formatted + "\n" +
+ "Family Name: " + contacts[i].name.familyName + "\n" +
+ "Given Name: " + contacts[i].name.givenName + "\n" +
+ "Middle Name: " + contacts[i].name.middleName + "\n" +
+ "Suffix: " + contacts[i].name.honorificSuffix + "\n" +
+ "Prefix: " + contacts[i].name.honorificSuffix);
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ var options = new ContactFindOptions();
+ options.filter = "";
+ filter = ["displayName", "name"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### Android Eigenarten
+
+ * **formatiert**: teilweise unterstützte "und" Read-only. Gibt eine Verkettung von `honorificPrefix` , `givenName` , `middleName` , `familyName` , und`honorificSuffix`.
+
+### BlackBerry 10 Macken
+
+ * **formatiert**: teilweise unterstützt. Gibt eine Verkettung von BlackBerry- **FirstName** und **LastName** -Feldern.
+
+ * **Nachname**: unterstützt. Im Feld der BlackBerry- **Nachname** gespeichert.
+
+ * **GivenName**: unterstützt. Im BlackBerry **FirstName** -Feld gespeichert.
+
+ * **MiddleName**: nicht unterstützt, Rückgabe`null`.
+
+ * **HonorificPrefix**: nicht unterstützte, Rückgabe`null`.
+
+ * **HonorificSuffix**: nicht unterstützte, Rückgabe`null`.
+
+### FirefoxOS Macken
+
+ * **formatiert**: teilweise unterstützte "und" Read-only. Gibt eine Verkettung von `honorificPrefix` , `givenName` , `middleName` , `familyName` , und`honorificSuffix`.
+
+### iOS Macken
+
+ * **formatiert**: teilweise unterstützt. IOS zusammengesetzten Namen gibt, aber ist schreibgeschützt.
+
+### Windows 8 Macken
+
+ * **formatiert**: Dies ist die einzige Eigenschaft, und ist identisch mit `displayName` , und`nickname`
+
+ * **Nachname**: nicht unterstützt
+
+ * **GivenName**: nicht unterstützt
+
+ * **MiddleName**: nicht unterstützt
+
+ * **HonorificPrefix**: nicht unterstützt
+
+ * **HonorificSuffix**: nicht unterstützt
+
+### Windows-Eigenheiten
+
+ * **formatiert**: Er ist identisch mit`displayName`
+
+## ContactOrganization
+
+Das `ContactOrganization`-Objekt speichert Organisationseigenschaften eines Kontakts. Ein `Contact` objekt werden ein oder mehrere `ContactOrganization`-Objekte in einem Array gespeichert.
+
+### Eigenschaften
+
+ * **Pref**: Legen Sie auf `true` Wenn dieses `ContactOrganization` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+
+ * **Typ**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. _(DOMString)
+
+ * **Name**: der Name der Organisation. *(DOM-String und enthält)*
+
+ * **Abteilung**: die Abteilung, die der Vertrag für arbeitet. *(DOM-String und enthält)*
+
+ * **Titel**: Titel des Kontakts in der Organisation. *(DOM-String und enthält)*
+
+### Unterstützte Plattformen
+
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 und 8
+ * Windows (nur Windows-8.1 und Windows Phone 8.1-Geräte)
+
+### Beispiel
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ for (var j = 0; j < contacts[i].organizations.length; j++) {
+ alert("Pref: " + contacts[i].organizations[j].pref + "\n" +
+ "Type: " + contacts[i].organizations[j].type + "\n" +
+ "Name: " + contacts[i].organizations[j].name + "\n" +
+ "Department: " + contacts[i].organizations[j].department + "\n" +
+ "Title: " + contacts[i].organizations[j].title);
+ }
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ var options = new ContactFindOptions();
+ options.filter = "";
+ filter = ["displayName", "organizations"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### Android 2.X Macken
+
+ * **Pref**: von Android 2.X-Geräte, Rückgabe nicht unterstützt`false`.
+
+### BlackBerry 10 Macken
+
+ * **Pref**: von BlackBerry-Geräten zurückgeben nicht unterstützt`false`.
+
+ * **Typ**: von BlackBerry-Geräten zurückgeben nicht unterstützt`null`.
+
+ * **Name**: teilweise unterstützt. Der Name der ersten Organisation wird im Feld **Firma** BlackBerry gespeichert.
+
+ * **Abteilung**: nicht unterstützt, Rückgabe`null`.
+
+ * **Titel**: teilweise unterstützt. Der erste Titel der Organisation wird im Feld **JobTitle** BlackBerry gespeichert.
+
+### Firefox OS Macken
+
+ * **Pref**: nicht unterstützt
+
+ * **Typ**: nicht unterstützt
+
+ * **Abteilung**: nicht unterstützt
+
+ * Felder **Name** und **Titel** in **Org** und **JobTitle** gespeichert.
+
+### iOS Macken
+
+ * **Pref**: iOS-Geräten, Rückgabe nicht unterstützt`false`.
+
+ * **Typ**: iOS-Geräten, Rückgabe nicht unterstützt`null`.
+
+ * **Name**: teilweise unterstützt. Der Name der ersten Organisation wird im Feld **kABPersonOrganizationProperty** iOS gespeichert.
+
+ * **Abteilung**: teilweise unterstützt. Die Abteilungsnamen der erste ist im Feld **kABPersonDepartmentProperty** iOS gespeichert.
+
+ * **Titel**: teilweise unterstützt. Der erste Titel wird im Feld **kABPersonJobTitleProperty** iOS gespeichert.
+
+### Windows-Eigenheiten
+
+ * **Pref**: nicht unterstützt, Rückgabe`false`.
+
+ * **Typ**: nicht unterstützt, Rückgabe`null`.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/1871eed4/doc/es/README.md
----------------------------------------------------------------------
diff --git a/doc/es/README.md b/doc/es/README.md
new file mode 100644
index 0000000..9bfe407
--- /dev/null
+++ b/doc/es/README.md
@@ -0,0 +1,732 @@
+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+-->
+
+# cordova-plugin-contacts
+
+[](https://travis-ci.org/apache/cordova-plugin-contacts)
+
+Este plugin define un global `navigator.contacts` objeto que proporciona acceso a la base de datos de contactos de dispositivo.
+
+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
+
+Esto requiere cordova 5.0 + (v1.0.0 estable actual)
+
+ cordova plugin add cordova-plugin-contacts
+
+
+Las versiones más antiguas de Córdoba todavía pueden instalar mediante el id de **obsoleto** (viejo v0.2.16)
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+También es posible instalar directamente vía url repo (inestable)
+
+ cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+
+
+### Firefox OS rarezas
+
+Crear **www/manifest.webapp** como se describe en [Manifestar Docs](https://developer.mozilla.org/en-US/Apps/Developing/Manifest). Agregar permisos pertinentes. También hay una necesidad de cambiar el tipo de aplicación a "privilegiados" - [Docs manifiestan](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type). **ADVERTENCIA**: todas las apps privilegiadas aplicar [Política de seguridad de contenidos](https://developer.mozilla.org/en-US/Apps/CSP) que prohíbe en línea de comandos. Inicializar la aplicación de otra manera.
+
+ "type": "privileged",
+ "permissions": {
+ "contacts": {
+ "access": "readwrite",
+ "description": "Describe why there is a need for such permission"
+ }
+ }
+
+
+### Windows rarezas
+
+**Antes de Windows 10:** Contactos `encontrar` y `pickContact` métodos son sólo lectura, por lo que su aplicación no puede modificarlos. método `Find` disponible sólo en dispositivos Windows Phone 8.1.
+
+**Windows 10 y anteriores:** Contactos se pueden guardar y se guarda en almacenamiento local de la aplicación contactos. Contactos también pueden ser eliminados.
+
+### Rarezas de Windows 8
+
+Windows 8 contactos son de sólo lectura. Través de los contactos de la API de Córdoba no son consultables/búsqueda, se debe informar al usuario a buscar un contacto como una llamada a contacts.pickContact que se abrirá la aplicación 'Personas' donde el usuario debe elegir un contacto. Cualquier contacto volvió es readonly, su aplicación no puede modificarlos.
+
+## Navigator.Contacts
+
+### Métodos
+
+ * navigator.contacts.create
+ * navigator.contacts.find
+ * navigator.contacts.pickContact
+
+### Objetos
+
+ * Contact
+ * ContactName
+ * ContactField
+ * ContactAddress
+ * ContactOrganization
+ * ContactFindOptions
+ * ContactError
+ * ContactFieldType
+
+## navigator.contacts.create
+
+El `navigator.contacts.create` método es sincrónico y devuelve una nueva `Contact` objeto.
+
+Este método no retiene el objeto de contacto en la base de contactos de dispositivo, para lo cual necesita invocar el `Contact.save` método.
+
+### Plataformas soportadas
+
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 y 8
+
+### Ejemplo
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## navigator.contacts.find
+
+El `navigator.contacts.find` método se ejecuta asincrónicamente, consultando la base de datos de contactos de dispositivo y devolver una matriz de `Contact` objetos. Los objetos resultantes son pasados a la `contactSuccess` función de devolución de llamada especificada por el parámetro **contactSuccess** .
+
+El parámetro **contactFields** especifica los campos para ser utilizado como un calificador de búsqueda. 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, una entre mayúsculas y minúsculas, coincidencia parcial valor se aplica a cada campo especificado en el parámetro **contactFields** . Si hay un partido para *cualquier* de los campos especificados, se devuelve el contacto. Uso **contactFindOptions.desiredFields** parámetro al control que Contacta con propiedades debe devolverse atrás.
+
+### Parámetros
+
+ * **contactFields**: póngase en contacto con campos para usar como un calificador de búsqueda. *(DOMString[])* [Required]
+
+ * **contactSuccess**: función de callback de éxito se invoca con la matriz de objetos contacto devueltos desde la base de datos. [Required]
+
+ * **contactError**: función de callback de Error, se invoca cuando se produce un error. [Opcional]
+
+ * **contactFindOptions**: buscar opciones para filtrar navigator.contacts. [Optional]
+
+ 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]
+
+### Plataformas soportadas
+
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 y 8
+ * Windows (Windows Phone 8.1 y Windows 10)
+
+### Ejemplo
+
+ 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 rarezas
+
+ * `__contactFields__`No se admite y se ignorará. `find`método siempre tratará de coincidir con el nombre, dirección de correo electrónico o número de teléfono de un contacto.
+
+## navigator.contacts.pickContact
+
+El `navigator.contacts.pickContact` método lanza el selector para seleccionar un único contacto contacto. El objeto resultante se pasa a la `contactSuccess` función de devolución de llamada especificada por el parámetro **contactSuccess** .
+
+### Parámetros
+
+ * **contactSuccess**: función de callback de éxito se invoca con el único objeto de contacto. [Obligatorio]
+
+ * **contactError**: función de callback de Error, se invoca cuando se produce un error. [Opcional]
+
+### Plataformas soportadas
+
+ * Android
+ * iOS
+ * Windows Phone 8
+ * Windows 8
+ * Windows
+
+### Ejemplo
+
+ navigator.contacts.pickContact(function(contact) {console.log (' se ha seleccionado el siguiente contacto: "+ JSON.stringify(contact));
+ }, function(err) {console.log ('Error: ' + err);
+ });
+
+
+## Contact
+
+El `Contact` objeto representa el contacto de un usuario. Contactos pueden ser creados, almacenados o eliminados de la base de datos de contactos de dispositivo. Contactos pueden también ser obtenidos (individualmente o a granel) de la base de datos invocando el `navigator.contacts.find` método.
+
+**Nota**: no todos los campos de contacto mencionados son compatibles con la plataforma de cada dispositivo. Consulte sección *peculiaridades* de cada plataforma para más detalles.
+
+### Propiedades
+
+ * **ID**: un identificador único global. *(DOMString)*
+
+ * **displayName**: el nombre de este contacto, conveniente para la exhibición a los usuarios finales. *(DOMString)*
+
+ * **nombre**: un objeto que contiene todos los componentes de un nombre de las personas. *(ContactName)*
+
+ * **apodo**: un nombre para abordar el contacto casual. *(DOMString)*
+
+ * **números**: una matriz de números de teléfono de contacto. *(ContactField[])*
+
+ * **correos electrónicos**: un conjunto de direcciones de correo electrónico del contacto. *(ContactField[])*
+
+ * **direcciones**: un conjunto de direcciones de todos los contactos. *(ContactAddress[])*
+
+ * **IMS**: un conjunto de direcciones de todos los contactos IM. *(ContactField[])*
+
+ * **organizaciones**: un conjunto de organizaciones de todos los contactos. *(ContactOrganization[])*
+
+ * **cumpleaños**: el cumpleaños del contacto. *(Fecha)*
+
+ * **Nota**: una nota sobre el contacto. *(DOMString)*
+
+ * **fotos**: una serie de fotos de los contactos. *(ContactField[])*
+
+ * **categorías**: una matriz de todas las categorías definidas por el usuario asociado con el contacto. *(ContactField[])*
+
+ * **URL**: un conjunto de páginas web asociadas con el contacto. *(ContactField[])*
+
+### Métodos
+
+ * **clon**: devuelve un nuevo `Contact` objeto que es una copia en profundidad del objeto de llamadas con el `id` propiedad establecida en`null`.
+
+ * **eliminar**: elimina el contacto de la base de datos de contactos de dispositivo, si no se ejecuta un callback de error con un `ContactError` objeto.
+
+ * **Guardar**: guarda un nuevo contacto en la base de datos de contactos de dispositivo o actualiza un contacto existente si ya existe un contacto con el mismo **id** .
+
+### Plataformas soportadas
+
+ * Amazon fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 y 8
+ * Windows 8
+ * Windows
+
+### Salvar ejemplo
+
+ function onSuccess(contact) {
+ alert("Save Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // create a new contact object
+ var contact = navigator.contacts.create();
+ contact.displayName = "Plumber";
+ contact.nickname = "Plumber"; // specify both to support all devices
+
+ // populate some fields
+ var name = new ContactName();
+ name.givenName = "Jane";
+ name.familyName = "Doe";
+ contact.name = name;
+
+ // save to device
+ contact.save(onSuccess,onError);
+
+
+### Ejemplo de clon
+
+ clon del clon de contacto objeto var = contact.clone();
+ clone.name.givenName = "John";
+ Console.log ("contacto Original nombre =" + contact.name.givenName);
+ Console.log ("Cloned contacto nombre =" + clone.name.givenName);
+
+
+### Quitar ejemplo
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### Rarezas Android 2.X
+
+ * **categories**: no compatible con dispositivos Android 2.X, devolver `null`.
+
+### BlackBerry 10 rarezas
+
+ * **ID**: asignado por el dispositivo cuando se guarda el contacto.
+
+### FirefoxOS rarezas
+
+ * **categorías**: parcialmente soportado. Campos **pref** y **tipo** regresan`null`
+
+ * **IMS**: no se admite
+
+ * **fotos**: no se admite
+
+### iOS rarezas
+
+ * **displayName**: no compatible con iOS, regresando `null` si no hay ningún `ContactName` especifica, en cuyo caso devuelve el nombre del compuesto, **apodo** o `""` , respectivamente.
+
+ * **cumpleaños**: debe ser de entrada como un JavaScript `Date` objeto, del mismo modo que se la devuelvan.
+
+ * **fotos**: devuelve una dirección URL del archivo de la imagen, que se almacena en el directorio temporal de la aplicación. Contenidos del directorio temporal se eliminan cuando salga de la aplicación.
+
+ * **categorías**: esta propiedad actualmente no es compatible, regresando`null`.
+
+### Windows Phone 7 y 8 rarezas
+
+ * **displayName**: cuando se crea un contacto, previsto para el parámetro de nombre pantalla difiere el nombre para mostrar el valor obtenido al encontrar el contacto.
+
+ * **URL**: cuando se crea un contacto, los usuarios pueden ingresar y salvar más de una dirección web, pero sólo está disponible cuando busque el contacto.
+
+ * **números**: no se admite la opción *pref* . El *tipo* no se admite en una operación de *encontrar* . Solamente un `phoneNumber` está permitido para cada *tipo*.
+
+ * **correos electrónicos**: no se admite la opción *pref* . Home y referencias misma entrada de correo electrónico. Se permite solamente una entrada para cada *tipo*.
+
+ * **direcciones**: soporta sólo trabajo y hogar/personal *tipo*. La casa y personales de *tipo* referencia la misma entrada de dirección. Se permite solamente una entrada para cada *tipo*.
+
+ * **organizaciones**: sólo está permitido y no es compatible con los atributos *pref*, *tipo*y *Departamento* .
+
+ * **Nota**: no compatible, regresando`null`.
+
+ * **ims**: no soportado, devolver `null`.
+
+ * **cumpleaños**: no soportado, regresando`null`.
+
+ * **categorías**: no soportado, regresando`null`.
+
+ * **remove**: no se admite el método
+
+### Windows rarezas
+
+ * **fotos**: devuelve una dirección URL del archivo de la imagen, que se almacena en el directorio temporal de la aplicación.
+
+ * **cumpleaños**: no soportado, regresando`null`.
+
+ * **categorías**: no soportado, regresando`null`.
+
+ * **remove**: el método sólo es soportado en Windows 10 o superior.
+
+## ContactAddress
+
+El `ContactAddress` objeto almacena las propiedades de una única dirección de un contacto. A `Contact` objeto puede incluir más de una dirección en un `ContactAddress[]` matriz.
+
+### Propiedades
+
+ * **pref**: establecido en `true` si esta `ContactAddress` contiene el usuario preferido de valor. *(boolean)*
+
+ * **type**: una cadena que indica qué tipo de campo es, *home* por ejemplo. *(DOMString)*
+
+ * **formatted**: la dirección completa con formato de visualización. *(DOMString)*
+
+ * **streetAddress**: la dirección completa. *(DOMString)*
+
+ * **locality**: la ciudad o localidad. *(DOMString)*
+
+ * **region**: el estado o la región. *(DOMString)*
+
+ * **postalCode**: el código postal o código postal. *(DOMString)*
+
+ * **country**: el nombre del país. *(DOMString)*
+
+### Plataformas soportadas
+
+ * Amazon fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 y 8
+ * Windows 8
+ * Windows
+
+### Ejemplo
+
+ // 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);
+
+
+### Rarezas Android 2.X
+
+ * **pref**: no soportado, devolviendo `false` en dispositivos Android 2.X.
+
+### BlackBerry 10 rarezas
+
+ * **pref**: no compatible con dispositivos BlackBerry, devolviendo `false`.
+
+ * **type**: parcialmente soportado. Sólo uno de cada *Work* y *Home* tipo direcciones puede ser almacenado por contacto.
+
+ * **formatted**: parcialmente soportado. Devuelve una concatenación de todos los campos de dirección de BlackBerry.
+
+ * **streetAddress**: soportado. Devuelve una concatenación de BlackBerry **address1** y **2** campos de dirección.
+
+ * **locality**: apoyado. Almacenada en el campo de dirección de la **city** de BlackBerry.
+
+ * **region**: apoyado. Almacenada en el campo de dirección de BlackBerry **stateProvince**.
+
+ * **postalCode**: apoyado. Almacenada en el campo de dirección de BlackBerry **zipPostal**.
+
+ * **country**: apoyado.
+
+### FirefoxOS rarezas
+
+ * **formato**: actualmente no se admite
+
+### iOS rarezas
+
+ * **pref**: no se admite en dispositivos iOS, devolviendo `false`.
+
+ * **formatted**: actualmente no se admite.
+
+### Rarezas de Windows 8
+
+ * **Pref**: no se admite
+
+### Windows rarezas
+
+ * **Pref**: no se admite
+
+## ContactError
+
+El `ContactError` objeto se devuelve al usuario a través de la `contactError` función de devolución de llamada cuando se produce un error.
+
+### Propiedades
+
+ * **code**: uno de los códigos de error predefinido enumerados a continuación.
+
+### Constantes
+
+ * `ContactError.UNKNOWN_ERROR` (code 0)
+ * `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+ * `ContactError.TIMEOUT_ERROR` (code 2)
+ * `ContactError.PENDING_OPERATION_ERROR` (code 3)
+ * `ContactError.IO_ERROR` (code 4)
+ * `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+ * `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+El `ContactField` objeto es un componente reutilizable que representa en contacto con campos genéricamente. Cada `ContactField` objeto contiene un `value` , `type` , y `pref` propiedad. A `Contact` objeto almacena varias propiedades en `ContactField[]` arreglos de discos, como las direcciones de teléfono números y correo electrónico.
+
+En la mayoría de los casos, no existen previamente determinados valores para un `ContactField` atributo **type** del objeto. Por ejemplo, un número de teléfono puede especificar valores de **tipo** de *hogar*, *trabajo*, *móvil*, *iPhone*o cualquier otro valor que es apoyado por contacto de base de datos de una plataforma dispositivo determinado. Sin embargo, para el `Contact` **fotos de** campo, el campo **tipo** indica el formato de la imagen devuelta: **url** cuando el atributo de **valor** contiene una dirección URL de la imagen de la foto, o *base64* cuando el **valor** contiene una cadena codificada en base64 imagen.
+
+### Propiedades
+
+ * **tipo**: una cadena que indica qué tipo de campo es, *casa* por ejemplo. *(DOMString)*
+
+ * **valor**: el valor del campo, como un teléfono número o dirección de email. *(DOMString)*
+
+ * **Pref**: A `true` si este `ContactField` contiene el valor del usuario preferido. *(booleano)*
+
+### Plataformas soportadas
+
+ * Amazon fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 y 8
+ * Windows 8
+ * Windows
+
+### Ejemplo
+
+ // create a new contact
+ var contact = navigator.contacts.create();
+
+ // store contact phone numbers in ContactField[]
+ var phoneNumbers = [];
+ phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+ phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+ phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+ contact.phoneNumbers = phoneNumbers;
+
+ // save the contact
+ contact.save();
+
+
+### Rarezas Android
+
+ * **Pref**: no soportado, regresando`false`.
+
+### BlackBerry 10 rarezas
+
+ * **tipo**: parcialmente soportado. Utilizado para los números de teléfono.
+
+ * **valor**: apoyado.
+
+ * **Pref**: no soportado, regresando`false`.
+
+### iOS rarezas
+
+ * **Pref**: no soportado, regresando`false`.
+
+### Windows8 rarezas
+
+ * **Pref**: no soportado, regresando`false`.
+
+### Windows rarezas
+
+ * **Pref**: no soportado, regresando`false`.
+
+## ContactName
+
+Contiene diferentes tipos de información sobre un `Contact` nombre del objeto.
+
+### Propiedades
+
+ * **formato**: el nombre completo del contacto. *(DOMString)*
+
+ * **familia**: el nombre del contacto familiar. *(DOMString)*
+
+ * **givenName**: nombre del contacto. *(DOMString)*
+
+ * **middleName**: el nombre del contacto media. *(DOMString)*
+
+ * **honorificPrefix**: prefijo del contacto (ejemplo *señor* o *doctor*) *(DOMString)*
+
+ * **honorificSuffix**: sufijo de contacto (ejemplo *Esq.*). *(DOMString)*
+
+### Plataformas soportadas
+
+ * Amazon fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 y 8
+ * Windows 8
+ * Windows
+
+### Ejemplo
+
+ 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);
+
+
+### Rarezas Android
+
+ * **formato**: parcialmente compatibles y de sólo lectura. Devuelve una concatenación de `honorificPrefix` , `givenName` , `middleName` , `familyName` , y`honorificSuffix`.
+
+### BlackBerry 10 rarezas
+
+ * **formato**: parcialmente soportado. Devuelve una concatenación de campos **firstName** y **lastName** de BlackBerry.
+
+ * **familia**: apoyo. Almacenada en el campo **lastName** BlackBerry.
+
+ * **givenName**: apoyado. Almacenados en campo **firstName** BlackBerry.
+
+ * **middleName**: no soportado, regresando`null`.
+
+ * **honorificPrefix**: no soportado, regresando`null`.
+
+ * **honorificSuffix**: no soportado, regresando`null`.
+
+### FirefoxOS rarezas
+
+ * **formato**: parcialmente compatibles y de sólo lectura. Devuelve una concatenación de `honorificPrefix` , `givenName` , `middleName` , `familyName` , y`honorificSuffix`.
+
+### iOS rarezas
+
+ * **formato**: parcialmente soportado. Devuelve iOS nombre compuesto, pero es de sólo lectura.
+
+### Rarezas de Windows 8
+
+ * **formato**: este es el único nombre de propiedad y es idéntico al `displayName` , y`nickname`
+
+ * **familia**: no se admite
+
+ * **givenName**: no se admite
+
+ * **middleName**: no se admite
+
+ * **honorificPrefix**: no se admite
+
+ * **honorificSuffix**: no se admite
+
+### Windows rarezas
+
+ * **formato**: es idéntica a`displayName`
+
+## ContactOrganization
+
+El `ContactOrganization` objeto almacena las propiedades de organización de un contacto. A `Contact` objeto almacena uno o más `ContactOrganization` los objetos en una matriz.
+
+### Propiedades
+
+ * **Pref**: A `true` si este `ContactOrganization` contiene el valor del usuario preferido. *(booleano)*
+
+ * **tipo**: una cadena que indica qué tipo de campo es, *casa* por ejemplo. _(DOMString)
+
+ * **nombre**: el nombre de la organización. *(DOMString)*
+
+ * **Departamento**: el contrato de obras para el departamento. *(DOMString)*
+
+ * **título**: título del contacto de la organización. *(DOMString)*
+
+### Plataformas soportadas
+
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 y 8
+ * Windows (sólo dispositivos Windows 8.1 y 8.1 de Windows Phone)
+
+### Ejemplo
+
+ 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);
+
+
+### Rarezas Android 2.X
+
+ * **Pref**: no compatible con dispositivos Android 2.X, regresando`false`.
+
+### BlackBerry 10 rarezas
+
+ * **Pref**: no compatible con dispositivos BlackBerry, regresando`false`.
+
+ * **tipo**: no compatible con dispositivos BlackBerry, regresando`null`.
+
+ * **nombre**: parcialmente soportado. El primer nombre de la organización se almacena en el campo de la **empresa** BlackBerry.
+
+ * **Departamento**: no soportado, regresando`null`.
+
+ * **título**: parcialmente soportado. El primer título de la organización se almacena en el campo de **jobTitle** BlackBerry.
+
+### Firefox OS rarezas
+
+ * **Pref**: no se admite
+
+ * **tipo**: no se admite
+
+ * **Departamento**: no se admite
+
+ * Los campos **nombre** y **título** almacenado en **org** y **jobTitle**.
+
+### iOS rarezas
+
+ * **pref**: no se admite en dispositivos iOS, devolviendo `false`.
+
+ * **tipo**: no se admite en dispositivos iOS, regresando`null`.
+
+ * **nombre**: parcialmente soportado. El primer nombre de la organización se almacena en el campo de **kABPersonOrganizationProperty** de iOS.
+
+ * **Departamento**: parcialmente soportado. El primer nombre de departamento se almacena en el campo de **kABPersonDepartmentProperty** de iOS.
+
+ * **título**: parcialmente soportado. El primer título se almacena en el campo de **kABPersonJobTitleProperty** de iOS.
+
+### Windows rarezas
+
+ * **Pref**: no soportado, regresando`false`.
+
+ * **tipo**: no soportado, regresando`null`.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/1871eed4/doc/fr/README.md
----------------------------------------------------------------------
diff --git a/doc/fr/README.md b/doc/fr/README.md
new file mode 100644
index 0000000..cd745ee
--- /dev/null
+++ b/doc/fr/README.md
@@ -0,0 +1,668 @@
+<!---
+# license: Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+-->
+
+# cordova-plugin-contacts
+
+[](https://travis-ci.org/apache/cordova-plugin-contacts)
+
+Ce plugin définit un global `navigator.contacts` objet, ce qui permet d'accéder à la base de données de contacts de dispositif.
+
+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
+
+Pour cela, cordova 5.0 + (v1.0.0 stable actuelle)
+
+ cordova plugin add cordova-plugin-contacts
+
+
+Anciennes versions de cordova peuvent toujours installer via l'id **déconseillée** (v0.2.16 rassis)
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+Il est également possible d'installer directement via l'url de repo (instable)
+
+ cordova plugin add https://github.com/apache/cordova-plugin-contacts.git
+
+
+### Firefox OS Quirks
+
+Créez **www/manifest.webapp** comme décrit dans [Les Docs manifeste](https://developer.mozilla.org/en-US/Apps/Developing/Manifest). Ajouter permisions pertinentes. Il est également nécessaire de changer le type d'application Web de « privilégiés » - [Docs manifeste](https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type). **Avertissement**: toutes les applications privilégiées appliquer [Contenu politique de sécurité](https://developer.mozilla.org/en-US/Apps/CSP) qui interdit à un script inline. Initialiser votre application d'une autre manière.
+
+ « type »: "le privilège", "autorisations": {« contacts »: {« accès »: "readwrite", "description": "décrire pourquoi il est nécessaire pour obtenir cette permission"}}
+
+
+### Bizarreries de Windows
+
+**Avant Windows 10 :** Tout contact retourné par les méthodes `find` et `pickContact` est en lecture seule, afin que votre application ne puisse les modifier. `find`méthode disponible uniquement sur les appareils Windows Phone 8.1.
+
+**Windows 10 et plus :** Contacts peuvent être enregistrées et seront enregistrées dans le stockage local application contacts. Contacts peuvent également être supprimés.
+
+### Bizarreries de Windows 8
+
+Windows 8 Contacts sont en lecture seule. Via les Contacts d'API Cordova ne sont pas queryable/consultables, vous devez en informer l'utilisateur de choisir un contact comme un appel à contacts.pickContact qui va ouvrir l'application « People » où l'utilisateur doit choisir un contact. Les contacts retournés sont en lecture seule, afin que votre application ne puisse les modifier.
+
+## Navigator.contacts
+
+### Méthodes
+
+ * navigator.contacts.create
+ * navigator.contacts.find
+ * navigator.contacts.pickContact
+
+### Objets
+
+ * Contact
+ * ContactName
+ * ContactField
+ * ContactAddress
+ * ContactOrganization
+ * ContactFindOptions
+ * ContactError
+ * ContactFieldType
+
+## navigator.contacts.create
+
+La `navigator.contacts.create` méthode est synchrone et retourne un nouveau `Contact` objet.
+
+Cette méthode ne conserve pas l'objet de Contact dans la base de données des contacts périphériques, dont vous avez besoin d'appeler le `Contact.save` méthode.
+
+### Plates-formes supportées
+
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 et 8
+
+### Exemple
+
+ myContact var = navigator.contacts.create ({« displayName »: « Test User »}) ;
+
+
+## navigator.contacts.find
+
+La `navigator.contacts.find` méthode s'exécute de façon asynchrone, l'interrogation de la base de données de contacts de dispositif et retourne un tableau de `Contact` objets. Les objets résultants sont passés à la `contactSuccess` la fonction de rappel spécifiée par le paramètre **contactSuccess** .
+
+Le paramètre **contactFields** spécifie les champs à utiliser comme un qualificateur de recherche. 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.
+
+La chaîne **contactFindOptions.filter** peut servir comme un filtre de recherche lors de l'interrogation de la base de données de contacts. Si fourni, un non-respect de la casse, correspondance de valeur partielle est appliquée à chaque champ spécifié dans le paramètre **contactFields** . S'il y a une correspondance pour *n'importe quel* des champs spécifiés, le contact est retourné. Utilisation **contactFindOptions.desiredFields** paramètre de contrôle qui contacter propriétés doit être retourné au retour.
+
+### Paramètres
+
+ * **contactFields**: communiquer avec les champs à utiliser comme un qualificateur de recherche. *(DOMString[])* [Required]
+
+ * **contactSuccess**: fonction de rappel de succès avec le tableau d'objets Contact appelée retournée par la base de données. [Required]
+
+ * **contactError**: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Facultatif]
+
+ * **contactFindOptions**: recherche d'options pour filtrer navigator.contacts. [Optional]
+
+ 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]
+
+### Plates-formes supportées
+
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 et 8
+ * Windows (Windows Phone, 8.1 et Windows 10)
+
+### Exemple
+
+ function onSuccess(contacts) {alert (« Found » + contacts.length + « contacts. »);} ;
+
+ function onError(contactError) {alert('onError!');} ;
+
+ 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) ;
+
+
+### Bizarreries de Windows
+
+ * `__contactFields__`n'est pas prise en charge et sera ignorée. `find`méthode toujours tenter de faire correspondre le nom, adresse e-mail ou numéro de téléphone d'un contact.
+
+## navigator.contacts.pickContact
+
+La `navigator.contacts.pickContact` méthode lance le sélecteur de Contact pour sélectionner un contact unique. L'objet qui en résulte est passé à la `contactSuccess` la fonction de rappel spécifiée par le paramètre **contactSuccess** .
+
+### Paramètres
+
+ * **contactSuccess**: fonction de rappel de succès appelée avec l'objet de Contact unique. [Obligatoire]
+
+ * **contactError**: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Facultatif]
+
+### Plates-formes supportées
+
+ * Android
+ * iOS
+ * Windows Phone 8
+ * Windows 8
+ * Windows
+
+### Exemple
+
+ navigator.contacts.pickContact(function(contact) {console.log ("le contact suivant a été retenu:" + JSON.stringify(contact)) ;
+ }, function(err) {console.log ("Error:" + err) ;
+ });
+
+
+## Contact
+
+Le `Contact` objet représente le contact de l'utilisateur. Contacts peuvent être créés, conservés ou supprimés de la base de données de contacts de dispositif. Contacts peuvent également être récupérées (individuellement ou en vrac) de la base de données en appelant le `navigator.contacts.find` méthode.
+
+**NOTE**: tous les champs de contact susmentionnés ne sont pris en charge sur chaque plate-forme de périphérique. S'il vous plaît vérifier la section *bizarreries* de chaque plate-forme pour plus de détails.
+
+### Propriétés
+
+ * **ID**: un identificateur global unique. *(DOMString)*
+
+ * **displayName**: le nom de ce Contact, approprié pour l'affichage à l'utilisateur final. *(DOMString)*
+
+ * **nom**: un objet contenant tous les composants d'un nom de personnes. *(ContactName)*
+
+ * **Pseudo**: un nom occasionnel permettant de régler le contact. *(DOMString)*
+
+ * **phoneNumbers**: un tableau des numéros de téléphone du contact. *(ContactField[])*
+
+ * **courriels**: un tableau d'adresses de courriel du contact. *(ContactField[])*
+
+ * **adresses**: un tableau d'adresses tous les contacts. *(ContactAddress[])*
+
+ * **IMS**: un tableau d'adresses IM tout le contact. *(ContactField[])*
+
+ * **organisations**: un tableau des organisations de tout le contact. *(ContactOrganization[])*
+
+ * **anniversaire**: l'anniversaire du contact. *(Date)*
+
+ * **Remarque**: une remarque sur le contact. *(DOMString)*
+
+ * **photos**: un tableau de photos du contact. *(ContactField[])*
+
+ * **catégories**: un tableau de toutes les catégories définies par l'utilisateur attribuée au contact. *(ContactField[])*
+
+ * **URL**: un tableau des pages web attribuée au contact. *(ContactField[])*
+
+### Méthodes
+
+ * **Clone**: retourne un nouveau `Contact` objet qui est une copie complète de l'objet appelant, avec le `id` propriété la valeur`null`.
+
+ * **supprimer**: supprime le contact de la base de données de contacts de dispositif, sinon exécute un rappel d'erreur avec un `ContactError` objet.
+
+ * **Enregistrer**: enregistre un nouveau contact dans la base de données de contacts de périphérique, ou met à jour un contact existant, si un contact avec le même **id** existe déjà.
+
+### Plates-formes supportées
+
+ * Amazon Fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 et 8
+ * Windows 8
+ * Windows
+
+### Enregistrez l'exemple
+
+ function onSuccess(contact) {alert ("sauver succès");} ;
+
+ function onError(contactError) {alert ("erreur =" + contactError.code);} ;
+
+ 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 ;
+
+ enregistrer dans contact.save(onSuccess,onError) de l'appareil ;
+
+
+### Exemple de clone
+
+ 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) ;
+
+
+### Supprimer l'exemple
+
+ fonction onSuccess() {alert ("succès");} ;
+
+ function onError(contactError) {alert ("erreur =" + contactError.code);} ;
+
+ supprimer le contact de l'appareil contact.remove(onSuccess,onError) ;
+
+
+### Android 2.X Quirks
+
+ * **catégories**: non pris en charge sur les périphériques Android 2.X, retour`null`.
+
+### BlackBerry 10 Quirks
+
+ * **ID**: assignés par l'appareil lors de l'enregistrement du contact.
+
+### Bizarreries de FirefoxOS
+
+ * **catégories**: partiellement pris en charge. Champs **pref** et **type** sont de retour`null`
+
+ * **IMS**: non pris en charge
+
+ * **photos**: ne pas pris en charge
+
+### Notes au sujet d'iOS
+
+ * **displayName**: ne pas possible sur iOS, retour `null` à moins qu'il n'y a aucun `ContactName` spécifié, auquel cas, il renvoie le nom composite, **Pseudo** ou `""` , respectivement.
+
+ * **anniversaire**: doit être entré comme un JavaScript `Date` objet, de la même façon qu'il soit retourné.
+
+ * **photos**: retourne une URL de fichier de l'image, qui est stocké dans le répertoire temporaire de l'application. Contenu du répertoire temporaire est supprimés lorsque l'application se ferme.
+
+ * **catégories**: cette propriété n'est actuellement pas supportée, retour`null`.
+
+### Notes au sujet de Windows Phone 7 et 8
+
+ * **displayName**: lorsque vous créez un contact, la valeur fournie pour le paramètre de nom d'affichage est différent de l'affichage nom Récupérée lors de la recherche du contact.
+
+ * **URL**: lorsque vous créez un contact, les utilisateurs peuvent entrer et enregistrer plus d'une adresse web, mais seulement un est disponible lors de la recherche du contact.
+
+ * **phoneNumbers**: l'option de *pref* n'est pas pris en charge. Le *type* n'est pas pris en charge lors d'une opération de *trouver* . Seul `phoneNumber` est autorisé pour chaque *type*.
+
+ * **courriels**: l'option de *pref* n'est pas pris en charge. Accueil et personnels références même courriel entrée. Une seule participation est autorisée pour chaque *type*.
+
+ * **adresses**: prend en charge seulement travail et accueil/personal *type*. La maison et personnels de *type* référence la même entrée d'adresse. Une seule participation est autorisée pour chaque *type*.
+
+ * **organisations**: seul est autorisé et ne supporte pas les attributs *pref*, *type*et *Département* .
+
+ * **Remarque**: ne pas pris en charge, retour`null`.
+
+ * **IMS**: ne pas pris en charge, retour`null`.
+
+ * **anniversaires**: ne pas pris en charge, retour`null`.
+
+ * **catégories**: ne pas pris en charge, retour`null`.
+
+ * **remove**: méthode n'est pas prise en charge
+
+### Bizarreries de Windows
+
+ * **photos**: retourne une URL de fichier de l'image, qui est stocké dans le répertoire temporaire de l'application.
+
+ * **anniversaires**: ne pas pris en charge, retour`null`.
+
+ * **catégories**: ne pas pris en charge, retour`null`.
+
+ * **remove**: méthode est uniquement pris en charge dans Windows 10 ou supérieur.
+
+## ContactAddress
+
+Le `ContactAddress` objet Stocke les propriétés d'une seule adresse d'un contact. A `Contact` objet peut inclure plusieurs adresses dans un `ContactAddress[]` tableau.
+
+### Propriétés
+
+ * **pref**: la valeur `true` si ce `ContactAddress` contient la valeur de préférence de l'utilisateur. *(booléen)*
+
+ * **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. *(DOMString)*
+
+ * **mise en forme**: l'adresse complète au format pour l'affichage. *(DOMString)*
+
+ * **adresse**: l'adresse complète. *(DOMString)*
+
+ * **localité**: la ville ou la localité. *(DOMString)*
+
+ * **région**: l'État ou la région. *(DOMString)*
+
+ * **Code postal**: le code zip ou code postal. *(DOMString)*
+
+ * **pays**: le nom du pays. *(DOMString)*
+
+### Plates-formes supportées
+
+ * Amazon Fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 et 8
+ * Windows 8
+ * Windows
+
+### Exemple
+
+ 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) ;
+ }
+ }
+ };
+
+ function onError(contactError) {alert('onError!');} ;
+
+ trouver tous les contacts options var = new ContactFindOptions() ;
+ options.Filter = "" ;
+ filtre var = ["name", « adresses »] ;
+ Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
+
+
+### Android 2.X Quirks
+
+ * **pref**: ne pas pris en charge, retour `false` sur les appareils Android 2.X.
+
+### BlackBerry 10 Quirks
+
+ * **pref**: non pris en charge sur les appareils BlackBerry, retour`false`.
+
+ * **type**: partiellement pris en charge. Seule chaque de *travail* et tapez les adresses de *la maison* peut être stockée par contact.
+
+ * **au format**: partiellement pris en charge. Retourne la concaténation de tous les champs d'adresse BlackBerry.
+
+ * **streetAddress**: prise en charge. Retourne la concaténation de BlackBerry **address1** et **address2** champs d'adresse.
+
+ * **localité**: prise en charge. Stockée dans le champ d'adresse BlackBerry **ville** .
+
+ * **région**: pris en charge. Stockée dans le champ d'adresse BlackBerry **stateProvince** .
+
+ * **Code postal**: prise en charge. Stockée dans le champ d'adresse BlackBerry **zipPostal** .
+
+ * **pays**: prise en charge.
+
+### Bizarreries de FirefoxOS
+
+ * **au format**: actuellement ne pas pris en charge
+
+### Notes au sujet d'iOS
+
+ * **pref**: non pris en charge sur les appareils iOS, retour`false`.
+
+ * **au format**: actuellement ne pas pris en charge.
+
+### Bizarreries de Windows 8
+
+ * **pref**: non pris en charge
+
+### Bizarreries de Windows
+
+ * **pref**: non pris en charge
+
+## ContactError
+
+Le `ContactError` objet est retourné à l'utilisateur via le `contactError` fonction de rappel lorsqu'une erreur survient.
+
+### Propriétés
+
+ * **code**: l'un des codes d'erreur prédéfinis énumérés ci-dessous.
+
+### Constantes
+
+ * `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
+
+Le `ContactField` objet est un composant réutilisable que représente contacter champs génériquement. Chaque `ContactField` objet contient un `value` , `type` , et `pref` propriété. A `Contact` objet stocke plusieurs propriétés dans `ContactField[]` tableaux, tels que téléphone numéros et adresses e-mail.
+
+Dans la plupart des cas, il n'y a pas de valeurs prédéterminées pour une `ContactField` l'attribut **type** de l'objet. Par exemple, un numéro de téléphone peut spécifier des valeurs de **type** de la *maison*, *travail*, *mobile*, *iPhone*ou toute autre valeur qui est pris en charge par la base de contacts de la plate-forme un périphérique particulier. Toutefois, pour les `Contact` **photos** champ, le champ **type** indique le format de l'image retournée : **url** lorsque l'attribut **value** contient une URL vers l'image photo ou *base64* lorsque la **valeur** contient une chaîne codée en base64 image.
+
+### Propriétés
+
+ * **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. *(DOMString)*
+
+ * **valeur**: la valeur du champ, comme un téléphone numéro ou adresse e-mail. *(DOMString)*
+
+ * **pref**: la valeur `true` si ce `ContactField` contient la valeur de préférence de l'utilisateur. *(booléen)*
+
+### Plates-formes supportées
+
+ * Amazon Fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 et 8
+ * Windows 8
+ * Windows
+
+### Exemple
+
+ créer un nouveau contact contact var = navigator.contacts.create() ;
+
+ 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 ;
+
+ enregistrer le contact contact.save() ;
+
+
+### Quirks Android
+
+ * **pref**: ne pas pris en charge, retour`false`.
+
+### BlackBerry 10 Quirks
+
+ * **type**: partiellement pris en charge. Utilisé pour les numéros de téléphone.
+
+ * **valeur**: prise en charge.
+
+ * **pref**: ne pas pris en charge, retour`false`.
+
+### Notes au sujet d'iOS
+
+ * **pref**: ne pas pris en charge, retour`false`.
+
+### Quirks Windows8
+
+ * **pref**: ne pas pris en charge, retour`false`.
+
+### Bizarreries de Windows
+
+ * **pref**: ne pas pris en charge, retour`false`.
+
+## ContactName
+
+Contient différents types d'informations sur un `Contact` nom de l'objet.
+
+### Propriétés
+
+ * **mise en forme**: le nom complet du contact. *(DOMString)*
+
+ * **familyName**: nom de famille du contact. *(DOMString)*
+
+ * **givenName**: prénom du contact. *(DOMString)*
+
+ * **middleName**: deuxième prénom du contact. *(DOMString)*
+
+ * **honorificPrefix**: préfixe du contact (exemple *M.* ou *Mme*) *(DOMString)*
+
+ * **honorificSuffix**: suffixe du contact (exemple *Esq.*). *(DOMString)*
+
+### Plates-formes supportées
+
+ * Amazon Fire OS
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 et 8
+ * Windows 8
+ * Windows
+
+### Exemple
+
+ 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!');} ;
+
+ options de var = new ContactFindOptions() ;
+ options.Filter = "" ;
+ filtre = ["name", « nom »] ;
+ Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
+
+
+### Quirks Android
+
+ * **au format**: partiellement pris en charge et en lecture seule. Retourne la concaténation de `honorificPrefix` , `givenName` , `middleName` , `familyName` , et`honorificSuffix`.
+
+### BlackBerry 10 Quirks
+
+ * **au format**: partiellement pris en charge. Retourne la concaténation de champs **firstName** et **lastName** de BlackBerry.
+
+ * **familyName**: prise en charge. Stockée dans le champ **lastName** BlackBerry.
+
+ * **givenName**: prise en charge. Stockée dans le champ **firstName** BlackBerry.
+
+ * **middleName**: ne pas pris en charge, retour`null`.
+
+ * **honorificPrefix**: ne pas pris en charge, retour`null`.
+
+ * **honorificSuffix**: ne pas pris en charge, retour`null`.
+
+### Bizarreries de FirefoxOS
+
+ * **au format**: partiellement pris en charge et en lecture seule. Retourne la concaténation de `honorificPrefix` , `givenName` , `middleName` , `familyName` , et`honorificSuffix`.
+
+### Notes au sujet d'iOS
+
+ * **au format**: partiellement pris en charge. Retourne la dénomination composée d'iOS, mais est en lecture seule.
+
+### Bizarreries de Windows 8
+
+ * **au format**: c'est le seul nom de propriété et est identique à `displayName` , et`nickname`
+
+ * **familyName**: non pris en charge
+
+ * **givenName**: non pris en charge
+
+ * **middleName**: non pris en charge
+
+ * **honorificPrefix**: non pris en charge
+
+ * **honorificSuffix**: non pris en charge
+
+### Bizarreries de Windows
+
+ * **mise en forme**: il est identique à`displayName`
+
+## ContactOrganization
+
+Le `ContactOrganization` objet Stocke des propriétés un contact de l'organisation. A `Contact` objet contient un ou plusieurs `ContactOrganization` des objets dans un tableau.
+
+### Propriétés
+
+ * **pref**: la valeur `true` si ce `ContactOrganization` contient la valeur de préférence de l'utilisateur. *(booléen)*
+
+ * **type**: une chaîne qui indique quel type de terrain c'est le cas, *maison* par exemple. _(DOMString)
+
+ * **nom**: le nom de l'organisation. *(DOMString)*
+
+ * **Département**: le département et le contrat de travaille pour. *(DOMString)*
+
+ * **titre**: titre du contact auprès de l'organisation. *(DOMString)*
+
+### Plates-formes supportées
+
+ * Android
+ * BlackBerry 10
+ * Firefox OS
+ * iOS
+ * Windows Phone 7 et 8
+ * Windows (Windows 8.1 et Windows Phone 8.1 dispositifs seulement)
+
+### Exemple
+
+ 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) ;
+ }
+ }
+ };
+
+ function onError(contactError) {alert('onError!');} ;
+
+ options de var = new ContactFindOptions() ;
+ options.Filter = "" ;
+ filtre = ["displayName", « organisations »] ;
+ Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
+
+
+### Android 2.X Quirks
+
+ * **pref**: ne pas pris en charge par des dispositifs Android 2.X, retour`false`.
+
+### BlackBerry 10 Quirks
+
+ * **pref**: ne pas pris en charge par les appareils BlackBerry, retour`false`.
+
+ * **type**: ne pas pris en charge par les appareils BlackBerry, retour`null`.
+
+ * **nom**: partiellement pris en charge. Le premier nom de l'organisme est stocké dans le champ **company** de BlackBerry.
+
+ * **Département**: ne pas pris en charge, retour`null`.
+
+ * **titre**: partiellement pris en charge. Le premier titre de l'organisation est stocké dans le champ de **jobTitle** BlackBerry.
+
+### Firefox OS Quirks
+
+ * **pref**: non pris en charge
+
+ * **type**: non pris en charge
+
+ * **Département**: non pris en charge
+
+ * Les champs **nom** et **titre** stocké dans **org** et **jobTitle**.
+
+### Notes au sujet d'iOS
+
+ * **pref**: non pris en charge sur les appareils iOS, retour`false`.
+
+ * **type**: non pris en charge sur les appareils iOS, retour`null`.
+
+ * **nom**: partiellement pris en charge. Le premier nom de l'organisme est stocké dans le champ de **kABPersonOrganizationProperty** iOS.
+
+ * **Département**: partiellement pris en charge. Le premier nom de département est stocké dans le champ de **kABPersonDepartmentProperty** iOS.
+
+ * **titre**: partiellement pris en charge. Le premier titre est stocké dans le champ de **kABPersonJobTitleProperty** iOS.
+
+### Bizarreries de Windows
+
+ * **pref**: ne pas pris en charge, retour`false`.
+
+ * **type**: ne pas pris en charge, retour`null`.
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org