You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by st...@apache.org on 2014/06/05 01:41:42 UTC
[2/3] CB-6127 Spanish and French Translations added. Github close #25
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/c23af568/doc/it/index.md
----------------------------------------------------------------------
diff --git a/doc/it/index.md b/doc/it/index.md
new file mode 100644
index 0000000..5d67901
--- /dev/null
+++ b/doc/it/index.md
@@ -0,0 +1,668 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# org.apache.cordova.contacts
+
+Fornisce l'accesso al database di contatti del dispositivo.
+
+**Avviso**: raccolta e utilizzo dei dati di contatto solleva questioni di privacy importante. Politica sulla privacy dell'app dovrebbe discutere come app utilizza i dati di contatto e se è condiviso con altre parti. Informazioni di contatto sono considerate sensibile perché rivela le persone con cui una persona comunica. Pertanto, oltre alla politica di privacy dell'app, è fortemente consigliabile fornendo un preavviso di just-in-time prima app accede o utilizza i dati di contatto, se il sistema operativo del dispositivo non farlo già. Tale comunicazione deve fornire le informazioni stesse notate sopra, oltre ad ottenere l'autorizzazione (ad esempio, presentando scelte per **OK** e **No grazie**). Si noti che alcuni mercati app possono richiedere l'app per fornire un preavviso di just-in-time e ottenere l'autorizzazione dell'utente prima di accedere ai dati di contatto. Un'esperienza utente chiara e facile--capisce che circonda l'uso del contatto dati aiuta a evitare la confusio
ne dell'utente e percepito un uso improprio dei dati di contatto. Per ulteriori informazioni, vedere la guida sulla Privacy.
+
+## Installazione
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+### Firefox OS stranezze
+
+Creare **www/manifest.webapp** come descritto nel [Manifesto Docs][1]. Aggiungi permisions rilevanti. C'è anche la necessità di modificare il tipo di webapp in "privilegiato" - [Manifesto Docs][2]. **AVVERTENZA**: tutte le apps privilegiato applicare [Content Security Policy][3] che vieta script inline. Inizializzare l'applicazione in un altro modo.
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+ "type": "privileged",
+ "permissions": {
+ "contacts": {
+ "access": "readwrite",
+ "description": "Describe why there is a need for such permission"
+ }
+ }
+
+
+### Stranezze di Windows 8
+
+Windows 8 contatti sono readonly. Tramite i contatti di Cordova API non sono queryable/ricerche, si dovrebbe informare l'utente di scegliere un contatto come una chiamata a contacts.pickContact che aprirà l'app 'Persone' dove l'utente deve scegliere un contatto. Eventuali contatti restituiti sono readonly, quindi l'applicazione non può modificarli.
+
+## Navigator.contacts
+
+### Metodi
+
+* navigator.contacts.create
+* navigator.contacts.find
+* navigator.contacts.pickContact
+
+### Oggetti
+
+* Contatto
+* ContactName
+* ContactField
+* ContactAddress
+* ContactOrganization
+* ContactFindOptions
+* ContactError
+* ContactFieldType
+
+## Navigator.contacts.Create
+
+Il `navigator.contacts.create` metodo sincrono e restituisce un nuovo `Contact` oggetto.
+
+Questo metodo non mantiene l'oggetto contatto nel database contatti dispositivo, per cui è necessario richiamare il `Contact.save` metodo.
+
+### Piattaforme supportate
+
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 e 8
+
+### Esempio
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## navigator.contacts.find
+
+Il `navigator.contacts.find` metodo in modo asincrono, esegue una query sul database di contatti del dispositivo e restituisce una matrice di `Contact` oggetti. Gli oggetti risultanti sono passati per la `contactSuccess` funzione di callback specificato dal parametro **contactSuccess** .
+
+Il parametro **contactFields** specifica i campi per essere utilizzato come un qualificatore di ricerca. Un parametro di lunghezza zero, **contactFields** non è valido e si traduce in `ContactError.INVALID_ARGUMENT_ERROR` . Un valore di **contactFields** di `"*"` restituisce tutti i contatti di campi.
+
+La stringa di **contactFindOptions.filter** può essere utilizzata come un filtro di ricerca quando una query sul database di contatti. Se fornito, una distinzione, corrispondenza parziale valore viene applicato a ogni campo specificato nel parametro **contactFields** . Se esiste una corrispondenza per *qualsiasi* dei campi specificati, viene restituito il contatto. Uso **contactFindOptions.desiredFields** parametro di controllo quale contattare la proprietà deve essere rispedito indietro.
+
+### Parametri
+
+* **contactSuccess**: funzione di callback successo richiamato con la matrice di oggetti contatto restituiti dal database. [Richiesto]
+
+* **contactError**: funzione di callback di errore, viene richiamato quando si verifica un errore. [Facoltativo]
+
+* **contactFields**: contattare campi da utilizzare come un qualificatore di ricerca. *(DOMString[])* [Richiesto]
+
+* **contactFindOptions**: opzioni per filtrare navigator.contacts di ricerca. [Facoltativo] I tasti sono:
+
+* **filtro**: la stringa di ricerca utilizzata per trovare navigator.contacts. *(DOMString)* (Default:`""`)
+
+* **multiple**: determina se l'operazione di ricerca restituisce più navigator.contacts. *(Booleano)* (Default:`false`)
+
+ * **desiredFields**: contattare i campi per essere tornato indietro. Se specificato, il conseguente `Contact` oggetto presenta solo i valori per questi campi. *(DOMString[])* [Facoltativo]
+
+### Piattaforme supportate
+
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 e 8
+
+### Esempio
+
+ function onSuccess(contacts) {
+ alert('Found ' + contacts.length + ' contacts.');
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ // find all contacts with 'Bob' in any name field
+ var options = new ContactFindOptions();
+ options.filter = "Bob";
+ options.multiple = true;
+ options.desiredFields = [navigator.contacts.fieldType.id];
+ var fields = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+ navigator.contacts.find(onSuccess, onError, fields, options);
+
+
+## navigator.contacts.pickContact
+
+Il `navigator.contacts.pickContact` Metodo lancia il contatto selettore per selezionare un singolo contatto. L'oggetto risultante è passato per la `contactSuccess` funzione di callback specificato dal parametro **contactSuccess** .
+
+### Parametri
+
+* **contactSuccess**: funzione di callback di successo viene richiamato con il singolo oggetto di contatto. [Richiesto]
+
+* **contactError**: funzione di callback di errore, viene richiamato quando si verifica un errore. [Facoltativo]
+
+### Piattaforme supportate
+
+* Android
+* iOS
+* Windows Phone 8
+* Windows 8
+
+### Esempio
+
+ navigator.contacts.pickContact(function(contact){
+ console.log('The following contact has been selected:' + JSON.stringify(contact));
+ },function(err){
+ console.log('Error: ' + err);
+ });
+
+
+## Contatto
+
+Il `Contact` oggetto rappresenta il contatto di un utente. Contatti possono essere creati, memorizzati o rimossi dal database di contatti dispositivo. Contatti possono anche essere estratto (singolarmente o in blocco) dal database richiamando il `navigator.contacts.find` metodo.
+
+**Nota**: non tutti i campi di contatto sopra elencati sono supportati su ogni piattaforma del dispositivo. Consultare la sezione di *stranezze* su ogni piattaforma per dettagli.
+
+### Proprietà
+
+* **ID**: un identificatore univoco globale. *(DOMString)*
+
+* **displayName**: il nome di questo contatto, adatto per la visualizzazione a utenti finali. *(DOMString)*
+
+* **nome**: un oggetto che contiene tutti i componenti di un nome di persone. *(ContactName)*
+
+* **Nickname**: un nome informale con cui affrontare il contatto. *(DOMString)*
+
+* **phoneNumbers**: una matrice di numeri di telefono del contatto. *(ContactField[])*
+
+* **email**: una matrice di indirizzi di posta elettronica del contatto. *(ContactField[])*
+
+* **indirizzi**: una matrice di indirizzi di contatto. *(ContactAddress[])*
+
+* **IMS**: una matrice di indirizzi IM tutto il contatto. *(ContactField[])*
+
+* **organizzazioni**: una matrice di organizzazioni di tutto il contatto. *(ContactOrganization[])*
+
+* **compleanno**: il compleanno del contatto. *(Data)*
+
+* **Nota**: una nota sul contatto. *(DOMString)*
+
+* **foto**: una matrice di foto del contatto. *(ContactField[])*
+
+* **categorie**: matrice di tutte le categorie definite dall'utente connesso con il contatto. *(ContactField[])*
+
+* **URL**: matrice di pagine web connesso con il contatto. *(ContactField[])*
+
+### Metodi
+
+* **clone**: restituisce una nuova `Contact` oggetto che è una copia completa dell'oggetto chiamante, con la `id` proprietà impostata`null`.
+
+* **rimuovere**: rimuove il contatto dal database contatti dispositivo, altrimenti esegue un callback di errore con un `ContactError` oggetto.
+
+* **Salva**: salva un nuovo contatto nel database di contatti del dispositivo, o aggiorna un contatto esistente se esiste già un contatto con lo stesso **id** .
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 e 8
+* Windows 8
+
+### Esempio di salvare
+
+ function onSuccess(contact) {
+ alert("Save Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // create a new contact object
+ var contact = navigator.contacts.create();
+ contact.displayName = "Plumber";
+ contact.nickname = "Plumber"; // specify both to support all devices
+
+ // populate some fields
+ var name = new ContactName();
+ name.givenName = "Jane";
+ name.familyName = "Doe";
+ contact.name = name;
+
+ // save to device
+ contact.save(onSuccess,onError);
+
+
+### Esempio di clone
+
+ // clone the contact object
+ var clone = contact.clone();
+ clone.name.givenName = "John";
+ console.log("Original contact name = " + contact.name.givenName);
+ console.log("Cloned contact name = " + clone.name.givenName);
+
+
+### Rimuovere esempio
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### Stranezze di Android 2. x
+
+* **categorie**: non è supportato sui dispositivi Android 2. x, restituendo`null`.
+
+### BlackBerry 10 capricci
+
+* **ID**: assegnate dal dispositivo quando si salva il contatto.
+
+### Capricci di FirefoxOS
+
+* **categorie**: parzialmente supportati. Campi **pref** e **tipo** stanno tornando`null`
+
+* **IMS**: non supportato
+
+* **foto**: non supportato
+
+### iOS stranezze
+
+* **displayName**: non supportata su iOS, tornando `null` se non c'è nessun `ContactName` specificato, nel qual caso restituisce il nome composito, **soprannome** o `""` , rispettivamente.
+
+* **compleanno**: deve essere inserito come un JavaScript `Date` oggetto, allo stesso modo viene restituito.
+
+* **foto**: restituisce un URL del File dell'immagine, che viene memorizzato nella directory temporanea dell'applicazione. Contenuto della directory temporanea vengono rimossi quando l'applicazione termina.
+
+* **categorie**: questa proprietà non è attualmente supportata, restituendo`null`.
+
+### Windows Phone 7 e 8 stranezze
+
+* **displayName**: quando si crea un contatto, il valore specificato per il parametro del nome di visualizzazione è diverso dal nome visualizzato Estratto quando trovare il contatto.
+
+* **URL**: quando si crea un contatto, gli utenti possono inserire e salvare più di un indirizzo web, ma solo uno è disponibile durante la ricerca del contatto.
+
+* **phoneNumbers**: non è supportata l'opzione *pref* . Il *tipo* non è supportato in un'operazione di *trovare* . Un solo `phoneNumber` è consentita per ogni *tipo*.
+
+* **email**: non è supportata l'opzione *pref* . Home e personal fa riferimento la stessa voce di posta elettronica. È consentito un solo ingresso per ogni *tipo*.
+
+* **indirizzi**: supporta solo lavoro e casa/personali *tipo*. Il riferimento principale e personale *tipo* la stessa voce di indirizzo. È consentito un solo ingresso per ogni *tipo*.
+
+* **organizzazioni**: solo uno è consentito e non supporta gli attributi *pref*, *tipo*e *dipartimento* .
+
+* **Nota**: non supportato, restituendo`null`.
+
+* **IMS**: non supportato, restituendo`null`.
+
+* **compleanni**: non supportato, restituendo`null`.
+
+* **categorie**: non supportato, restituendo`null`.
+
+## ContactAddress
+
+Il `ContactAddress` oggetto memorizza le proprietà di un singolo indirizzo di un contatto. A `Contact` oggetto può includere più di un indirizzo in un `ContactAddress[]` matrice.
+
+### Proprietà
+
+* **pref**: impostare su `true` se questo `ContactAddress` contiene il valore dell'utente preferito. *(booleano)*
+
+* **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. *(DOMString)*
+
+* **formattato**: indirizzo completo formattato per la visualizzazione. *(DOMString)*
+
+* **streetAddress**: l'indirizzo completo. *(DOMString)*
+
+* **località**: la città o località. *(DOMString)*
+
+* **regione**: lo stato o la regione. *(DOMString)*
+
+* **postalCode**: il codice postale o il codice postale. *(DOMString)*
+
+* **paese**: il nome del paese. *(DOMString)*
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 e 8
+* Windows 8
+
+### Esempio
+
+ // display the address information for all contacts
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ for (var j = 0; j < contacts[i].addresses.length; j++) {
+ alert("Pref: " + contacts[i].addresses[j].pref + "\n" +
+ "Type: " + contacts[i].addresses[j].type + "\n" +
+ "Formatted: " + contacts[i].addresses[j].formatted + "\n" +
+ "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+ "Locality: " + contacts[i].addresses[j].locality + "\n" +
+ "Region: " + contacts[i].addresses[j].region + "\n" +
+ "Postal Code: " + contacts[i].addresses[j].postalCode + "\n" +
+ "Country: " + contacts[i].addresses[j].country);
+ }
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ // find all contacts
+ var options = new ContactFindOptions();
+ options.filter = "";
+ var filter = ["displayName", "addresses"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### Stranezze di Android 2. x
+
+* **pref**: non supportato, tornando `false` su dispositivi Android 2. x.
+
+### BlackBerry 10 capricci
+
+* **pref**: non è supportato sui dispositivi BlackBerry, restituendo`false`.
+
+* **tipo**: parzialmente supportati. Solo uno di *lavoro* e *casa* tipo indirizzi può essere memorizzato per ciascun contatto.
+
+* **formattato**: parzialmente supportati. Restituisce una concatenazione di tutti i campi Indirizzo BlackBerry.
+
+* **streetAddress**: supportato. Restituisce una concatenazione di BlackBerry **Indirizzo1** e **Indirizzo2** campi indirizzo.
+
+* **località**: supportato. Memorizzato nel campo indirizzo **città** di BlackBerry.
+
+* **regione**: supportato. Memorizzato nel campo indirizzo di **stateProvince** BlackBerry.
+
+* **postalCode**: supportato. Memorizzato nel campo dell'indirizzo **zipPostal** BlackBerry.
+
+* **paese**: supportato.
+
+### Capricci di FirefoxOS
+
+* **formattato**: attualmente non supportato
+
+### iOS stranezze
+
+* **pref**: non è supportato sui dispositivi iOS, restituendo`false`.
+
+* **formattato**: attualmente non supportati.
+
+### Stranezze di Windows 8
+
+* **pref**: non supportato
+
+## ContactError
+
+Il `ContactError` oggetto viene restituito all'utente attraverso la `contactError` funzione di callback quando si verifica un errore.
+
+### Proprietà
+
+* **codice**: uno dei codici di errore predefiniti elencati di seguito.
+
+### Costanti
+
+* `ContactError.UNKNOWN_ERROR` (code 0)
+* `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+* `ContactError.TIMEOUT_ERROR` (code 2)
+* `ContactError.PENDING_OPERATION_ERROR` (code 3)
+* `ContactError.IO_ERROR` (code 4)
+* `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+* `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+Il `ContactField` oggetto è un componente riutilizzabile che rappresenta Contatta campi genericamente. Ogni `ContactField` oggetto contiene un `value` , `type` , e `pref` proprietà. A `Contact` oggetto memorizza diverse proprietà in `ContactField[]` matrici, come indirizzi di e-mail e numeri di telefono.
+
+Nella maggior parte dei casi, non esistono valori pre-determinati per un `ContactField` **tipo** attributo oggetto. Ad esempio, un numero di telefono può specificare valori di **tipo** di *casa*, *lavoro*, *mobile*, *iPhone*o qualsiasi altro valore che è supportato dal database dei contatti su una piattaforma particolare dispositivo. Tuttavia, per la `Contact` **foto** campo, il campo **tipo** indica il formato dell'immagine restituita: **url** quando il **valore** di attributo contiene un URL per l'immagine fotografica, o *base64* , quando il **valore** contiene una stringa con codifica base64 immagine.
+
+### Proprietà
+
+* **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. *(DOMString)*
+
+* **valore**: il valore del campo, ad esempio un telefono numero o indirizzo e-mail. *(DOMString)*
+
+* **pref**: impostare su `true` se questo `ContactField` contiene il valore dell'utente preferito. *(booleano)*
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 e 8
+* Windows 8
+
+### Esempio
+
+ // create a new contact
+ var contact = navigator.contacts.create();
+
+ // store contact phone numbers in ContactField[]
+ var phoneNumbers = [];
+ phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+ phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+ phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+ contact.phoneNumbers = phoneNumbers;
+
+ // save the contact
+ contact.save();
+
+
+### Stranezze Android
+
+* **pref**: non supportato, restituendo`false`.
+
+### BlackBerry 10 capricci
+
+* **tipo**: parzialmente supportati. Usato per i numeri di telefono.
+
+* **valore**: supportato.
+
+* **pref**: non supportato, restituendo`false`.
+
+### iOS stranezze
+
+* **pref**: non supportato, restituendo`false`.
+
+### Stranezze di Windows8
+
+* **pref**: non supportato, restituendo`false`.
+
+## ContactName
+
+Contiene diversi tipi di informazioni circa un `Contact` nome dell'oggetto.
+
+### Proprietà
+
+* **formattato**: il nome completo del contatto. *(DOMString)*
+
+* **familyName**: cognome del contatto. *(DOMString)*
+
+* **givenName**: nome del contatto. *(DOMString)*
+
+* **middleName**: il nome del contatto medio. *(DOMString)*
+
+* **honorificPrefix**: prefisso del contatto (esempio *Mr* o *Dr*) *(DOMString)*
+
+* **honorificSuffix**: suffisso del contatto (esempio *Esq.*). *(DOMString)*
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android 2. x
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 e 8
+* Windows 8
+
+### Esempio
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ alert("Formatted: " + contacts[i].name.formatted + "\n" +
+ "Family Name: " + contacts[i].name.familyName + "\n" +
+ "Given Name: " + contacts[i].name.givenName + "\n" +
+ "Middle Name: " + contacts[i].name.middleName + "\n" +
+ "Suffix: " + contacts[i].name.honorificSuffix + "\n" +
+ "Prefix: " + contacts[i].name.honorificSuffix);
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ var options = new ContactFindOptions();
+ options.filter = "";
+ filter = ["displayName", "name"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### Stranezze Android
+
+* **formattato**: parzialmente supportati e di sola lettura. Restituisce una concatenazione di `honorificPrefix` , `givenName` , `middleName` , `familyName` , e`honorificSuffix`.
+
+### BlackBerry 10 capricci
+
+* **formattato**: parzialmente supportati. Restituisce una concatenazione di campi **firstName** e **lastName** BlackBerry.
+
+* **familyName**: supportato. Archiviato in campo **lastName** BlackBerry.
+
+* **givenName**: supportato. Archiviato in campo **firstName** BlackBerry.
+
+* **middleName**: non supportato, restituendo`null`.
+
+* **honorificPrefix**: non supportato, restituendo`null`.
+
+* **honorificSuffix**: non supportato, restituendo`null`.
+
+### Capricci di FirefoxOS
+
+* **formattato**: parzialmente supportati e di sola lettura. Restituisce una concatenazione di `honorificPrefix` , `givenName` , `middleName` , `familyName` , e`honorificSuffix`.
+
+### iOS stranezze
+
+* **formattato**: parzialmente supportati. Restituisce il nome composito di iOS, ma è di sola lettura.
+
+### Stranezze di Windows 8
+
+* **formattato**: questo è l'unico nome proprietà ed è identico a `displayName` , e`nickname`
+
+* **familyName**: non supportato
+
+* **givenName**: non supportato
+
+* **middleName**: non supportato
+
+* **honorificPrefix**: non supportato
+
+* **honorificSuffix**: non supportato
+
+## ContactOrganization
+
+Il `ContactOrganization` oggetto memorizza la proprietà di organizzazione di un contatto. A `Contact` oggetto memorizza uno o più `ContactOrganization` gli oggetti in una matrice.
+
+### Proprietà
+
+* **pref**: impostare su `true` se questo `ContactOrganization` contiene il valore dell'utente preferito. *(booleano)*
+
+* **tipo**: una stringa che indica il tipo di campo è, *casa* ad esempio. _(DOMString)
+
+* **nome**: il nome dell'organizzazione. *(DOMString)*
+
+* **dipartimento**: contratto lavora per il dipartimento. *(DOMString)*
+
+* **titolo**: titolo del contatto presso l'organizzazione. *(DOMString)*
+
+### Piattaforme supportate
+
+* Android
+* BlackBerry 10
+* Firefox OS
+* iOS
+* Windows Phone 7 e 8
+
+### Esempio
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ for (var j = 0; j < contacts[i].organizations.length; j++) {
+ alert("Pref: " + contacts[i].organizations[j].pref + "\n" +
+ "Type: " + contacts[i].organizations[j].type + "\n" +
+ "Name: " + contacts[i].organizations[j].name + "\n" +
+ "Department: " + contacts[i].organizations[j].department + "\n" +
+ "Title: " + contacts[i].organizations[j].title);
+ }
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ var options = new ContactFindOptions();
+ options.filter = "";
+ filter = ["displayName", "organizations"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### Stranezze di Android 2. x
+
+* **pref**: non supportato dai dispositivi Android 2. x, restituendo`false`.
+
+### BlackBerry 10 capricci
+
+* **pref**: non supportato dai dispositivi BlackBerry, restituendo`false`.
+
+* **tipo**: non supportato dai dispositivi BlackBerry, restituendo`null`.
+
+* **nome**: parzialmente supportati. Il primo nome dell'organizzazione è memorizzato nel campo **azienda** BlackBerry.
+
+* **dipartimento**: non supportato, restituendo`null`.
+
+* **titolo**: parzialmente supportati. Il primo titolo di organizzazione è memorizzato nel campo **jobTitle** BlackBerry.
+
+### Firefox OS stranezze
+
+* **pref**: non supportato
+
+* **tipo**: non supportato
+
+* **dipartimento**: non supportato
+
+* Campi **nome** e **titolo** memorizzato in **org** e **jobTitle**.
+
+### iOS stranezze
+
+* **pref**: non è supportato sui dispositivi iOS, restituendo`false`.
+
+* **tipo**: non è supportato sui dispositivi iOS, restituendo`null`.
+
+* **nome**: parzialmente supportati. Il primo nome dell'organizzazione è memorizzato nel campo **kABPersonOrganizationProperty** iOS.
+
+* **dipartimento**: parzialmente supportati. Il primo nome del dipartimento è memorizzato nel campo **kABPersonDepartmentProperty** iOS.
+
+* **titolo**: parzialmente supportati. Il primo titolo è memorizzato nel campo **kABPersonJobTitleProperty** iOS.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/c23af568/doc/ja/index.md
----------------------------------------------------------------------
diff --git a/doc/ja/index.md b/doc/ja/index.md
new file mode 100644
index 0000000..82ffb11
--- /dev/null
+++ b/doc/ja/index.md
@@ -0,0 +1,668 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# org.apache.cordova.contacts
+
+デバイスの連絡先データベースへのアクセスを提供します。
+
+**警告**: 連絡先データの収集と利用を重要なプライバシーの問題を発生させます。 アプリのプライバシー ポリシー アプリが連絡先データを使用する方法と、他の当事者では共有されているかどうかを話し合う必要があります。 人誰と通信する人々 を明らかにするために、連絡先情報が機密と見なされます。 したがって、アプリのプライバシー ポリシーに加えて、強くする必要がありますデバイスのオペレーティング システムが既にしない場合アプリにアクセスまたは連絡先のデータを使用する前に - 時間のお知らせを提供します。 その通知は、上記の (例えば、 **[ok]**を**おかげで**選択肢を提示する) によってユーザーのアクセス許可を取得するだけでなく、同じ情報を提供する必要があります。 いくつかのアプリのマーケットプ レ
ース - 時間の通知を提供して、連絡先データにアクセスする前にユーザーの許可を取得するアプリをする必要がありますに注意してください。 連絡先データは、ユーザーの混乱を避けるのに役立ちますの使用および連絡先データの知覚の誤用を囲む明確でわかりやすいユーザー エクスペリエンス。 詳細については、プライバシーに関するガイドを参照してください。
+
+## インストール
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+### Firefox OS 癖
+
+[マニフェストのドキュメント][1]で説明されているように、 **www/manifest.webapp**を作成します。 関連する権限を追加します。 [マニフェストのドキュメント][2]「特権」- に web アプリケーションの種類を変更する必要も。 **警告**: すべての特権を持つアプリケーション インライン スクリプトを禁止している[コンテンツのセキュリティ ポリシー][3]を適用します。 別の方法で、アプリケーションを初期化します。
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+ "type": "privileged",
+ "permissions": {
+ "contacts": {
+ "access": "readwrite",
+ "description": "Describe why there is a need for such permission"
+ }
+ }
+
+
+### Windows 8 の癖
+
+Windows 8 の連絡先は、読み取り専用です。 コルドバ API コンタクトを介してされませんクエリ/検索可能で、ユーザーに通知する必要があります連絡先を選択 '人' アプリを開くことが contacts.pickContact への呼び出しとして、ユーザーが連絡先を選択する必要があります。 戻される連絡先は読み取り専用、アプリケーションを変更することはできません。
+
+## navigator.contacts
+
+### メソッド
+
+* navigator.contacts.create
+* navigator.contacts.find
+* navigator.contacts.pickContact
+
+### オブジェクト
+
+* お問い合わせ
+* 得意先コード
+* ContactField
+* ContactAddress
+* ContactOrganization
+* ContactFindOptions
+* ContactError
+* ContactFieldType
+
+## navigator.contacts.create
+
+`navigator.contacts.create`メソッドは同期的にし、新しいを返します `Contact` オブジェクト。
+
+このメソッドを呼び出す必要があるデバイスの連絡先データベースに連絡先オブジェクトを保持しない、 `Contact.save` メソッド。
+
+### サポートされているプラットフォーム
+
+* アンドロイド
+* ブラックベリー 10
+* Firefox の OS
+* iOS
+* Windows Phone 7 と 8
+
+### 例
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## navigator.contacts.find
+
+`navigator.contacts.find`デバイスの連絡先データベースをクエリの配列を返すメソッドは、非同期的に実行されます `Contact` オブジェクト。 結果として得られるオブジェクトに渡される、 `contactSuccess` 、 **contactSuccess**パラメーターで指定されたコールバック関数。
+
+**連絡先**パラメーター検索の修飾子として使用するフィールドを指定します。 ゼロ長さ**連絡先**パラメーターが有効になり `ContactError.INVALID_ARGUMENT_ERROR` 。 **連絡先**値 `"*"` すべての連絡先フィールドを返します。
+
+**ContactFindOptions.filter**文字列の連絡先データベースを照会するときに検索フィルターとして使用できます。 指定した場合、大文字と小文字、部分的な値の一致する**連絡先**パラメーターで指定されたフィールドごとに適用されます。 一致する*任意*指定のフィールドがある場合は、連絡先が返されます。 バック連絡先プロパティを制御する**contactFindOptions.desiredFields**パラメーターを使用しますが返される必要があります。
+
+### パラメーター
+
+* **contactSuccess**: Contact オブジェクトの配列に呼び出される成功コールバック関数は、データベースから返されます。[必須]
+
+* **contactError**: エラー コールバック関数は、エラーが発生したときに呼び出されます。[オプション]
+
+* **連絡先**: 連絡先検索修飾子として使用するフィールド。*(DOMString[])*[必須]
+
+* **contactFindOptions**: navigator.contacts をフィルターするオプションを検索します。[オプション]キーは次のとおりです。
+
+* **フィルター**: navigator.contacts の検索に使用する検索文字列。*（，）*(既定値します。`""`)
+
+* **複数**: 複数 navigator.contacts かどうかは、検索操作に返すを決定します。*(ブール値)*(既定値します。`false`)
+
+ * **desiredFields**： 戻って返されるフィールドに問い合わせてください。指定した場合、結果として `Contact` オブジェクトのみ機能のこれらのフィールドの値。*(DOMString[])*[オプション]
+
+### サポートされているプラットフォーム
+
+* アンドロイド
+* ブラックベリー 10
+* Firefox の OS
+* iOS
+* Windows Phone 7 と 8
+
+### 例
+
+ function onSuccess(contacts) {
+ alert('Found ' + contacts.length + ' contacts.');
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ // find all contacts with 'Bob' in any name field
+ var options = new ContactFindOptions();
+ options.filter = "Bob";
+ options.multiple = true;
+ options.desiredFields = [navigator.contacts.fieldType.id];
+ var fields = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+ navigator.contacts.find(onSuccess, onError, fields, options);
+
+
+## navigator.contacts.pickContact
+
+`navigator.contacts.pickContact`メソッド連絡先ピッカーを起動します 1 つの連絡先を選択します。 結果として得られるオブジェクトに渡される、 `contactSuccess` 、 **contactSuccess**パラメーターで指定されたコールバック関数。
+
+### パラメーター
+
+* **contactSuccess**: 1 つの連絡先オブジェクトに呼び出される成功コールバック関数。[必須]
+
+* **contactError**: エラー コールバック関数は、エラーが発生したときに呼び出されます。[オプション]
+
+### サポートされているプラットフォーム
+
+* アンドロイド
+* iOS
+* Windows Phone 8
+* Windows 8
+
+### 例
+
+ navigator.contacts.pickContact(function(contact){
+ console.log('The following contact has been selected:' + JSON.stringify(contact));
+ },function(err){
+ console.log('Error: ' + err);
+ });
+
+
+## お問い合わせ
+
+`Contact`オブジェクトは、ユーザーの連絡先を表します。 連絡先の作成、格納、またはデバイスの連絡先データベースから削除することができます。 連絡先も取得できます (個別にまたは一括） をデータベースから呼び出すことによって、 `navigator.contacts.find` メソッド。
+
+**注**: すべて上記の連絡先フィールドのすべてのデバイス プラットフォームでサポートされます。詳細については各プラットフォームの*互換*セクションを確認してください。
+
+### プロパティ
+
+* **id**： グローバルに一意の識別子。*（，）*
+
+* **displayName**: エンド ・ ユーザーへの表示に適した、この連絡先の名前。*（，）*
+
+* **名前**： 人の名前のすべてのコンポーネントを格納するオブジェクト。*(ContactName)*
+
+* **ニックネーム**: 連絡先のアドレスに使用するカジュアルな名前。*（，）*
+
+* **電話番号**: 連絡先の電話番号の配列。*(ContactField[])*
+
+* **メール**： 連絡先の電子メール アドレスの配列。*(ContactField[])*
+
+* **アドレス**: 連絡先のアドレスの配列。*(ContactAddress[])*
+
+* **ims**： 連絡先の IM アドレスの配列。*(ContactField[])*
+
+* **組織**: 連絡先の組織の配列。*(ContactOrganization[])*
+
+* **誕生日**: 連絡先の誕生日。*（日）*
+
+* **注**: 連絡先についてのメモ。*（，）*
+
+* **写真**: 連絡先の写真の配列。*(ContactField[])*
+
+* **カテゴリ**: 取引先担当者に関連付けられているすべてのユーザー定義カテゴリの配列。*(ContactField[])*
+
+* **url**: 取引先担当者に関連付けられている web ページの配列。*(ContactField[])*
+
+### メソッド
+
+* **クローン**： 新しいを返します `Contact` と呼び出し元のオブジェクトのディープ コピーであるオブジェクトの `id` プロパティに設定`null`.
+
+* **削除**: デバイスの連絡先データベースから連絡先を削除します、それ以外の場合のためのエラー コールバックを実行する、 `ContactError` オブジェクト。
+
+* **保存**: デバイスの連絡先データベースに新しい連絡先を保存または同じ**id**を持つ連絡先が既に存在する場合、既存の連絡先を更新します。
+
+### サポートされているプラットフォーム
+
+* アマゾン火 OS
+* アンドロイド
+* ブラックベリー 10
+* Firefox の OS
+* iOS
+* Windows Phone 7 と 8
+* Windows 8
+
+### 保存の例
+
+ function onSuccess(contact) {
+ alert("Save Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // create a new contact object
+ var contact = navigator.contacts.create();
+ contact.displayName = "Plumber";
+ contact.nickname = "Plumber"; // specify both to support all devices
+
+ // populate some fields
+ var name = new ContactName();
+ name.givenName = "Jane";
+ name.familyName = "Doe";
+ contact.name = name;
+
+ // save to device
+ contact.save(onSuccess,onError);
+
+
+### クローンの例
+
+ // clone the contact object
+ var clone = contact.clone();
+ clone.name.givenName = "John";
+ console.log("Original contact name = " + contact.name.givenName);
+ console.log("Cloned contact name = " + clone.name.givenName);
+
+
+### 削除の例
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### アンドロイド 2.X 癖
+
+* **カテゴリ**: 返す 2.X の Android デバイスでサポートされていません`null`.
+
+### ブラックベリー 10 癖
+
+* **id**: 連絡先を保存するときに、デバイスによって割り当てられます。
+
+### FirefoxOS の癖
+
+* **カテゴリ**: 部分的にサポートされます。フィールド**県**・**タイプ**を返す`null`
+
+* **ims**: サポートされていません。
+
+* **写真**: サポートされていません。
+
+### iOS の癖
+
+* **displayName**: 返す iOS でサポートされていない `null` がない限り、ない `ContactName` 指定すると、その場合は複合名、**ニックネーム**を返しますまたは `""` 、それぞれ。
+
+* **誕生日**: JavaScript として入力する必要があります `Date` オブジェクト、同じ方法が返されます。
+
+* **写真**： アプリケーションの一時ディレクトリに格納されているイメージへのファイルの URL を返します。一時ディレクトリの内容は、アプリケーションの終了時に削除されます。
+
+* **カテゴリ**: このプロパティは現在サポートされていません、返す`null`.
+
+### Windows Phone 7 と 8 癖
+
+* **displayName**: 表示名パラメーターの表示名と異なるために提供値を取得、連絡先を検索するとき、連絡先を作成するとき。
+
+* **url**: 連絡先を作成するときユーザー入力保存でき、1 つ以上の web アドレスが 1 つだけ、連絡先を検索するとき。
+
+* **電話番号**:*県*オプションはサポートされていません。 *型*は、*検索*操作ではサポートされていません。 1 つだけ `phoneNumber` は各*タイプ*の許可.
+
+* **メール**：*県*オプションはサポートされていません。家庭や個人的なメールと同じエントリを参照します。各*タイプ*の 1 つだけのエントリが許可されて.
+
+* **アドレス**: 仕事とホーム/パーソナル*タイプ*のみをサポートしています。家庭や個人*型*参照して同じアドレス エントリ。各*タイプ*の 1 つだけのエントリが許可されて.
+
+* **組織**： 1 つだけが許可され、*県*、*タイプ*、および*部門*の属性をサポートしていません。
+
+* **注**: サポートされていないを返す`null`.
+
+* **ims**: サポートされていないを返す`null`.
+
+* **誕生日**: サポートされていないを返す`null`.
+
+* **カテゴリ**: サポートされていないを返す`null`.
+
+## ContactAddress
+
+`ContactAddress`オブジェクトの連絡先の 1 つのアドレスのプロパティが格納されます。 A `Contact` オブジェクトで 1 つ以上のアドレスを含めることができます、 `ContactAddress[]` 配列。
+
+### プロパティ
+
+* **県**: に設定されている `true` 場合は、この `ContactAddress` ユーザーの推奨値が含まれています。*(ブール値)*
+
+* **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。*（，）*
+
+* **書式設定**: 表示用にフォーマットの完全なアドレス。*（，）*
+
+* **番地**： 完全な住所。*（，）*
+
+* **局所性**: 都市または場所。*（，）*
+
+* **地域**: 状態または地域。*（，）*
+
+* **郵便番号**： 郵便番号または郵便番号。*（，）*
+
+* **国**: 国の名前。*（，）*
+
+### サポートされているプラットフォーム
+
+* アマゾン火 OS
+* アンドロイド
+* ブラックベリー 10
+* Firefox の OS
+* iOS
+* Windows Phone 7 と 8
+* Windows 8
+
+### 例
+
+ // display the address information for all contacts
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ for (var j = 0; j < contacts[i].addresses.length; j++) {
+ alert("Pref: " + contacts[i].addresses[j].pref + "\n" +
+ "Type: " + contacts[i].addresses[j].type + "\n" +
+ "Formatted: " + contacts[i].addresses[j].formatted + "\n" +
+ "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+ "Locality: " + contacts[i].addresses[j].locality + "\n" +
+ "Region: " + contacts[i].addresses[j].region + "\n" +
+ "Postal Code: " + contacts[i].addresses[j].postalCode + "\n" +
+ "Country: " + contacts[i].addresses[j].country);
+ }
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ // find all contacts
+ var options = new ContactFindOptions();
+ options.filter = "";
+ var filter = ["displayName", "addresses"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### アンドロイド 2.X 癖
+
+* **県**: サポートされていない返す `false` 2.X の Android デバイスで。
+
+### ブラックベリー 10 癖
+
+* **県**： 戻る、BlackBerry デバイスでサポートされていません`false`.
+
+* **種類**: 部分的にサポートされます。連絡先ごとの 1 つだけ各*仕事*と*家庭*の種類のアドレスを格納できます。
+
+* **フォーマット**： 部分的にサポートされます。すべての BlackBerry アドレス フィールドの連結を返します。
+
+* **番地**： サポートされています。ブラックベリーの**住所 1** **住所 2**の連結アドレス フィールドを返します。
+
+* **局所性**： サポートされています。ブラックベリー**市**アドレス フィールドに格納されます。
+
+* **地域**: サポートされています。ブラックベリー **stateProvince**アドレス フィールドに格納されます。
+
+* **郵便番号**： サポートされています。ブラックベリー **zipPostal**アドレス フィールドに格納されます。
+
+* **国**: サポートされています。
+
+### FirefoxOS の癖
+
+* **フォーマット**: 現在サポートされていません
+
+### iOS の癖
+
+* **県**: 戻る iOS デバイスでサポートされていません`false`.
+
+* **フォーマット**: 現在サポートされていません。
+
+### Windows 8 の癖
+
+* **県**: サポートされていません。
+
+## ContactError
+
+`ContactError`オブジェクトを介してユーザーに返されます、 `contactError` コールバック関数でエラーが発生したとき。
+
+### プロパティ
+
+* **コード**: 次のいずれかの定義済みのエラー コード。
+
+### 定数
+
+* `ContactError.UNKNOWN_ERROR` (code 0)
+* `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+* `ContactError.TIMEOUT_ERROR` (code 2)
+* `ContactError.PENDING_OPERATION_ERROR` (code 3)
+* `ContactError.IO_ERROR` (code 4)
+* `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+* `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+`ContactField`オブジェクトは連絡先フィールドを総称を表す再利用可能なコンポーネントです。 各 `ContactField` オブジェクトが含まれています、 `value` 、 `type` 、および `pref` プロパティ。 A `Contact` オブジェクトのいくつかのプロパティに格納されます `ContactField[]` 携帯電話番号、メール アドレスなどの配列。
+
+ほとんどの場合、事前に決められた値がない、 `ContactField` オブジェクトの**type**属性。 たとえば、電話番号が*ホーム*、*仕事*、*モバイル*、 *iPhone*、または特定のデバイス プラットフォームの連絡先データベースでサポートされている他の値の**型**の値を指定できます。 ただし、ため、 `Contact` **写真**] フィールドに、**種類**フィールド、返されるイメージの形式を示します: **url** **値**属性**値**を base64 でエンコードされたイメージの文字列が含まれる場合に写真イメージまたは*base64*に URL が含まれる場合。
+
+### プロパティ
+
+* **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。*（，）*
+
+* **値**: 電話番号や電子メール アドレスなど、フィールドの値。*（，）*
+
+* **県**: に設定されている `true` 場合は、この `ContactField` ユーザーの推奨値が含まれています。*(ブール値)*
+
+### サポートされているプラットフォーム
+
+* アマゾン火 OS
+* アンドロイド
+* ブラックベリー 10
+* Firefox の OS
+* iOS
+* Windows Phone 7 と 8
+* Windows 8
+
+### 例
+
+ // create a new contact
+ var contact = navigator.contacts.create();
+
+ // store contact phone numbers in ContactField[]
+ var phoneNumbers = [];
+ phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+ phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+ phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+ contact.phoneNumbers = phoneNumbers;
+
+ // save the contact
+ contact.save();
+
+
+### Android の癖
+
+* **県**: サポートされていないを返す`false`.
+
+### ブラックベリー 10 癖
+
+* **種類**: 部分的にサポートされます。電話番号を使用します。
+
+* **値**: サポートされています。
+
+* **県**: サポートされていないを返す`false`.
+
+### iOS の癖
+
+* **県**: サポートされていないを返す`false`.
+
+### Windows8 の癖
+
+* **県**: サポートされていないを返す`false`.
+
+## 得意先コード
+
+についての異なる種類情報にはが含まれています、 `Contact` オブジェクトの名前。
+
+### プロパティ
+
+* **フォーマット**: 連絡先の完全な名前。*（，）*
+
+* **familyName**: 連絡先の姓。*（，）*
+
+* **givenName**: 連絡先の名前。*（，）*
+
+* **ミドル ネーム**: 連絡先のミドル ネーム。*（，）*
+
+* **honorificPrefix**: 連絡先のプレフィックス (例*氏*または*博士*) *(，)*
+
+* **honorificSuffix**: 連絡先のサフィックス (*弁護士*の例)。*（，）*
+
+### サポートされているプラットフォーム
+
+* アマゾン火 OS
+* アンドロイド 2.X
+* ブラックベリー 10
+* Firefox の OS
+* iOS
+* Windows Phone 7 と 8
+* Windows 8
+
+### 例
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ alert("Formatted: " + contacts[i].name.formatted + "\n" +
+ "Family Name: " + contacts[i].name.familyName + "\n" +
+ "Given Name: " + contacts[i].name.givenName + "\n" +
+ "Middle Name: " + contacts[i].name.middleName + "\n" +
+ "Suffix: " + contacts[i].name.honorificSuffix + "\n" +
+ "Prefix: " + contacts[i].name.honorificSuffix);
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ var options = new ContactFindOptions();
+ options.filter = "";
+ filter = ["displayName", "name"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### Android の癖
+
+* **フォーマット**： 部分的にサポートされており、読み取り専用です。 連結を返します `honorificPrefix` 、 `givenName` 、 `middleName` 、 `familyName` と`honorificSuffix`.
+
+### ブラックベリー 10 癖
+
+* **フォーマット**： 部分的にサポートされます。ブラックベリー **firstName**と**lastName**フィールドの連結を返します。
+
+* **familyName**: サポートされています。ブラックベリー **[氏名]**フィールドに格納されます。
+
+* **givenName**: サポートされています。ブラックベリーの**firstName**フィールドに格納されます。
+
+* **ミドル ネーム**: サポートされていないを返す`null`.
+
+* **honorificPrefix**: サポートされていないを返す`null`.
+
+* **honorificSuffix**: サポートされていないを返す`null`.
+
+### FirefoxOS の癖
+
+* **フォーマット**： 部分的にサポートされており、読み取り専用です。 連結を返します `honorificPrefix` 、 `givenName` 、 `middleName` 、 `familyName` と`honorificSuffix`.
+
+### iOS の癖
+
+* **フォーマット**： 部分的にサポートされます。IOS 複合名を返しますが、読み取り専用です。
+
+### Windows 8 の癖
+
+* **フォーマット**： これは、プロパティの名前し、同じです `displayName` と`nickname`
+
+* **familyName**: サポートされていません。
+
+* **givenName**: サポートされていません。
+
+* **ミドル ネーム**: サポートされていません。
+
+* **honorificPrefix**: サポートされていません。
+
+* **honorificSuffix**: サポートされていません。
+
+## ContactOrganization
+
+`ContactOrganization`オブジェクトは、連絡先の組織のプロパティを格納します。A `Contact` 1 つまたは複数のオブジェクトに格納されます `ContactOrganization` 配列内のオブジェクト。
+
+### プロパティ
+
+* **県**: に設定されている `true` 場合は、この `ContactOrganization` ユーザーの推奨値が含まれています。*(ブール値)*
+
+* **タイプ**: たとえばフィールドこれは*ホーム*の種類を示す文字列。_(DOMString)
+
+* **名前**: 組織の名前。*（，）*
+
+* **部門**: 契約に勤めている部門。*（，）*
+
+* **タイトル**: 組織の連絡先のタイトル。*（，）*
+
+### サポートされているプラットフォーム
+
+* アンドロイド
+* ブラックベリー 10
+* Firefox の OS
+* iOS
+* Windows Phone 7 と 8
+
+### 例
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ for (var j = 0; j < contacts[i].organizations.length; j++) {
+ alert("Pref: " + contacts[i].organizations[j].pref + "\n" +
+ "Type: " + contacts[i].organizations[j].type + "\n" +
+ "Name: " + contacts[i].organizations[j].name + "\n" +
+ "Department: " + contacts[i].organizations[j].department + "\n" +
+ "Title: " + contacts[i].organizations[j].title);
+ }
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ var options = new ContactFindOptions();
+ options.filter = "";
+ filter = ["displayName", "organizations"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### アンドロイド 2.X 癖
+
+* **県**: 返す 2.X の Android デバイスでサポートされていません`false`.
+
+### ブラックベリー 10 癖
+
+* **県**： 戻る、BlackBerry デバイスでサポートされていません`false`.
+
+* **タイプ**： 戻る、BlackBerry デバイスでサポートされていません`null`.
+
+* **名前**： 部分的にサポートされます。最初の組織名は、**会社**のブラックベリーのフィールドに格納されます。
+
+* **部門**: サポートされていないを返す`null`.
+
+* **タイトル**: 部分的にサポートされます。組織の最初のタイトルはブラックベリー**氏名**フィールドに格納されます。
+
+### Firefox OS 癖
+
+* **県**: サポートされていません。
+
+* **タイプ**: サポートされていません。
+
+* **部門**: サポートされていません。
+
+* フィールドの**名前**と**組織**、**氏名**に格納された**タイトル**.
+
+### iOS の癖
+
+* **県**: 戻る iOS デバイスでサポートされていません`false`.
+
+* **タイプ**： 戻る iOS デバイスでサポートされていません`null`.
+
+* **名前**： 部分的にサポートされます。最初の組織名は、iOS **kABPersonOrganizationProperty**フィールドに格納されます。
+
+* **部門**: 部分的にサポートされます。最初の部署名は iOS **kABPersonDepartmentProperty**フィールドに格納されます。
+
+* **タイトル**: 部分的にサポートされます。最初のタイトルは、iOS **kABPersonJobTitleProperty**フィールドに格納されます。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/c23af568/doc/ko/index.md
----------------------------------------------------------------------
diff --git a/doc/ko/index.md b/doc/ko/index.md
new file mode 100644
index 0000000..f2f410e
--- /dev/null
+++ b/doc/ko/index.md
@@ -0,0 +1,668 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# org.apache.cordova.contacts
+
+장치 연락처 데이터베이스에 대 한 액세스를 제공합니다.
+
+**경고**: 중요 한 개인 정보 보호 문제를 제기 하는 연락처 데이터의 수집 및 사용 합니다. 응용 프로그램의 개인 정보 보호 정책 응용 프로그램 연락처 데이터를 사용 하는 방법 및 다른 당사자와 함께 공유 하는 여부를 토론 해야 한다. 연락처 정보 누구와 통신 하는 사람이 사람들 보여 때문에 민감한으로 간주 됩니다. 따라서 애플 리 케이 션의 개인 정보 보호 정책 뿐만 아니라 강하게 해야 장치 운영 체제는 이렇게 이미 하지 않는 경우 응용 프로그램 액세스 또는 연락처 데이터를 사용 하기 전에 그냥--시간 통지를 제공 합니다. 그 통지는 (예를 들어, **확인** 및 **아니오**선택 제시) 하 여 사용자의 허가 취득 뿐만 아니라, 위에서 언급 된 동일한 정보를 제공 해야 합니다. Note 일부 애플 리 케이 션 장 터 그냥--시간 공지 및 연락처 데이터에 액세�
�� 하기 전에 사용자의 허가 받아야 응용 프로그램에 필요할 수 있습니다. 연락처 데이터는 사용자의 혼동을 방지할 수의 사용 및 연락처 데이터의 인식된 오용 명확 하 고 이해 하기 쉬운 사용자 경험. 자세한 내용은 개인 정보 보호 가이드를 참조 하십시오.
+
+## 설치
+
+ cordova plugin add org.apache.cordova.contacts
+
+
+### 파이어 폭스 OS 단점
+
+[참고 문서][1]에 설명 된 대로 **www/manifest.webapp** 를 만듭니다. 관련 부여할 추가 합니다. [참고 문서][2]에 "권한"-webapp 유형을 변경 하려면 필요가 하다. **경고**: 모든 훌륭한 애플 리 케이 션 인라인 스크립트를 금지 하는 [콘텐츠 보안 정책][3] 을 적용 합니다. 다른 방법으로 응용 프로그램을 초기화 합니다.
+
+ [1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
+ [2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
+ [3]: https://developer.mozilla.org/en-US/Apps/CSP
+
+ "type": "privileged",
+ "permissions": {
+ "contacts": {
+ "access": "readwrite",
+ "description": "Describe why there is a need for such permission"
+ }
+ }
+
+
+### 윈도우 8 단점
+
+윈도우 8 연락처는 읽기 전용입니다. 코르 도우 바 API 연락처를 통해 하지 쿼리/검색할 수 있습니다, 사용자 알려 '사람' 애플 리 케이 션을 열 것 이다 contacts.pickContact에 대 한 호출으로 연락처를 선택 하 여 사용자 연락처를 선택 해야 합니다. 반환 된 연락처는 읽기 전용 응용 프로그램을 수정할 수 없습니다.
+
+## navigator.contacts
+
+### 메서드
+
+* navigator.contacts.create
+* navigator.contacts.find
+* navigator.contacts.pickContact
+
+### 개체
+
+* 연락처
+* 담당자 이름
+* ContactField
+* ContactAddress
+* ContactOrganization
+* ContactFindOptions
+* ContactError
+* ContactFieldType
+
+## navigator.contacts.create
+
+`navigator.contacts.create`메서드는 동기적, 및 새로운 반환 합니다 `Contact` 개체.
+
+이 메서드를 호출 해야 장치 연락처 데이터베이스에 연락처 개체를 유지 하지 않습니다는 `Contact.save` 방법.
+
+### 지원 되는 플랫폼
+
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+
+### 예를 들어
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+
+## navigator.contacts.find
+
+`navigator.contacts.find`장치 연락처 데이터베이스 쿼리 및의 배열을 반환 메서드가 비동기적으로 실행 될 `Contact` 개체. 결과 객체에 전달 되는 `contactSuccess` **contactSuccess** 매개 변수로 지정 된 콜백 함수.
+
+**ContactFields** 매개 변수는 검색 한정자로 사용할 필드를 지정 합니다. 길이가 0 인 **contactFields** 매개 변수 유효 하지 않습니다 및 결과 `ContactError.INVALID_ARGUMENT_ERROR` . **ContactFields** 값이 `"*"` 모든 연락처 필드를 반환 합니다.
+
+**ContactFindOptions.filter** 문자열 연락처 데이터베이스를 쿼리할 때 검색 필터로 사용할 수 있습니다. 제공 된, 대/소문자, 부분 값 일치 **contactFields** 매개 변수에 지정 된 각 필드에 적용 됩니다. *모든* 지정 된 필드의 일치 하는 경우 연락처 반환 됩니다. 사용 하 여 **contactFindOptions.desiredFields** 매개 변수 속성 문의 제어를 다시 반환 해야 합니다.
+
+### 매개 변수
+
+* **contactSuccess**: 연락처 개체의 배열에 표시 되는 성공 콜백 함수는 데이터베이스에서 반환 된. [필수]
+
+* **contactError**: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]
+
+* **contactFields**: 검색 한정자로 사용 하는 필드에 문의. *(DOMString[])* [필수]
+
+* **contactFindOptions**: navigator.contacts 필터링 옵션을 검색 합니다. [선택 사항] 키 다음과 같습니다.
+
+* **필터**: 검색 문자열 navigator.contacts를 찾는 데 사용 합니다. *(DOMString)* (기본:`""`)
+
+* **여러**: 여러 navigator.contacts 찾기 작업을 반환 합니다 경우 결정 합니다. *(부울)* (기본:`false`)
+
+ * **desiredFields**: 연락처 필드를 다시 반환 합니다. 그 결과 지정 된 경우 `Contact` 만이 필드의 값을 보유 하는 개체. *(DOMString[])* [선택 사항]
+
+### 지원 되는 플랫폼
+
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+
+### 예를 들어
+
+ function onSuccess(contacts) {
+ alert('Found ' + contacts.length + ' contacts.');
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ // find all contacts with 'Bob' in any name field
+ var options = new ContactFindOptions();
+ options.filter = "Bob";
+ options.multiple = true;
+ options.desiredFields = [navigator.contacts.fieldType.id];
+ var fields = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+ navigator.contacts.find(onSuccess, onError, fields, options);
+
+
+## navigator.contacts.pickContact
+
+`navigator.contacts.pickContact`메서드가 단일 연락처 선택 문의 선택 시작. 결과 개체에 전달 되는 `contactSuccess` **contactSuccess** 매개 변수로 지정 된 콜백 함수.
+
+### 매개 변수
+
+* **contactSuccess**: 단일 연락처 개체와 호출 되는 성공 콜백 함수. [필수]
+
+* **contactError**: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]
+
+### 지원 되는 플랫폼
+
+* 안 드 로이드
+* iOS
+* Windows Phone 8
+* 윈도우 8
+
+### 예를 들어
+
+ navigator.contacts.pickContact(function(contact){
+ console.log('The following contact has been selected:' + JSON.stringify(contact));
+ },function(err){
+ console.log('Error: ' + err);
+ });
+
+
+## 연락처
+
+`Contact`개체는 사용자의 연락처를 나타냅니다. 연락처 생성 수, 저장 또는 장치 연락처 데이터베이스에서 제거 합니다. 연락처도 검색할 수 있습니다 (개별적으로 또는 일괄적으로) 데이터베이스에서 호출 하 여는 `navigator.contacts.find` 방법.
+
+**참고**: 모든 연락처 필드 위에 나열 된 모든 장치 플랫폼에서 지원 됩니다. 자세한 내용은 각 플랫폼의 *단점이* 섹션을 확인 하시기 바랍니다.
+
+### 속성
+
+* **id**: 글로벌 고유 식별자. *(DOMString)*
+
+* **displayName**: 최종 사용자에 게 표시에 적합이 연락처의 이름. *(DOMString)*
+
+* **이름**: 사람 이름의 모든 구성 요소를 포함 하는 개체. *(담당자 이름)*
+
+* **별명**: 캐주얼 이름 연락처 주소입니다. *(DOMString)*
+
+* **phoneNumbers**: 모든 연락처의 전화 번호의 배열. *(ContactField[])*
+
+* **이메일**: 모든 연락처의 전자 메일 주소의 배열. *(ContactField[])*
+
+* **주소**: 모든 연락처의 주소 배열. *(ContactAddress[])*
+
+* **ims**: 모든 연락처의 IM 주소 배열. *(ContactField[])*
+
+* **조직**: 다양 한 모든 연락처의 조직. *(ContactOrganization[])*
+
+* **생일**: 연락처의 생일. *(날짜)*
+
+* **참고**: 연락처에 대 한 참고. *(DOMString)*
+
+* **사진**: 연락처의 사진을 배열. *(ContactField[])*
+
+* **카테고리**: 모든 사용자 정의 범주 연락처에 연결 된 배열. *(ContactField[])*
+
+* **url**: 연락처에 연결 된 웹 페이지의 배열. *(ContactField[])*
+
+### 메서드
+
+* **복제**: 새로운 반환 합니다 `Contact` 으로 호출 하는 개체의 전체 복사본은 개체는 `id` 속성으로 설정`null`.
+
+* **제거**: 장치 연락처 데이터베이스에서 연락처를 제거 합니다, 그렇지 않으면와 오류 콜백을 실행 한 `ContactError` 개체.
+
+* **저장**: 장치 연락처 데이터베이스를 새 연락처를 저장 또는 동일한 **id** 를 가진 연락처가 이미 있는 경우 기존 연락처를 업데이트 합니다.
+
+### 지원 되는 플랫폼
+
+* 아마존 화재 운영 체제
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+* 윈도우 8
+
+### 예를 들어 저장
+
+ function onSuccess(contact) {
+ alert("Save Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // create a new contact object
+ var contact = navigator.contacts.create();
+ contact.displayName = "Plumber";
+ contact.nickname = "Plumber"; // specify both to support all devices
+
+ // populate some fields
+ var name = new ContactName();
+ name.givenName = "Jane";
+ name.familyName = "Doe";
+ contact.name = name;
+
+ // save to device
+ contact.save(onSuccess,onError);
+
+
+### 복제 예제
+
+ // clone the contact object
+ var clone = contact.clone();
+ clone.name.givenName = "John";
+ console.log("Original contact name = " + contact.name.givenName);
+ console.log("Cloned contact name = " + clone.name.givenName);
+
+
+### 예제 제거
+
+ function onSuccess() {
+ alert("Removal Success");
+ };
+
+ function onError(contactError) {
+ alert("Error = " + contactError.code);
+ };
+
+ // remove the contact from the device
+ contact.remove(onSuccess,onError);
+
+
+### 안 드 로이드 2.X 단점
+
+* **카테고리**: 안 드 로이드 2.X 장치, 반환에서 지원 되지 않습니다`null`.
+
+### 블랙베리 10 단점
+
+* **id**: 연락처를 저장 하면 장치에 할당 합니다.
+
+### FirefoxOS 특수
+
+* **카테고리**: 부분적으로 지원 합니다. 필드 **pref** 및 **형식** 반환`null`
+
+* **ims**: 지원 되지 않음
+
+* **사진**: 지원 되지 않음
+
+### iOS 단점
+
+* **displayName**: 반환 iOS에서 지원 되지 않는 `null` 가 아무 `ContactName` 지정 된,이 경우 복합 이름, **닉네임** 을 반환 합니다 또는 `""` , 각각.
+
+* **생일**: 자바 스크립트로 입력 해야 합니다 `Date` 개체를 같은 방식으로 반환 됩니다.
+
+* **사진**: 응용 프로그램의 임시 디렉터리에 저장 된 이미지 파일 URL을 반환 합니다. 응용 프로그램이 종료 될 때 임시 디렉터리의 내용은 제거 됩니다.
+
+* **카테고리**:이 속성은 현재 지원 되지 않습니다, 반환`null`.
+
+### Windows Phone 7, 8 특수
+
+* **displayName**: 연락처를 만들 때 표시 이름에서 표시 이름 매개 변수 다릅니다 제공 값 검색 연락처를 찾을 때.
+
+* **url**: 연락처를 만들 때 사용자가 입력을 하나 이상의 웹 주소를 저장 하지만 하나만 사용할 수 있는 연락처를 검색할 때.
+
+* **phoneNumbers**: *pref* 옵션이 지원 되지 않습니다. *형식* *찾기* 작업에서 지원 되지 않습니다. 단 하나 `phoneNumber` 각 *형식* 에 대 한 허용.
+
+* **이메일**: *pref* 옵션이 지원 되지 않습니다. 가정 및 개인 동일한 이메일 항목 참조. 각 *형식* 에 대 한 항목이 하나만 허용.
+
+* **주소**: 직장, 및 가정/개인 *유형*을 지원 합니다. 가정 및 개인 *유형* 동일한 주소 항목 참조. 각 *형식* 에 대 한 항목이 하나만 허용.
+
+* **조직**: 하나만 허용 되 고 *pref*, *유형*및 *부서* 특성을 지원 하지 않습니다.
+
+* **참고**: 지원 되지 않는 반환`null`.
+
+* **ims**: 지원 되지 않는 반환`null`.
+
+* **생일**: 지원 되지 않는 반환`null`.
+
+* **카테고리**: 지원 되지 않는 반환`null`.
+
+## ContactAddress
+
+`ContactAddress`개체는 연락처의 단일 주소 속성을 저장 합니다. A `Contact` 개체에 하나 이상의 주소가 포함 될 수 있습니다는 `ContactAddress[]` 배열.
+
+### 속성
+
+* **pref**: 설정 `true` 이 경우 `ContactAddress` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+* **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열. *(DOMString)*
+
+* **포맷**: 전체 주소 표시를 위해 서식이 지정 된. *(DOMString)*
+
+* **streetAddress**: 전체 주소. *(DOMString)*
+
+* **지역**: 구, 군 또는 도시. *(DOMString)*
+
+* **지역**: 상태 또는 지역. *(DOMString)*
+
+* **postalCode**: 우편 번호 또는 우편 번호. *(DOMString)*
+
+* **국가**: 국가 이름. *(DOMString)*
+
+### 지원 되는 플랫폼
+
+* 아마존 화재 운영 체제
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+* 윈도우 8
+
+### 예를 들어
+
+ // display the address information for all contacts
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ for (var j = 0; j < contacts[i].addresses.length; j++) {
+ alert("Pref: " + contacts[i].addresses[j].pref + "\n" +
+ "Type: " + contacts[i].addresses[j].type + "\n" +
+ "Formatted: " + contacts[i].addresses[j].formatted + "\n" +
+ "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
+ "Locality: " + contacts[i].addresses[j].locality + "\n" +
+ "Region: " + contacts[i].addresses[j].region + "\n" +
+ "Postal Code: " + contacts[i].addresses[j].postalCode + "\n" +
+ "Country: " + contacts[i].addresses[j].country);
+ }
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ // find all contacts
+ var options = new ContactFindOptions();
+ options.filter = "";
+ var filter = ["displayName", "addresses"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### 안 드 로이드 2.X 단점
+
+* **pref**: 지원 되지 않는 반환 `false` 안 드 로이드 2.X 장치에.
+
+### 블랙베리 10 단점
+
+* **pref**: 반환 BlackBerry 장치에서 지원 되지 않습니다`false`.
+
+* **유형**: 부분적으로 지원 합니다. *작업* 및 *홈* 형식 주소 각 단 하나 접촉 당 저장할 수 있습니다.
+
+* **포맷**: 부분적으로 지원 합니다. 모든 검은 딸기 주소 필드의 연결을 반환합니다.
+
+* **streetAddress**: 지원. 블랙베리 **address1** **주소 2** 의 연결 주소 필드를 반환합니다.
+
+* **지역**: 지원. 블랙베리 **시** 주소 필드에 저장 합니다.
+
+* **지역**: 지원. 블랙베리 **stateProvince** 주소 필드에 저장 합니다.
+
+* **postalCode**: 지원. 블랙베리 **zipPostal** 주소 필드에 저장 합니다.
+
+* **국가**: 지원.
+
+### FirefoxOS 특수
+
+* **포맷**: 현재 지원 되지 않습니다
+
+### iOS 단점
+
+* **pref**: 반환 하는 iOS 장치에서 지원 되지 않습니다`false`.
+
+* **포맷**: 현재 지원 되지 않습니다.
+
+### 윈도우 8 단점
+
+* **pref**: 지원 되지 않음
+
+## ContactError
+
+`ContactError`개체를 통해 사용자에 게 반환 되는 `contactError` 콜백 함수는 오류가 발생 한 경우.
+
+### 속성
+
+* **코드**: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된.
+
+### 상수
+
+* `ContactError.UNKNOWN_ERROR` (code 0)
+* `ContactError.INVALID_ARGUMENT_ERROR` (code 1)
+* `ContactError.TIMEOUT_ERROR` (code 2)
+* `ContactError.PENDING_OPERATION_ERROR` (code 3)
+* `ContactError.IO_ERROR` (code 4)
+* `ContactError.NOT_SUPPORTED_ERROR` (code 5)
+* `ContactError.PERMISSION_DENIED_ERROR` (code 20)
+
+## ContactField
+
+`ContactField`개체는 재사용 가능한 구성 요소를 나타내는 필드를 일반적으로 문의. 각 `ContactField` 개체에 포함 되어 있는 `value` , `type` , 및 `pref` 속성. A `Contact` 개체에 여러 속성이 저장 `ContactField[]` 배열, 전화 번호 및 이메일 주소.
+
+대부분의 경우에는 미리 결정 된 값에 대 한는 `ContactField` 개체의 **type** 속성. 예를 들어 전화 번호 *홈*, *작품*, *모바일*, *아이폰*또는 특정 장치 플랫폼의 연락처 데이터베이스에서 지원 되는 다른 값의 **유형** 값을 지정할 수 있습니다. 그러나는 `Contact` **사진** 필드 **유형** 필드 나타냅니다 반환 된 이미지 형식: **url** **값** 특성 **값** 이미지 base64 인코딩된 문자열을 포함 하는 경우 사진 이미지 또는 *base64* URL이 포함 된 경우.
+
+### 속성
+
+* **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열입니다. *(DOMString)*
+
+* **값**: 전화 번호 또는 이메일 주소와 같은 필드 값. *(DOMString)*
+
+* **pref**: 설정 `true` 이 경우 `ContactField` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+### 지원 되는 플랫폼
+
+* 아마존 화재 운영 체제
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+* 윈도우 8
+
+### 예를 들어
+
+ // create a new contact
+ var contact = navigator.contacts.create();
+
+ // store contact phone numbers in ContactField[]
+ var phoneNumbers = [];
+ phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+ phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
+ phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+ contact.phoneNumbers = phoneNumbers;
+
+ // save the contact
+ contact.save();
+
+
+### 안 드 로이드 단점
+
+* **pref**: 지원 되지 않는 반환`false`.
+
+### 블랙베리 10 단점
+
+* **유형**: 부분적으로 지원 합니다. 전화 번호에 대 한 사용.
+
+* **값**: 지원.
+
+* **pref**: 지원 되지 않는 반환`false`.
+
+### iOS 단점
+
+* **pref**: 지원 되지 않는 반환`false`.
+
+### Windows8 단점
+
+* **pref**: 지원 되지 않는 반환`false`.
+
+## 담당자 이름
+
+에 대 한 다양 한 정보를 포함 한 `Contact` 개체의 이름.
+
+### 속성
+
+* **포맷**: 연락처의 전체 이름. *(DOMString)*
+
+* **familyName**: 연락처의 성. *(DOMString)*
+
+* **givenName**: 연락처의 이름. *(DOMString)*
+
+* **middleName**: 연락처의 중간 이름을. *(DOMString)*
+
+* **honorificPrefix**: 연락처의 접두사 (예: *미스터* 또는 *닥터*) *(DOMString)*
+
+* **honorificSuffix**: 연락처의 접미사 ( *esq.*예). *(DOMString)*
+
+### 지원 되는 플랫폼
+
+* 아마존 화재 운영 체제
+* 안 드 로이드 2.X
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+* 윈도우 8
+
+### 예를 들어
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ alert("Formatted: " + contacts[i].name.formatted + "\n" +
+ "Family Name: " + contacts[i].name.familyName + "\n" +
+ "Given Name: " + contacts[i].name.givenName + "\n" +
+ "Middle Name: " + contacts[i].name.middleName + "\n" +
+ "Suffix: " + contacts[i].name.honorificSuffix + "\n" +
+ "Prefix: " + contacts[i].name.honorificSuffix);
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ var options = new ContactFindOptions();
+ options.filter = "";
+ filter = ["displayName", "name"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### 안 드 로이드 단점
+
+* **포맷**: 부분적으로 지원 되 고 읽기 전용. 연결을 반환 합니다 `honorificPrefix` , `givenName` , `middleName` , `familyName` , 그리고`honorificSuffix`.
+
+### 블랙베리 10 단점
+
+* **포맷**: 부분적으로 지원 합니다. 블랙베리 **firstName** 및 **lastName** 필드의 연결을 반환합니다.
+
+* **familyName**: 지원. 블랙베리 **lastName** 필드에 저장 합니다.
+
+* **givenName**: 지원. 블랙베리 **firstName** 필드에 저장 합니다.
+
+* **middleName**: 지원 되지 않는 반환`null`.
+
+* **honorificPrefix**: 지원 되지 않는 반환`null`.
+
+* **honorificSuffix**: 지원 되지 않는 반환`null`.
+
+### FirefoxOS 특수
+
+* **포맷**: 부분적으로 지원 되 고 읽기 전용. 연결을 반환 합니다 `honorificPrefix` , `givenName` , `middleName` , `familyName` , 그리고`honorificSuffix`.
+
+### iOS 단점
+
+* **포맷**: 부분적으로 지원 합니다. IOS 복합 이름 반환 하지만 읽기 전용입니다.
+
+### 윈도우 8 단점
+
+* **형식**: 이것은 유일한 속성 이름과 동일 하다 `displayName` , 및`nickname`
+
+* **familyName**: 지원 되지 않음
+
+* **givenName**: 지원 되지 않음
+
+* **middleName**: 지원 되지 않음
+
+* **honorificPrefix**: 지원 되지 않음
+
+* **honorificSuffix**: 지원 되지 않음
+
+## ContactOrganization
+
+`ContactOrganization`개체를 연락처의 조직 속성을 저장 합니다. A `Contact` 개체 저장 하나 이상의 `ContactOrganization` 개체 배열에.
+
+### 속성
+
+* **pref**: 설정 `true` 이 경우 `ContactOrganization` 사용자의 기본 설정된 값이 포함 됩니다. *(부울)*
+
+* **유형**: 예를 들어 필드, *홈* 의 어떤 종류를 나타내는 문자열입니다. _(DOMString)
+
+* **이름**: 조직 이름. *(DOMString)*
+
+* **부서**: 계약을 위해 일 하는 부서. *(DOMString)*
+
+* **제목**: 조직에서 연락처의 제목. *(DOMString)*
+
+### 지원 되는 플랫폼
+
+* 안 드 로이드
+* 블랙베리 10
+* Firefox 운영 체제
+* iOS
+* Windows Phone 7과 8
+
+### 예를 들어
+
+ function onSuccess(contacts) {
+ for (var i = 0; i < contacts.length; i++) {
+ for (var j = 0; j < contacts[i].organizations.length; j++) {
+ alert("Pref: " + contacts[i].organizations[j].pref + "\n" +
+ "Type: " + contacts[i].organizations[j].type + "\n" +
+ "Name: " + contacts[i].organizations[j].name + "\n" +
+ "Department: " + contacts[i].organizations[j].department + "\n" +
+ "Title: " + contacts[i].organizations[j].title);
+ }
+ }
+ };
+
+ function onError(contactError) {
+ alert('onError!');
+ };
+
+ var options = new ContactFindOptions();
+ options.filter = "";
+ filter = ["displayName", "organizations"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+
+### 안 드 로이드 2.X 단점
+
+* **pref**: 반환 안 드 로이드 2.X 장치에 의해 지원 되지 않습니다`false`.
+
+### 블랙베리 10 단점
+
+* **pref**: 반환 블랙베리 장치에 의해 지원 되지 않습니다`false`.
+
+* **유형**: 반환 블랙베리 장치에 의해 지원 되지 않습니다`null`.
+
+* **이름**: 부분적으로 지원 합니다. 첫 번째 조직 이름 블랙베리 **회사** 필드에 저장 됩니다.
+
+* **부서**: 지원 되지 않는 반환`null`.
+
+* **제목**: 부분적으로 지원 합니다. 첫 번째 조직 제목 블랙베리 **jobTitle** 필드에 저장 됩니다.
+
+### 파이어 폭스 OS 단점
+
+* **pref**: 지원 되지 않음
+
+* **형식**: 지원 되지 않음
+
+* **부서**: 지원 되지 않음
+
+* 필드 **이름** 및 **제목** **org** 및 **jobTitle** 에 저장.
+
+### iOS 단점
+
+* **pref**: 반환 하는 iOS 장치에서 지원 되지 않습니다`false`.
+
+* **유형**: 반환 하는 iOS 장치에서 지원 되지 않습니다`null`.
+
+* **이름**: 부분적으로 지원 합니다. 첫 번째 조직 이름은 iOS **kABPersonOrganizationProperty** 필드에 저장 됩니다.
+
+* **부서**: 부분적으로 지원 합니다. 첫 번째 부서 이름은 iOS **kABPersonDepartmentProperty** 필드에 저장 됩니다.
+
+* **제목**: 부분적으로 지원 합니다. 첫 번째 타이틀 iOS **kABPersonJobTitleProperty** 필드에 저장 됩니다.
\ No newline at end of file