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/02/27 19:48:13 UTC
[1/2] cordova-plugin-contacts git commit: CB-8438
cordova-plugin-contacts documentation translation: cordova-plugin-contacts
Repository: cordova-plugin-contacts
Updated Branches:
refs/heads/master c40de8aa2 -> 293c8b3f8
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/293c8b3f/doc/ja/index.md
----------------------------------------------------------------------
diff --git a/doc/ja/index.md b/doc/ja/index.md
index 419788b..c46c656 100644
--- a/doc/ja/index.md
+++ b/doc/ja/index.md
@@ -19,9 +19,17 @@
# org.apache.cordova.contacts
-デバイスの連絡先データベースへのアクセスを提供します。
+このプラグインは、デバイスの連絡先データベースへのアクセスを提供するグローバル `navigator.contacts` オブジェクトを定義します。
-**警告**: 連絡先データの収集と利用を重要なプライバシーの問題を発生させます。 アプリのプライバシー ポリシー アプリが連絡先データを使用する方法と、他の当事者では共有されているかどうかを話し合う必要があります。 人誰と通信する人々 を明らかにするために、連絡先情報が機密と見なされます。 したがって、アプリのプライバシー ポリシーに加えて、強くする必要がありますデバイスのオペレーティング システムが既にしない場合アプリにアクセスまたは連絡先のデータを使用する前に - 時間のお知らせを提供します。 その通知は、上記の (例えば、 **[ok]**を**おかげで**選択肢を提示する) によってユーザーのアクセス許可を取得するだけでなく、同じ情報を提供する必要があります。 いくつかのアプリのマーケットプ レ
ース - 時間の通知を提供して、連絡先データにアクセスする前にユーザーの許可を取得するアプリをする必要がありますに注意してください。 連絡先データは、ユーザーの混乱を避けるのに役立ちますの使用および連絡先データの知覚の誤用を囲む明確でわかりやすいユーザー エクスペリエンス。 詳細については、プライバシーに関するガイドを参照してください。
+オブジェクトは、グローバル スコープの `ナビゲーター` に添付、それがないまで `deviceready` イベントの後。
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+ function onDeviceReady() {
+ console.log(navigator.contacts);
+ }
+
+
+**警告**: 連絡先データの収集と利用を重要なプライバシーの問題を発生させます。 アプリのプライバシー ポリシー アプリが連絡先データを使用する方法と、他の当事者では共有されているかどうかを話し合う必要があります。 人誰と通信する人々 を明らかにするために、連絡先情報が機密と見なされます。 したがって、アプリのプライバシー ポリシーに加えて、強くお勧めデバイスのオペレーティング システムが既にしない場合アプリにアクセスまたは連絡先のデータを使用する前に - 時間のお知らせを提供します。 その通知は、上記の (例えば、**[ok]** を **おかげで** 選択肢を提示する) によってユーザーのアクセス許可を取得するだけでなく、同じ情報を提供する必要があります。 いくつかのアプリのマーケットプ レース - 時間�
��通知を提供して、連絡先データにアクセスする前にユーザーの許可を取得するアプリをする必要がありますに注意してください。 連絡先データは、ユーザーの混乱を避けるのに役立ちますの使用および連絡先データの知覚の誤用を囲む明確でわかりやすいユーザー エクスペリエンス。 詳細については、プライバシーに関するガイドを参照してください。
## インストール
@@ -30,7 +38,7 @@
### Firefox OS 癖
-[マニフェストのドキュメント][1]で説明されているように、 **www/manifest.webapp**を作成します。 関連する権限を追加します。 [マニフェストのドキュメント][2]「特権」- に web アプリケーションの種類を変更する必要も。 **警告**: すべての特権を持つアプリケーション インライン スクリプトを禁止している[コンテンツのセキュリティ ポリシー][3]を適用します。 別の方法で、アプリケーションを初期化します。
+[マニフェストのドキュメント][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
@@ -47,7 +55,7 @@
### Windows の癖
-返されるすべての連絡先 `find` および `pickContact` メソッドは、読み取り専用アプリケーションを変更することはできませんので。 `find`8.1 の Windows Phone デバイス上でのみ利用可能な方法。
+`find` し、`pickContact` メソッドから返されるすべての連絡先は readonly、アプリケーションを変更することはできません。 `find` メソッド 8.1 の Windows Phone デバイスでのみ使用できます。
### Windows 8 の癖
@@ -74,9 +82,9 @@ Windows 8 の連絡先は、読み取り専用です。 コルドバ API コン
## navigator.contacts.create
-`navigator.contacts.create`メソッドは同期的にし、新しいを返します `Contact` オブジェクト。
+`navigator.contacts.create` メソッドは同期的に、新しい `連絡先` オブジェクトを返します。
-このメソッドを呼び出す必要があるデバイスの連絡先データベースに連絡先オブジェクトを保持しない、 `Contact.save` メソッド。
+このメソッドは、`Contact.save` メソッドを呼び出す必要があるデバイスの連絡先データベースに連絡先オブジェクトを保持しません。
### サポートされているプラットフォーム
@@ -93,27 +101,29 @@ Windows 8 の連絡先は、読み取り専用です。 コルドバ API コン
## navigator.contacts.find
-`navigator.contacts.find`デバイスの連絡先データベースをクエリの配列を返すメソッドは、非同期的に実行されます `Contact` オブジェクト。 結果として得られるオブジェクトに渡される、 `contactSuccess` 、 **contactSuccess**パラメーターで指定されたコールバック関数。
+デバイスの連絡先データベースを照会して、`Contact` オブジェクトの配列を返す `navigator.contacts.find` メソッドを非同期的に実行します。 結果として得られるオブジェクトは、**contactSuccess** パラメーターで指定された `contactSuccess` コールバック関数に渡されます。
-**連絡先**パラメーター検索の修飾子として使用するフィールドを指定します。 ゼロ長さ**連絡先**パラメーターが有効になり `ContactError.INVALID_ARGUMENT_ERROR` 。 **連絡先**値 `"*"` すべての連絡先フィールドを返します。
+**contactFields** パラメーター検索の修飾子として使用するフィールドを指定します。 ゼロ長さ **contactFields** パラメーターは有効で、`ContactError.INVALID_ARGUMENT_ERROR` の結果します。 **contactFields** 値 `"*"` すべての連絡先フィールドが検索されます。
-**ContactFindOptions.filter**文字列の連絡先データベースを照会するときに検索フィルターとして使用できます。 指定した場合、大文字と小文字、部分的な値の一致する**連絡先**パラメーターで指定されたフィールドごとに適用されます。 一致する*任意*指定のフィールドがある場合は、連絡先が返されます。 バック連絡先プロパティを制御する**contactFindOptions.desiredFields**パラメーターを使用しますが返される必要があります。
+**contactFindOptions.filter** 文字列の連絡先データベースを照会するときに検索フィルターとして使用できます。 指定した場合、大文字と小文字、部分的な値の一致する **contactFields** パラメーターで指定されたフィールドごとに適用されます。 一致する *任意* 指定のフィールドがある場合は、連絡先が返されます。 バック連絡先プロパティを制御する **contactFindOptions.desiredFields** パラメーターを使用しますが返される必要があります。
### パラメーター
-* **contactSuccess**: Contact オブジェクトの配列に呼び出される成功コールバック関数は、データベースから返されます。[必須]
-
-* **contactError**: エラー コールバック関数は、エラーが発生したときに呼び出されます。[オプション]
+* **contactFields**: 連絡先検索修飾子として使用するフィールド。*(DOMString[])* [Required]
-* **連絡先**: 連絡先検索修飾子として使用するフィールド。*(DOMString[])*[必須]
+* **contactSuccess**: Contact オブジェクトの配列に呼び出される成功コールバック関数は、データベースから返されます。[Required]
-* **contactFindOptions**: navigator.contacts をフィルターするオプションを検索します。[オプション]キーは次のとおりです。
-
-* **フィルター**: navigator.contacts の検索に使用する検索文字列。*（，）*(既定値します。`""`)
+* **contactError**: エラー コールバック関数は、エラーが発生したときに呼び出されます。[オプション]
-* **複数**: 複数 navigator.contacts かどうかは、検索操作に返すを決定します。*(ブール値)*(既定値します。`false`)
+* **contactFindOptions**: navigator.contacts をフィルターするオプションを検索します。[Optional]
+
+ キーは次のとおりです。
- * **desiredFields**： 戻って返されるフィールドに問い合わせてください。指定した場合、結果として `Contact` オブジェクトのみ機能のこれらのフィールドの値。*(DOMString[])*[オプション]
+ * **filter**: navigator.contacts の検索に使用する検索文字列。*（，）*(デフォルト: `""`)
+
+ * **multiple**: 複数 navigator.contacts かどうかは、検索操作に返すを決定します。*(ブール値)*(デフォルト: `false`)
+
+ * **desiredFields**： 戻って返されるフィールドに問い合わせてください。指定した場合、結果 `Contact` オブジェクトこれらのフィールドの値でのみ機能します。*(DOMString[])* [Optional]
### サポートされているプラットフォーム
@@ -149,7 +159,7 @@ Windows 8 の連絡先は、読み取り専用です。 コルドバ API コン
## navigator.contacts.pickContact
-`navigator.contacts.pickContact`メソッド連絡先ピッカーを起動します 1 つの連絡先を選択します。 結果として得られるオブジェクトに渡される、 `contactSuccess` 、 **contactSuccess**パラメーターで指定されたコールバック関数。
+`navigator.contacts.pickContact` メソッドは単一の連絡先を選択する連絡先ピッカーを起動します。 結果として得られるオブジェクトは、**contactSuccess** パラメーターで指定された `contactSuccess` コールバック関数に渡されます。
### パラメーター
@@ -176,9 +186,9 @@ Windows 8 の連絡先は、読み取り専用です。 コルドバ API コン
## お問い合わせ
-`Contact`オブジェクトは、ユーザーの連絡先を表します。 連絡先の作成、格納、またはデバイスの連絡先データベースから削除することができます。 連絡先も取得できます (個別にまたは一括） をデータベースから呼び出すことによって、 `navigator.contacts.find` メソッド。
+`Contact` オブジェクトは、ユーザーの連絡先を表します。 連絡先の作成、格納、またはデバイスの連絡先データベースから削除することができます。 連絡先も取得できます (個別にまたは一括で) データベースから `navigator.contacts.find` メソッドを呼び出すことによって。
-**注**: すべて上記の連絡先フィールドのすべてのデバイス プラットフォームでサポートされます。詳細については各プラットフォームの*互換*セクションを確認してください。
+**注**: すべて上記の連絡先フィールドのすべてのデバイス プラットフォームでサポートされます。詳細については各プラットフォームの *互換* セクションを確認してください。
### プロパティ
@@ -335,7 +345,7 @@ Windows 8 の連絡先は、読み取り専用です。 コルドバ API コン
## ContactAddress
-`ContactAddress`オブジェクトの連絡先の 1 つのアドレスのプロパティが格納されます。 A `Contact` オブジェクトで 1 つ以上のアドレスを含めることができます、 `ContactAddress[]` 配列。
+`ContactAddress` オブジェクトは、連絡先の 1 つのアドレスのプロパティを格納します。 `Contact` オブジェクトは、`ContactAddress` 配列の 1 つ以上のアドレスなどがあります。
### プロパティ
@@ -438,7 +448,7 @@ Windows 8 の連絡先は、読み取り専用です。 コルドバ API コン
## ContactError
-`ContactError`オブジェクトを介してユーザーに返されます、 `contactError` コールバック関数でエラーが発生したとき。
+`ContactError` オブジェクトにエラーが発生したときに `contactError` コールバック関数を通じてユーザーに返されます。
### プロパティ
@@ -456,9 +466,9 @@ Windows 8 の連絡先は、読み取り専用です。 コルドバ API コン
## ContactField
-`ContactField`オブジェクトは連絡先フィールドを総称を表す再利用可能なコンポーネントです。 各 `ContactField` オブジェクトが含まれています、 `value` 、 `type` 、および `pref` プロパティ。 A `Contact` オブジェクトのいくつかのプロパティに格納されます `ContactField[]` 携帯電話番号、メール アドレスなどの配列。
+`ContactField` オブジェクトは連絡先フィールドを総称を表す再利用可能なコンポーネントです。 各 `ContactField` オブジェクトには `値` `型`、および `県` プロパティが含まれています。 `連絡先` オブジェクトは、`ContactField` 配列に、電話番号、メール アドレスなどのいくつかのプロパティを格納します。
-ほとんどの場合、事前に決められた値がない、 `ContactField` オブジェクトの**type**属性。 たとえば、電話番号が*ホーム*、*仕事*、*モバイル*、 *iPhone*、または特定のデバイス プラットフォームの連絡先データベースでサポートされている他の値の**型**の値を指定できます。 ただし、ため、 `Contact` **写真**] フィールドに、**種類**フィールド、返されるイメージの形式を示します: **url** **値**属性**値**を base64 でエンコードされたイメージの文字列が含まれる場合に写真イメージまたは*base64*に URL が含まれる場合。
+ほとんどの場合、`ContactField` オブジェクトの **type** 属性のあらかじめ決められた値はありません。 たとえば、電話番号が *ホーム*、*仕事*、*モバイル*、*iPhone*、または特定のデバイス プラットフォームの連絡先データベースでサポートされている他の値の **型** の値を指定できます。 ただし、`連絡先` **の写真**] のフィールド **の種類**] フィールドを示します返される画像の形式: **url** **値** 属性 **値** を base64 でエンコードされたイメージの文字列が含まれる場合に写真イメージまたは *base64* に URL が含まれる場合。
### プロパティ
@@ -521,7 +531,7 @@ Windows 8 の連絡先は、読み取り専用です。 コルドバ API コン
## 得意先コード
-についての異なる種類情報にはが含まれています、 `Contact` オブジェクトの名前。
+異なる種類 `Contact` オブジェクトの名前についての情報にはが含まれています。
### プロパティ
@@ -540,7 +550,7 @@ Windows 8 の連絡先は、読み取り専用です。 コルドバ API コン
### サポートされているプラットフォーム
* アマゾン火 OS
-* アンドロイド 2.X
+* アンドロイド
* ブラックベリー 10
* Firefox の OS
* iOS
@@ -617,7 +627,7 @@ Windows 8 の連絡先は、読み取り専用です。 コルドバ API コン
## ContactOrganization
-`ContactOrganization`オブジェクトは、連絡先の組織のプロパティを格納します。A `Contact` 1 つまたは複数のオブジェクトに格納されます `ContactOrganization` 配列内のオブジェクト。
+`ContactOrganization` オブジェクトは、連絡先の組織のプロパティを格納します。`連絡先` オブジェクトは、配列の 1 つ以上の `ContactOrganization` オブジェクトを格納します。
### プロパティ
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/293c8b3f/doc/ko/index.md
----------------------------------------------------------------------
diff --git a/doc/ko/index.md b/doc/ko/index.md
index 70e6194..a81378a 100644
--- a/doc/ko/index.md
+++ b/doc/ko/index.md
@@ -19,9 +19,17 @@
# org.apache.cordova.contacts
-장치 연락처 데이터베이스에 대 한 액세스를 제공합니다.
+이 플러그인 장치 연락처 데이터베이스에 대 한 액세스를 제공 하는 글로벌 `navigator.contacts` 개체를 정의 합니다.
-**경고**: 중요 한 개인 정보 보호 문제를 제기 하는 연락처 데이터의 수집 및 사용 합니다. 응용 프로그램의 개인 정보 보호 정책 응용 프로그램 연락처 데이터를 사용 하는 방법 및 다른 당사자와 함께 공유 하는 여부를 토론 해야 한다. 연락처 정보 누구와 통신 하는 사람이 사람들 보여 때문에 민감한으로 간주 됩니다. 따라서 애플 리 케이 션의 개인 정보 보호 정책 뿐만 아니라 강하게 해야 장치 운영 체제는 이렇게 이미 하지 않는 경우 응용 프로그램 액세스 또는 연락처 데이터를 사용 하기 전에 그냥--시간 통지를 제공 합니다. 그 통지는 (예를 들어, **확인** 및 **아니오**선택 제시) 하 여 사용자의 허가 취득 뿐만 아니라, 위에서 언급 된 동일한 정보를 제공 해야 합니다. Note 일부 애플 리 케이 션 장 터 그냥--시간 공지 및 연락처 데이터에 액세�
�� 하기 전에 사용자의 허가 받아야 응용 프로그램에 필요할 수 있습니다. 연락처 데이터는 사용자의 혼동을 방지할 수의 사용 및 연락처 데이터의 인식된 오용 명확 하 고 이해 하기 쉬운 사용자 경험. 자세한 내용은 개인 정보 보호 가이드를 참조 하십시오.
+개체 `navigator` 글로벌 범위 첨부 아니에요 때까지 사용할 수 있는 `deviceready` 이벤트 후.
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+ function onDeviceReady() {
+ console.log(navigator.contacts);
+ }
+
+
+**경고**: 중요 한 개인 정보 보호 문제를 제기 하는 연락처 데이터의 수집 및 사용 합니다. 응용 프로그램의 개인 정보 보호 정책 응용 프로그램 연락처 데이터를 사용 하는 방법 및 다른 당사자와 함께 공유 하는 여부를 토론 해야 한다. 연락처 정보 누구와 통신 하는 사람이 사람들 보여 때문에 민감한으로 간주 됩니다. 따라서, 애플 리 케이 션의 개인 정보 보호 정책 뿐만 아니라 강력 하 게 고려해 야 장치 운영 체제는 이렇게 이미 하지 않는 경우 응용 프로그램 액세스 또는 연락처 데이터를 사용 하기 전에 그냥--시간 통지를 제공 합니다. 그 통지는 (예를 들어, **확인** 및 **아니오** 선택 제시) 하 여 사용자의 허가 취득 뿐만 아니라, 위에서 언급 된 동일한 정보를 제공 해야 합니다. Note 일부 애플 리 케이 션 장 터 그냥--시간 공지 및 연락처 데이
터에 액세스 하기 전에 사용자의 허가 받아야 응용 프로그램에 필요할 수 있습니다. 연락처 데이터는 사용자의 혼동을 방지할 수의 사용 및 연락처 데이터의 인식된 오용 명확 하 고 이해 하기 쉬운 사용자 경험. 자세한 내용은 개인 정보 보호 가이드를 참조 하십시오.
## 설치
@@ -30,7 +38,7 @@
### 파이어 폭스 OS 단점
-[참고 문서][1]에 설명 된 대로 **www/manifest.webapp** 를 만듭니다. 관련 부여할 추가 합니다. [참고 문서][2]에 "권한"-webapp 유형을 변경 하려면 필요가 하다. **경고**: 모든 훌륭한 애플 리 케이 션 인라인 스크립트를 금지 하는 [콘텐츠 보안 정책][3] 을 적용 합니다. 다른 방법으로 응용 프로그램을 초기화 합니다.
+[참고 문서][1]에 설명 된 대로 **www/manifest.webapp**를 만듭니다. 관련 부여할 추가 합니다. [참고 문서][2]에 "privileged"-webapp 유형을 변경 하려면 필요가 하다. **경고**: 모든 훌륭한 애플 리 케이 션 인라인 스크립트를 금지 하는 [콘텐츠 보안 정책][3]을 적용 합니다. 다른 방법으로 응용 프로그램을 초기화 합니다.
[1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
[2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
@@ -47,7 +55,7 @@
### 윈도우 특수
-모든 연락처에서 반환 된 `find` 및 `pickContact` 메서드는 읽기 전용 응용 프로그램을 수정할 수 없습니다. `find`Windows Phone 8.1 장치에만 사용할 수 있는 방법.
+`find` 및 `pickContact` 메서드에서 반환 하는 모든 연락처는 읽기 전용 응용 프로그램을 수정할 수 없습니다. `찾을` 방법은 Windows Phone 8.1 장치에만 사용할 수 있습니다.
### 윈도우 8 단점
@@ -74,9 +82,9 @@
## navigator.contacts.create
-`navigator.contacts.create`메서드는 동기적, 및 새로운 반환 합니다 `Contact` 개체.
+`navigator.contacts.create` 메서드는 동기적 및 새 `연락처` 개체를 반환 합니다.
-이 메서드를 호출 해야 장치 연락처 데이터베이스에 연락처 개체를 유지 하지 않습니다는 `Contact.save` 방법.
+이 메서드는 `Contact.save` 메서드를 호출 해야 장치 연락처 데이터베이스에 연락처 개체를 유지 하지 않습니다.
### 지원 되는 플랫폼
@@ -93,27 +101,29 @@
## navigator.contacts.find
-`navigator.contacts.find`장치 연락처 데이터베이스 쿼리 및의 배열을 반환 메서드가 비동기적으로 실행 될 `Contact` 개체. 결과 객체에 전달 되는 `contactSuccess` **contactSuccess** 매개 변수로 지정 된 콜백 함수.
+장치 연락처 데이터베이스 쿼리 및 `Contact` 개체의 배열을 반환 `navigator.contacts.find` 메서드를 비동기적으로 실행 합니다. 결과 개체는 **contactSuccess** 매개 변수에서 지정한 `contactSuccess` 콜백 함수에 전달 됩니다.
-**ContactFields** 매개 변수는 검색 한정자로 사용할 필드를 지정 합니다. 길이가 0 인 **contactFields** 매개 변수 유효 하지 않습니다 및 결과 `ContactError.INVALID_ARGUMENT_ERROR` . **ContactFields** 값이 `"*"` 모든 연락처 필드를 반환 합니다.
+**contactFields** 매개 변수는 검색 한정자로 사용할 필드를 지정 합니다. 길이가 0 인 **contactFields** 매개 변수가 유효 하 고 `ContactError.INVALID_ARGUMENT_ERROR`에서 결과. **contactFields** 값 `"*"` 모든 연락처 필드를 검색 합니다.
-**ContactFindOptions.filter** 문자열 연락처 데이터베이스를 쿼리할 때 검색 필터로 사용할 수 있습니다. 제공 된, 대/소문자, 부분 값 일치 **contactFields** 매개 변수에 지정 된 각 필드에 적용 됩니다. *모든* 지정 된 필드의 일치 하는 경우 연락처 반환 됩니다. 사용 하 여 **contactFindOptions.desiredFields** 매개 변수 속성 문의 제어를 다시 반환 해야 합니다.
+**contactFindOptions.filter** 문자열 연락처 데이터베이스를 쿼리할 때 검색 필터로 사용할 수 있습니다. 제공 된, 대/소문자, 부분 값 일치 **contactFields** 매개 변수에 지정 된 각 필드에 적용 됩니다. *모든* 지정 된 필드의 일치 하는 경우 연락처 반환 됩니다. 사용 하 여 **contactFindOptions.desiredFields** 매개 변수 속성 문의 제어를 다시 반환 해야 합니다.
### 매개 변수
-* **contactSuccess**: 연락처 개체의 배열에 표시 되는 성공 콜백 함수는 데이터베이스에서 반환 된. [필수]
-
-* **contactError**: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]
+* **contactFields**: 검색 한정자로 사용 하는 필드에 문의. *(DOMString[])* [Required]
-* **contactFields**: 검색 한정자로 사용 하는 필드에 문의. *(DOMString[])* [필수]
+* **contactSuccess**: 연락처 개체의 배열에 표시 되는 성공 콜백 함수는 데이터베이스에서 반환 된. [Required]
-* **contactFindOptions**: navigator.contacts 필터링 옵션을 검색 합니다. [선택 사항] 키 다음과 같습니다.
-
-* **필터**: 검색 문자열 navigator.contacts를 찾는 데 사용 합니다. *(DOMString)* (기본:`""`)
+* **contactError**: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]
-* **여러**: 여러 navigator.contacts 찾기 작업을 반환 합니다 경우 결정 합니다. *(부울)* (기본:`false`)
+* **contactFindOptions**: navigator.contacts 필터링 옵션을 검색 합니다. [Optional]
+
+ 키 다음과 같습니다.
- * **desiredFields**: 연락처 필드를 다시 반환 합니다. 그 결과 지정 된 경우 `Contact` 만이 필드의 값을 보유 하는 개체. *(DOMString[])* [선택 사항]
+ * **filter**: 검색 문자열 navigator.contacts를 찾는 데 사용 합니다. *(DOMString)* (기본: `""`)
+
+ * **multiple**: 여러 navigator.contacts 찾기 작업을 반환 합니다 경우 결정 합니다. *(부울)* (기본값: `false`)
+
+ * **desiredFields**: 연락처 필드를 다시 반환 합니다. 지정 된 경우 결과 `Contact` 기능 값만이 필드 개체입니다. *(DOMString[])* [Optional]
### 지원 되는 플랫폼
@@ -149,7 +159,7 @@
## navigator.contacts.pickContact
-`navigator.contacts.pickContact`메서드가 단일 연락처 선택 문의 선택 시작. 결과 개체에 전달 되는 `contactSuccess` **contactSuccess** 매개 변수로 지정 된 콜백 함수.
+`navigator.contacts.pickContact` 메서드를 사용 하면 단일 연락처 선택 문의 선택 시작 합니다. 결과 개체는 **contactSuccess** 매개 변수에서 지정한 `contactSuccess` 콜백 함수에 전달 됩니다.
### 매개 변수
@@ -176,7 +186,7 @@
## 연락처
-`Contact`개체는 사용자의 연락처를 나타냅니다. 연락처 생성 수, 저장 또는 장치 연락처 데이터베이스에서 제거 합니다. 연락처도 검색할 수 있습니다 (개별적으로 또는 일괄적으로) 데이터베이스에서 호출 하 여는 `navigator.contacts.find` 방법.
+`Contact` 개체는 사용자의 연락처를 나타냅니다. 연락처 생성 수, 저장 또는 장치 연락처 데이터베이스에서 제거 합니다. 연락처도 검색할 수 있습니다 (개별적으로 또는 일괄적으로) 데이터베이스에서 `navigator.contacts.find` 메서드를 호출 하 여.
**참고**: 모든 연락처 필드 위에 나열 된 모든 장치 플랫폼에서 지원 됩니다. 자세한 내용은 각 플랫폼의 *단점이* 섹션을 확인 하시기 바랍니다.
@@ -335,7 +345,7 @@
## ContactAddress
-`ContactAddress`개체는 연락처의 단일 주소 속성을 저장 합니다. A `Contact` 개체에 하나 이상의 주소가 포함 될 수 있습니다는 `ContactAddress[]` 배열.
+`ContactAddress` 개체는 연락처의 단일 주소 속성을 저장합니다. `연락처` 개체는 `ContactAddress` 배열에 있는 하나 이상의 주소를 포함할 수 있습니다.
### 속성
@@ -438,7 +448,7 @@
## ContactError
-`ContactError`개체를 통해 사용자에 게 반환 되는 `contactError` 콜백 함수는 오류가 발생 한 경우.
+`ContactError` 개체는 오류가 발생 하면 `contactError` 콜백 함수를 통해 사용자에 게 반환 됩니다.
### 속성
@@ -456,9 +466,9 @@
## ContactField
-`ContactField`개체는 재사용 가능한 구성 요소를 나타내는 필드를 일반적으로 문의. 각 `ContactField` 개체에 포함 되어 있는 `value` , `type` , 및 `pref` 속성. A `Contact` 개체에 여러 속성이 저장 `ContactField[]` 배열, 전화 번호 및 이메일 주소.
+`ContactField` 개체는 재사용 가능한 구성 요소를 나타내는 필드를 일반적으로 문의입니다. 각 `ContactField` 개체에는 `value`, `type` 및 `pref` 속성을 포함 되어 있습니다. `Contact` 개체는 전화 번호 및 이메일 주소와 같은 `ContactField` 배열에서 몇 가지 속성을 저장합니다.
-대부분의 경우에는 미리 결정 된 값에 대 한는 `ContactField` 개체의 **type** 속성. 예를 들어 전화 번호 *홈*, *작품*, *모바일*, *아이폰*또는 특정 장치 플랫폼의 연락처 데이터베이스에서 지원 되는 다른 값의 **유형** 값을 지정할 수 있습니다. 그러나는 `Contact` **사진** 필드 **유형** 필드 나타냅니다 반환 된 이미지 형식: **url** **값** 특성 **값** 이미지 base64 인코딩된 문자열을 포함 하는 경우 사진 이미지 또는 *base64* URL이 포함 된 경우.
+대부분의 경우에서는 `ContactField` 개체의 **type** 속성에 대 한 미리 정해진된 값이 없습니다. 예를 들어 전화 번호 *홈*, *작품*, *모바일*, *아이폰* 또는 특정 장치 플랫폼의 연락처 데이터베이스에서 지원 되는 다른 값의 **유형** 값을 지정할 수 있습니다. 그러나, `연락처` **사진** 필드 **유형** 필드 나타냅니다 반환 된 이미지 형식: **url** **값** 특성 **값** 이미지 base64 인코딩된 문자열을 포함 하는 경우 사진 이미지 또는 *base64* URL이 포함 된 경우.
### 속성
@@ -521,7 +531,7 @@
## 담당자 이름
-에 대 한 다양 한 정보를 포함 한 `Contact` 개체의 이름.
+여러 종류의 `Contact` 개체의 이름에 대 한 정보를 포함합니다.
### 속성
@@ -540,7 +550,7 @@
### 지원 되는 플랫폼
* 아마존 화재 운영 체제
-* 안 드 로이드 2.X
+* 안 드 로이드
* 블랙베리 10
* Firefox 운영 체제
* iOS
@@ -617,7 +627,7 @@
## ContactOrganization
-`ContactOrganization`개체를 연락처의 조직 속성을 저장 합니다. A `Contact` 개체 저장 하나 이상의 `ContactOrganization` 개체 배열에.
+`ContactOrganization` 개체는 연락처의 조직 속성을 저장합니다. `Contact` 개체 배열에 하나 이상의 `ContactOrganization` 개체를 저장합니다.
### 속성
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/293c8b3f/doc/pl/index.md
----------------------------------------------------------------------
diff --git a/doc/pl/index.md b/doc/pl/index.md
index 3cb074d..fbe788e 100644
--- a/doc/pl/index.md
+++ b/doc/pl/index.md
@@ -19,7 +19,15 @@
# org.apache.cordova.contacts
-Zapewnia dostęp do bazy danych kontaktów urządzenia.
+Ten plugin definiuje obiekt globalny `navigator.contacts`, która zapewnia dostęp do bazy danych kontaktów urządzenia.
+
+Mimo, że obiekt jest dołączony do globalnego zakresu `navigator`, to nie dostępne dopiero po zdarzeniu `deviceready`.
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+ function onDeviceReady() {
+ console.log(navigator.contacts);
+ }
+
**Ostrzeżenie**: zbierania i wykorzystywania danych kontaktowych podnosi kwestie prywatności ważne. Polityka prywatności danej aplikacji należy Dyskutować, jak aplikacja używa danych kontaktowych i czy jest on dzielony z innymi stronami. Informacje kontaktowe uznaje wrażliwych, ponieważ ukazuje ludzi, z którymi osoba komunikuje się. W związku z tym oprócz aplikacji prywatności, zdecydowanie zaleca się zapewnienie just-in czas wypowiedzenia zanim aplikacja uzyskuje dostęp do lub używa danych kontaktowych, jeśli system operacyjny urządzenia nie robi już. Że ogłoszenie powinno zawierać te same informacje, o których wspomniano powyżej, jak również uzyskanie uprawnienia użytkownika (np. poprzez przedstawianie wyborów **OK** i **Nie dzięki**). Należy pamiętać, że niektóre platformy aplikacji może wymagać aplikacji powiadomienia just-in czas i uzyskać uprawnienia użytkownika przed uzyskaniem dostępu do danych kontaktowych. Jasne i łatwe do zrozumien
ia użytkownika doświadczenie, wykorzystanie kontaktów danych pomaga uniknąć nieporozumień użytkownik i postrzegane nadużycia danych kontaktowych. Aby uzyskać więcej informacji zobacz przewodnik prywatności.
@@ -30,7 +38,7 @@ Zapewnia dostęp do bazy danych kontaktów urządzenia.
### Firefox OS dziwactwa
-Tworzenie **www/manifest.webapp** , jak opisano w [Dokumentach Manifest][1]. Dodaj odpowiednie permisions. Istnieje również potrzeba zmienić typ webapp do "uprzywilejowanych" - [Manifest dokumenty][2]. **Ostrzeżenie**: wszystkie uprzywilejowany apps egzekwowania [Treści polityki bezpieczeństwa][3] , który zabrania skrypt. Zainicjować aplikacji w inny sposób.
+Tworzenie **www/manifest.webapp**, jak opisano w [Dokumentach Manifest][1]. Dodaj odpowiednie permisions. Istnieje również potrzeba zmienić typ webapp do "privileged" - [Manifest dokumenty][2]. **Ostrzeżenie**: wszystkie uprzywilejowany apps egzekwowania [Treści polityki bezpieczeństwa][3], który zabrania skrypt. Zainicjować aplikacji w inny sposób.
[1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
[2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
@@ -47,7 +55,7 @@ Tworzenie **www/manifest.webapp** , jak opisano w [Dokumentach Manifest][1]. Dod
### Windows dziwactwa
-Wszelkie kontakty wrócił z `find` i `pickContact` metody są tylko do odczytu, więc aplikacja nie mogą ich modyfikować. `find`Metoda jest dostępna tylko na urządzenia Windows Phone 8.1.
+Wszelkie kontakty wrócił z `pickContact` i `find` metody są tylko do odczytu, więc aplikacja nie mogą ich modyfikować. `find` metody dostępne tylko na urządzenia Windows Phone 8.1.
### Windows 8 dziwactwa
@@ -74,9 +82,9 @@ Windows 8 kontaktów są tylko do odczytu. Poprzez kontakty Cordova API są nie
## Navigator.Contacts.Create
-`navigator.contacts.create`Metoda jest synchroniczna i zwraca nową `Contact` obiektu.
+Metoda `navigator.contacts.create` jest synchroniczna i zwraca nowy obiekt `Contact`.
-Ta metoda nie zachowuje kontakt obiektu bazy danych kontaktów urządzenie, dla którego musisz wywołać `Contact.save` Metoda.
+Ta metoda nie zachowuje kontakt obiektu bazy danych kontaktów urządzenie, dla którego należy wywołać metodę `Contact.save`.
### Obsługiwane platformy
@@ -93,27 +101,29 @@ Ta metoda nie zachowuje kontakt obiektu bazy danych kontaktów urządzenie, dla
## navigator.contacts.find
-`navigator.contacts.find`Metoda asynchronicznie, wykonuje kwerendy bazy danych kontaktów urządzenia i tablicę z `Contact` obiektów. Wynikowe obiekty są przekazywane do `contactSuccess` funkcji wywołania zwrotnego, określony przez parametr **contactSuccess** .
+Metoda `navigator.contacts.find` asynchronicznie, wykonuje kwerendy bazy danych kontaktów urządzenia i tablicę obiektów `kontaktów`. Wynikowe obiekty są przekazywane do funkcji wywołania zwrotnego `contactSuccess`, określony przez parametr **contactSuccess**.
-Parametr **contactFields** określa pola, które mają być używane jako kwalifikator Szukaj. Zerowej długości **contactFields** parametr jest nieprawidłowy i wyniki w `ContactError.INVALID_ARGUMENT_ERROR` . **ContactFields** wartość `"*"` zwraca wszystkich pól.
+Parametr **contactFields** Określa pola, które mają być używane jako kwalifikator Szukaj. Zerowej długości **contactFields** parametr jest nieprawidłowy i wyniki w `ContactError.INVALID_ARGUMENT_ERROR`. **ContactFields** wartość `"*"` przeszukuje wszystkie kontakt z pola.
-Ciąg **contactFindOptions.filter** może służyć jako filtr wyszukiwania, gdy kwerenda bazy danych kontaktów. Jeśli dostarczone, przypadek-niewrażliwe, częściowej wartości mecz jest stosowane do każdego pola określony w parametrze **contactFields** . Jeśli ma odpowiednika dla *każdego* pola określony, zwracany jest kontakt. Użycie **contactFindOptions.desiredFields** parametr do kontroli, które kontakt właściwości muszą zostać zwrócone ponownie.
+Ciąg **contactFindOptions.filter** może służyć jako filtr wyszukiwania, gdy kwerenda bazy danych kontaktów. Jeśli dostarczone, przypadek-niewrażliwe, częściowej wartości mecz jest stosowane do każdego pola określony w parametrze **contactFields**. Jeśli ma odpowiednika dla *każdego* pola określony, zwracany jest kontakt. Użycie **contactFindOptions.desiredFields** parametr do kontroli, które kontakt właściwości muszą zostać zwrócone ponownie.
### Parametry
-* **contactSuccess**: sukcesu funkcji wywołania zwrotnego, wywoływane z tablicy obiektów kontaktów zwracane z bazy danych. [Wymagane]
-
-* **contactError**: Błąd funkcji wywołania zwrotnego, wywoływana, gdy wystąpi błąd. [Opcjonalnie]
+* **contactFields**: kontakt z pól do wykorzystania jako kwalifikator Szukaj. *(DOMString[])* [Required]
-* **contactFields**: kontakt z pól do wykorzystania jako kwalifikator Szukaj. *(DOMString[])* [Wymagane]
+* **contactSuccess**: sukcesu funkcji wywołania zwrotnego, wywoływane z tablicy obiektów kontaktów zwracane z bazy danych. [Required]
-* **contactFindOptions**: Szukaj opcji filtrowania navigator.contacts. [Opcjonalnie] Klucze obejmuje:
-
-* **Filtr**: ciąg wyszukiwania umożliwia znalezienie navigator.contacts. *(DOMString)* (Domyślnie:`""`)
+* **contactError**: Błąd funkcji wywołania zwrotnego, wywoływana, gdy wystąpi błąd. [Opcjonalnie]
-* **wiele**: określa, czy operacja Znajdź zwraca wiele navigator.contacts. *(Wartość logiczna)* (Domyślnie:`false`)
+* **contactFindOptions**: Szukaj opcji filtrowania navigator.contacts. [Optional]
+
+ Klucze obejmuje:
- * **desiredFields**: kontakt z pola, aby być zwrócona. Jeśli określony, wynikającego z `Contact` Obiekt dysponuje tylko wartości tych pól. *(DOMString[])* [Opcjonalnie]
+ * **filter**: ciąg wyszukiwania umożliwia znalezienie navigator.contacts. *(DOMString)* (Domyślnie: `""`)
+
+ * **multiple**: określa, czy operacja Znajdź zwraca wiele navigator.contacts. *(Wartość logiczna)* (Domyślnie: `false`)
+
+ * **desiredFields**: kontakt z pola, aby być zwrócona. Jeśli określony, wynikowy `kontakt` obiekt tylko funkcje wartości tych pól. *(DOMString[])* [Optional]
### Obsługiwane platformy
@@ -149,7 +159,7 @@ Ciąg **contactFindOptions.filter** może służyć jako filtr wyszukiwania, gdy
## navigator.contacts.pickContact
-`navigator.contacts.pickContact`Metoda uruchamia próbnika kontakt, wybierz jeden kontaktem. Wynikowy obiekt jest przekazywany do `contactSuccess` funkcji wywołania zwrotnego, określony przez parametr **contactSuccess** .
+Metoda `navigator.contacts.pickContact` uruchamia próbnika kontakt, wybierz jeden kontaktem. Wynikowy obiekt jest przekazywany do funkcji wywołania zwrotnego `contactSuccess`, określony przez parametr **contactSuccess**.
### Parametry
@@ -176,7 +186,7 @@ Ciąg **contactFindOptions.filter** może służyć jako filtr wyszukiwania, gdy
## Kontakt
-`Contact`Obiekt reprezentuje informacje kontaktowe. Kontakty mogą być tworzone, przechowywane lub usunięte z bazy danych kontaktów urządzenia. Kontakty można również pobrać (pojedynczo lub zbiorczo) bazy danych przez `navigator.contacts.find` Metoda.
+`Contact` obiekt reprezentuje informacje kontaktowe. Kontakty mogą być tworzone, przechowywane lub usunięte z bazy danych kontaktów urządzenia. Kontakty można również pobrać (pojedynczo lub zbiorczo) bazy danych przez wywołanie metody `navigator.contacts.find`.
**Uwaga**: nie wszystkie pola kontaktowe wymienione powyżej są obsługiwane na każdej platformie urządzenia. Proszę sprawdzić każdej platformy *dziwactw* sekcji szczegółów.
@@ -335,7 +345,7 @@ Ciąg **contactFindOptions.filter** może służyć jako filtr wyszukiwania, gdy
## ContactAddress
-`ContactAddress`Obiektu przechowuje właściwości pojedynczego adresu kontaktu. A `Contact` obiektu może zawierać więcej niż jeden adres w `ContactAddress[]` tablicy.
+Obiekt `ContactAddress` przechowuje właściwości pojedynczego adresu kontaktu. Obiekt `Contact` może zawierać więcej niż jeden adres w tablicy `[ContactAddress]`.
### Właściwości
@@ -438,7 +448,7 @@ Ciąg **contactFindOptions.filter** może służyć jako filtr wyszukiwania, gdy
## ContactError
-`ContactError`Zwracany jest obiekt użytkownika za pomocą `contactError` funkcji wywołania zwrotnego, gdy wystąpi błąd.
+`ContactError` obiekt jest zwracany użytkownikowi za pośrednictwem funkcji wywołania zwrotnego `contactError`, gdy wystąpi błąd.
### Właściwości
@@ -456,9 +466,9 @@ Ciąg **contactFindOptions.filter** może służyć jako filtr wyszukiwania, gdy
## ContactField
-`ContactField`Obiekt jest składnikiem wielokrotnego użytku, że reprezentuje kontakt pola ogólnie. Każdy `ContactField` zawiera obiekt `value` , `type` , a `pref` Właściwość. A `Contact` obiektu przechowuje wiele właściwości w `ContactField[]` tablice, takie jak numery telefonu, adres e-mail.
+Obiekt `ContactField` jest składnikiem wielokrotnego użytku, że reprezentuje kontakt pola ogólnie. Każdy obiekt `ContactField` zawiera `wartość`, `Typ` i `pref` Właściwość. Obiekt `Contact` sklepy kilku właściwości w tablicach `[ContactField]`, takich jak numery telefonów i adresy e-mail.
-W większości przypadków, są nie wcześniej ustalonych wartości dla `ContactField` atrybut **typu** obiektu. Na przykład numer telefonu można określić **Typ** wartości *domu*, *pracy*, *mobile*, *iPhone*, lub jakąkolwiek inną wartość, który jest obsługiwany przez platformę danego urządzenia bazy danych kontaktów. Jednak dla `Contact` **zdjęcia** pola, pole **Typ** wskazuje format zwrócone obrazu: **url** **wartość** atrybut zawiera adres URL do zdjęć lub *base64* , gdy **wartość** zawiera ciąg base64 zakodowany obraz.
+W większości przypadków są nie wcześniej ustalonych wartości atrybutu **type** obiektu `ContactField`. Na przykład numer telefonu można określić **type** wartości *home*, *work*, *mobile*, *iPhone*, lub jakąkolwiek inną wartość, który jest obsługiwany przez platformę danego urządzenia bazy danych kontaktów. Jednak `Contact` **photos** pola, pole **type** wskazuje format zwrócone obrazu: **url**, gdy **value** atrybut zawiera adres URL, do zdjęć, lub *base64*, gdy **value** zawiera ciąg zakodowany base64 obrazu.
### Właściwości
@@ -521,7 +531,7 @@ W większości przypadków, są nie wcześniej ustalonych wartości dla `Contact
## Przedstawiciel
-Zawiera różne rodzaje informacji o `Contact` Nazwa obiektu.
+Zawiera różne rodzaje informacji o nazwę obiektu `Contact`.
### Właściwości
@@ -540,7 +550,7 @@ Zawiera różne rodzaje informacji o `Contact` Nazwa obiektu.
### Obsługiwane platformy
* Amazon Fire OS
-* Android 2.X
+* Android
* BlackBerry 10
* Firefox OS
* iOS
@@ -617,7 +627,7 @@ Zawiera różne rodzaje informacji o `Contact` Nazwa obiektu.
## ContactOrganization
-`ContactOrganization`Obiektu przechowuje właściwości organizacji kontaktu. A `Contact` obiektu przechowuje jeden lub więcej `ContactOrganization` obiekty w tablicy.
+Obiekt `ContactOrganization` przechowuje właściwości organizacji kontaktu. Obiekt `Contact` sklepy jeden lub więcej obiektów `ContactOrganization` w tablicy.
### Właściwości
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/293c8b3f/doc/zh/index.md
----------------------------------------------------------------------
diff --git a/doc/zh/index.md b/doc/zh/index.md
index 3d0caae..7e9ffbf 100644
--- a/doc/zh/index.md
+++ b/doc/zh/index.md
@@ -19,9 +19,17 @@
# org.apache.cordova.contacts
-提供對設備的連絡人資料庫的訪問。
+這個外掛程式定義了一個全域 `navigator.contacts` 物件，提供對設備連絡人資料庫的訪問。
-**警告**： 連絡人資料的收集和使用提出了重要的隱私問題。 您的應用程式的隱私權原則應該討論如何應用程式使用的連絡人資料和它是否被共用與任何其他方。 聯繫資訊被視為敏感，因為它揭示了人與人通信的人們。 因此，除了應用程式的隱私權原則，您應強烈考慮提供-時間通知之前應用程式訪問或使用的連絡人資料，如果設備作業系統不會這樣做已經。 該通知應提供相同的資訊上文指出的並獲取該使用者的許可權 （例如，通過為**確定**並**不感謝**提出的選擇）。 請注意一些應用程式市場可能需要應用程式來提供只是在時間的通知，並獲得相應許可權的使用者在訪問連絡人資料之前。 周圍的連絡人資料可説明避免使用者混淆使用感知的和濫用的連絡人資料的清晰和易於理解的使用者體驗。 有關詳細資訊，請參閱隱私指南。
+雖然該物件附加到全球範圍內 `導航器`，它不可用直到 `deviceready` 事件之後。
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+ function onDeviceReady() {
+ console.log(navigator.contacts);
+ }
+
+
+**警告**： 連絡人資料的收集和使用提出了重要的隱私問題。 您的應用程式的隱私權原則應該討論應用程式如何使用連絡人資料和它是否被共用與任何其他締約方。 聯繫資訊被認為是敏感，因為它揭示了的人與人溝通了。 因此，除了隱私權原則的應用程式，您應強烈考慮提供時間只是通知之前應用程式訪問或使用連絡人的資料，如果設備作業系統不已經這樣做了。 該通知應提供相同的資訊，如上所述，以及獲取該使用者的許可權 （例如，通過提出選擇 **確定** 並 **不感謝**）。 請注意一些應用程式市場可能需要應用程式提供只是時間的通知，並獲得使用者的許可才能訪問連絡人資料。 周圍的連絡人資料可以説明避免使用者混淆使用和連絡人資料感知的濫用的清楚和容易理解的使用者體驗。 有關詳細資訊，請參閱隱私指南。
## 安裝
@@ -30,7 +38,7 @@
### 火狐瀏覽器作業系統的怪癖
-在[清單檔][1]中所述創建**www/manifest.webapp** 。 添加相關許可權。 也是需要 web 應用程式的類型更改為"特權"-[清單文檔][2]。 **警告**： 所有特權應用程式強制執行禁止內聯腳本的[內容安全性原則][3]。 在另一種方式初始化應用程式。
+在 [清單檔][1] 中所述創建 **www/manifest.webapp**。 添加相關的許可權。 也是需要的 web 應用程式類型更改為"privileged"— — [顯化的文檔][2]。 **警告**： 所有的特權應用程式強制執行禁止內聯腳本的 [內容的安全性原則][3]。 在另一種方式初始化您的應用程式。
[1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
[2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
@@ -47,11 +55,11 @@
### Windows 的怪癖
-從返回的任何連絡人 `find` 和 `pickContact` 方法是唯讀，因此您的應用程式不能修改它們。 `find`僅在 Windows Phone 8.1 設備上可用的方法。
+從 `find` 和 `pickContact` 方法返回任何連絡人是唯讀，因此您的應用程式不能修改它們。 僅在 Windows Phone 8.1 設備上可用的 `find` 方法。
### Windows 8 的怪癖
-Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查詢/搜索，你應通知使用者挑選連絡人作為對 contacts.pickContact 這將打開的 '人' 應用程式的調用，使用者必須選擇一個連絡人。 返回任何連絡人是唯讀，因此您的應用程式不能修改它們。
+Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查詢/搜索，您應通知使用者挑選連絡人作為調用 contacts.pickContact，將會打開 '人' 的應用程式，使用者必須選擇一個連絡人。 返回任何連絡人是唯讀，因此您的應用程式不能修改它們。
## navigator.contacts
@@ -74,9 +82,9 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
## navigator.contacts.create
-`navigator.contacts.create`方法是同步的並返回一個新的 `Contact` 物件。
+`navigator.contacts.create` 方法是同步的並返回一個新的 `Contact` 物件。
-這種方法不會保留在設備的連絡人資料庫中，您需要為其調用該連絡人物件 `Contact.save` 的方法。
+此方法將不會保留在設備連絡人資料庫中，需要調用 `Contact.save` 方法的聯繫物件。
### 支援的平臺
@@ -93,27 +101,29 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
## navigator.contacts.find
-`navigator.contacts.find`方法以非同步方式，執行設備的連絡人資料庫查詢並返回一個陣列的 `Contact` 物件。 生成的物件被傳遞給 `contactSuccess` 的**contactSuccess**參數所指定的回呼函數。
+`navigator.contacts.find` 方法以非同步方式，執行設備連絡人資料庫查詢並返回 `Contact` 物件的陣列。 生成的物件被傳遞到由 **contactSuccess** 參數指定的 `contactSuccess` 回呼函數。
-**ContactFields**參數指定的欄位用作搜索的限定詞。 一個長度為零的**contactFields**參數是不正確結果在 `ContactError.INVALID_ARGUMENT_ERROR` 。 **ContactFields**值為 `"*"` 返回所有連絡人欄位。
+**contactFields** 參數指定的欄位用作搜索限定詞。 長度為零的 **contactFields** 參數是不正確並導致 `ContactError.INVALID_ARGUMENT_ERROR`。 **contactFields** 值為 `"*"` 搜索所有連絡人欄位。
-**ContactFindOptions.filter**字串查詢連絡人資料庫時，可以用作搜索篩選器。 如果提供，不區分大小寫，部分值匹配被應用於在**contactFields**參數中指定的每個欄位。 如果有*任何*指定的欄位的匹配，則返回該連絡人。 使用**contactFindOptions.desiredFields**參數來控制哪些連絡人屬性必須回來。
+在連絡人資料庫查詢時，**contactFindOptions.filter** 字串可以用作搜索篩選器。 如果提供，不區分大小寫，部分值匹配被適用于在 **contactFields** 參數中指定的每個欄位。 如果存在匹配的 *任何* 指定的欄位，則返回連絡人。 使用 **contactFindOptions.desiredFields** 參數來控制哪些連絡人屬性必須回來。
### 參數
-* **contactSuccess**： 從資料庫返回成功回呼函數調用時使用的連絡人物件的陣列。[要求]
-
-* **contactError**： 錯誤回呼函數，當發生錯誤時調用。[可選]
+* **contactFields**： '連絡人' 欄位用作搜索限定詞。*(DOMString[])* [Required]
-* **contactFields**： 連絡人欄位使用作為搜索的限定詞。*(DOMString[])*[要求]
+* **contactSuccess**： 從資料庫返回的成功回呼函數調用時使用的連絡人物件的陣列。[Required]
-* **contactFindOptions**: 搜索選項來篩選 navigator.contacts。[可選]鍵包括：
-
-* **篩選器**： 用來查找 navigator.contacts 的搜索字串。*() DOMString*（預設值：`""`)
+* **contactError**： 錯誤回呼函數，當發生錯誤時調用。[可選]
-* **多個**： 確定是否查找操作返回多個 navigator.contacts。*（布林）*（預設值：`false`)
+* **contactFindOptions**： 搜索選項來篩選 navigator.contacts。[Optional]
+
+ 鍵包括：
- * **desiredFields**: 聯繫要回返回的欄位。如果指定了，生成的 `Contact` 物件只能使用這些欄位的值。*(DOMString[])*[可選]
+ * **filter**： 用來找到 navigator.contacts 的搜索字串。*() DOMString*（預設： `""`)
+
+ * **multiple**： 確定是否查找操作返回多個 navigator.contacts。*(布林值)*（預設值： `false`)
+
+ * **desiredFields**： '連絡人' 欄位，又折回來。如果指定，由此產生的 `Contact` 物件只有這些欄位的功能值。*(DOMString[])* [Optional]
### 支援的平臺
@@ -149,7 +159,7 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
## navigator.contacts.pickContact
-`navigator.contacts.pickContact`方法啟動連絡人選擇器來選擇一個連絡人。 所產生的物件傳遞給 `contactSuccess` 的**contactSuccess**參數所指定的回呼函數。
+`navigator.contacts.pickContact` 方法啟動連絡人選取器來選擇一個連絡人。 將生成的物件傳遞給 **contactSuccess** 參數所指定的 `contactSuccess` 回呼函數。
### 參數
@@ -176,47 +186,47 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
## 連絡人
-`Contact`物件表示使用者的連絡人。 連絡人可以創建、 存儲，或從設備的連絡人資料庫中刪除。 連絡人可以也被 (單獨或批量） 從資料庫中檢索通過調用 `navigator.contacts.find` 方法。
+`Contact` 物件表示使用者的連絡人。 可以創建、 存儲，或從設備的連絡人資料庫中刪除連絡人。 連絡人可以也被 （單獨或批量） 從資料庫中檢索通過調用 `navigator.contacts.find` 方法。
-**注意**： 並不是所有上面列出的連絡人欄位平臺支援的每個設備。請檢查每個平臺*的怪癖*節瞭解詳細資訊。
+**注**： 並不是所有上面列出的連絡人欄位支援的每個設備的平臺。請檢查每個平臺 *的怪癖* 節瞭解詳細資訊。
### 屬性
* **id**： 一個全域唯一識別碼。*() DOMString*
-* **顯示名稱**： 此連絡人，適合於向最終使用者顯示的名稱。*() DOMString*
+* **displayName**： 此連絡人，適合於向最終使用者顯示的名稱。*() DOMString*
-* **名稱**： 一個物件，包含所有元件的一個人的名字。*（連絡人姓名）*
+* **name**： 一個物件，包含所有元件的一個人的名字。*（連絡人姓名）*
-* **昵稱**： 休閒的位址連絡人名稱。*() DOMString*
+* **nickname**： 休閒的位址連絡人名稱。*() DOMString*
-* **手機號碼**： 陣列的所有連絡人的電話號碼。*(ContactField[])*
+* **phoneNumbers**： 陣列的所有連絡人的電話號碼。*(ContactField[])*
-* **電子郵件**： 所有連絡人的電子郵件地址的陣列。*(ContactField[])*
+* **emails**： 所有連絡人的電子郵件地址的陣列。*(ContactField[])*
-* **位址**： 該連絡人的所有位址的陣列。*(ContactAddress[])*
+* **addresses**： 該連絡人的所有位址的陣列。*(ContactAddress[])*
* **ims**： 所有連絡人的 IM 位址的陣列。*(ContactField[])*
-* **組織**： 該連絡人的所有組織的陣列。*(ContactOrganization[])*
+* **organizations**： 該連絡人的所有組織的陣列。*(ContactOrganization[])*
-* **生日**： 連絡人的生日。*（日期）*
+* **birthday**： 連絡人的生日。*(Date)*
-* **注意**： 注意有關的聯繫。*() DOMString*
+* **note**： 注意有關的聯繫。*() DOMString*
-* **照片**： 陣列的連絡人的照片。*(ContactField[])*
+* **photos**： 陣列的連絡人的照片。*(ContactField[])*
-* **類別**： 陣列與連絡人關聯的所有使用者定義的類別。*(ContactField[])*
+* **categories**： 陣列與連絡人關聯的所有使用者定義的類別。*(ContactField[])*
* **url**： 陣列與連絡人關聯的 web 頁。*(ContactField[])*
### 方法
-* **克隆**： 返回一個新的 `Contact` 物件就是調用物件的深層副本 `id` 屬性設置為`null`.
+* **clone**： 返回一個新的 `Contact` 物件就是調用物件的深層副本 `id` 屬性設置為`null`.
-* **刪除**： 從設備的連絡人資料庫中刪除連絡人，否則執行錯誤回檔與 `ContactError` 物件。
+* **remove**： 從設備的連絡人資料庫中刪除連絡人，否則執行錯誤回檔與 `ContactError` 物件。
-* **保存**： 將一個新的連絡人保存到設備的連絡人資料庫中，或更新現有的連絡人，如果已存在具有相同**id**的連絡人。
+* **save**： 將一個新的連絡人保存到設備的連絡人資料庫中，或更新現有的連絡人，如果已存在具有相同 **id** 的連絡人。
### 支援的平臺
@@ -279,7 +289,7 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
### Android 2.X 的怪癖
-* **類別**： 不支援 Android 2.X 在設備上，返回`null`.
+* **categories**： 不支援 Android 2.X 在設備上，返回`null`.
### 黑莓 10 的怪癖
@@ -287,73 +297,73 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
### FirefoxOS 的怪癖
-* **類別**： 部分支援。返回欄位**設定**和**類型**`null`
+* **categories**： 部分支援。返回欄位**pref**和**type**`null`
* **ims**： 不支援
-* **照片**： 不支援
+* **photos**： 不支援
### iOS 的怪癖
-* **顯示名稱**： 上返回的 iOS 不支援 `null` 除非有沒有 `ContactName` 指定，在這種情況下它將返回複合名稱，**昵稱**或 `""` ，分別。
+* **displayName**： 上返回的 iOS 不支援 `null` 除非有沒有 `ContactName` 指定，在這種情況下它將返回複合名稱，**nickname**或 `""` ，分別。
-* **生日**： 必須輸入 JavaScript 作為 `Date` 物件，它將返回相同的方式。
+* **birthday**： 必須輸入 JavaScript 作為 `Date` 物件，它將返回相同的方式。
-* **照片**： 返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。當應用程式退出時刪除臨時目錄的內容。
+* **photos**： 返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。當應用程式退出時刪除臨時目錄的內容。
-* **類別**： 目前不支援此屬性，返回`null`.
+* **categories**： 目前不支援此屬性，返回`null`.
### Windows Phone 7 和 8 的怪癖
-* **顯示名稱**： 當創建一個連絡人，提供的顯示名稱參數不同于顯示名稱的值檢索查找連絡人時。
+* **displayName**： 當創建一個連絡人，提供的顯示名稱參數不同于顯示名稱的值檢索查找連絡人時。
* **url**： 當創建一個連絡人，使用者可以輸入和保存多個 web 位址，但只有一個是可用的搜索連絡人時。
-* **聯繫電話嘛**：*究竟*選項不受支援。 在*查找*操作中不是支援的*類型*。 只有一個 `phoneNumber` 允許的每個*類型*.
+* **phoneNumbers**：*pref*選項不受支援。 在*type*操作中不是支援的*find*。 只有一個 `phoneNumber` 允許的每個*type*.
-* **電子郵件**：*究竟*選項不受支援。家庭和個人使用引用同一電子郵件項。只有一項是允許的每個*類型*.
+* **emails**：*pref*選項不受支援。家庭和個人使用引用同一電子郵件項。只有一項是允許的每個*type*.
-* **位址**： 僅支援的工作和家庭/個人*類型*。家庭和個人*類型*引用相同的位址條目。只有一項是允許的每個*類型*.
+* **addresses**： 僅支援的工作和家庭/個人*type*。家庭和個人*type*引用相同的位址條目。只有一項是允許的每個*type*.
-* **組織**： 唯一一個允許的和不支援的*那個 + 號*、*類型*和*部門*的屬性。
+* **organizations**： 唯一一個允許的和不支援的*pref*、*type*和*department*的屬性。
-* **注意**： 不支援，返回`null`.
+* **note**： 不支援，返回`null`.
* **ims**： 不受支援，返回`null`.
-* **生日**: 不受支援，返回`null`.
+* **birthdays**: 不受支援，返回`null`.
-* **類別**： 不受支援，返回`null`.
+* **categories**： 不受支援，返回`null`.
### Windows 的怪癖
-* **照片**： 返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。
+* **photos**： 返回到圖像中，存儲在應用程式的臨時目錄中檔的 URL。
-* **生日**: 不受支援，返回`null`.
+* **birthdays**: 不受支援，返回`null`.
-* **類別**： 不受支援，返回`null`.
+* **categories**： 不受支援，返回`null`.
## ContactAddress
-`ContactAddress`物件存儲的單一位址的連絡人的屬性。 A `Contact` 物件可能包括多個位址在 `ContactAddress[]` 陣列。
+`ContactAddress` 物件存儲單個位址的連絡人的屬性。 `Contact` 物件可能包括多個位址 `ContactAddress []` 陣列中。
### 屬性
-* **那個 + 號**： 設置為 `true` 如果這個 `ContactAddress` 包含使用者的首選的價值。*（布林）*
+* **pref**： 設置為 `true` 如果這個 `ContactAddress` 包含使用者的首選的價值。*（Boolean）*
-* **類型**： 一個字串，例如指示哪種類型的欄位，這是*回家*。*() DOMString*
+* **type**： 一個字串，例如指示哪種類型的欄位，這是*home*。*() DOMString*
-* **格式**： 顯示格式的完整位址。*() DOMString*
+* **formatted**： 顯示格式的完整位址。*() DOMString*
* **streetAddress**： 完整的街道位址。*() DOMString*
-* **地點**： 城市或地點。*() DOMString*
+* **locality**： 城市或地點。*() DOMString*
-* **區域**： 國家或地區。*() DOMString*
+* **region**： 國家或地區。*() DOMString*
-* **郵遞區號**： 郵遞區號。*() DOMString*
+* **postalCode**： 郵遞區號。*() DOMString*
-* **國家**： 國家名稱。*() DOMString*
+* **country**： 國家名稱。*() DOMString*
### 支援的平臺
@@ -398,51 +408,51 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
### Android 2.X 的怪癖
-* **究竟**: 不受支援，返回 `false` Android 2.X 的設備上。
+* **pref**: 不受支援，返回 `false` Android 2.X 的設備上。
### 黑莓 10 的怪癖
-* **設定**： 在返回的黑莓設備上不支援`false`.
+* **pref**： 在返回的黑莓設備上不支援`false`.
-* **類型**： 部分支援。只有一個*工作*和*家裡*類型位址可以存儲每個連絡人。
+* **type**： 部分支援。只有一個*Word*和*Home*類型位址可以存儲每個連絡人。
-* **格式化**： 部分支援。返回的串聯的所有黑莓手機位址欄位。
+* **formatted**： 部分支援。返回的串聯的所有黑莓手機位址欄位。
-* **streetAddress**： 支援。返回和串聯組成的黑莓**位址 1** **位址 2**位址欄位。
+* **streetAddress**： 支援。返回和串聯組成的黑莓**address1** **address2**位址欄位。
-* **所在地**： 支援。黑莓手機**城**位址欄位中存儲。
+* **locality**： 支援。黑莓手機**city**位址欄位中存儲。
-* **區域**： 支援。黑莓**stateProvince**位址欄位中存儲。
+* **region**： 支援。黑莓**stateProvince**位址欄位中存儲。
-* **郵遞區號**： 支援。黑莓**zipPostal**位址欄位中存儲。
+* **postalCode**： 支援。黑莓**zipPostal**位址欄位中存儲。
-* **國家**： 支援。
+* **country**： 支援。
### FirefoxOS 的怪癖
-* **格式化**： 目前不支援
+* **formatted**： 目前不支援
### iOS 的怪癖
-* **那個 + 號**： 不支援在 iOS 設備上，返回`false`.
+* **pref**： 不支援在 iOS 設備上，返回`false`.
-* **格式化**： 目前不支援。
+* **formatted**： 目前不支援。
### Windows 8 的怪癖
-* **那個 + 號**： 不支援
+* **pref**： 不支援
### Windows 的怪癖
-* **那個 + 號**： 不支援
+* **pref**： 不支援
## ContactError
-`ContactError`物件返回到使用者通過 `contactError` 發生錯誤時的回呼函數。
+當發生錯誤時，通過 `contactError` 回呼函數為使用者情況下會返回的 `ContactError` 物件。
### 屬性
-* **代碼**： 下面列出的預定義的錯誤代碼之一。
+* **code**： 下面列出的預定義的錯誤代碼之一。
### 常量
@@ -456,17 +466,17 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
## ContactField
-`ContactField`物件是可重用的元件代表一般連絡人欄位。 每個 `ContactField` 物件包含 `value` ， `type` ，和 `pref` 屬性。 A `Contact` 物件存儲中的幾個屬性 `ContactField[]` 陣列，例如電話號碼和電子郵件地址。
+`ContactField` 物件是可重用的元件代表一般連絡人欄位。 每個 `ContactField` 物件包含一個 `value`、 `type` 和 `pref` 的屬性。 `Contacat` 物件將幾個屬性存儲在 `ContactField []` 陣列，例如電話號碼和電子郵件地址。
-在大多數情況下，有沒有預先確定的值 `ContactField` 物件的**type**屬性。 例如，電話號碼可以指定**類型**的*家庭*、*工作*、*手機*、 *iPhone*或由一個特定的設備平臺接觸資料庫系統支援的任何其他值的值。 然而，對於 `Contact` **的照片**欄位，**類型**欄位指示返回圖像的格式： **url**的**值**屬性包含的照片圖像或*base64*的 URL 時的**值**包含一個 base64 編碼圖像字串時。
+在大多數情況下，沒有預先確定的 `ContactField` 物件的 **type** 屬性值。 例如，一個電話號碼可以指定 **type** 值的 *home*、 *work*、 *mobile*、 *iPhone* 或由一個特定的設備平臺接觸資料庫系統支援的任何其他值。 然而，為 `photos` **照片** 欄位中，**type** 欄位指示返回圖像的格式： 當 **value** 屬性包含一個指向的照片圖像或 *base64* URL 時的 **value** 包含 string base64 編碼的圖像的 **url**。
### 屬性
-* **類型**： 一個字串，例如指示哪種類型的欄位，這是*回家*。*() DOMString*
+* **type**： 一個字串，例如指示哪種類型的欄位，這是*home*。*() DOMString*
-* **價值**： 欄位的值，如電話號碼或電子郵件地址。*() DOMString*
+* **value**： 欄位的值，如電話號碼或電子郵件地址。*() DOMString*
-* **那個 + 號**： 設置為 `true` 如果這個 `ContactField` 包含使用者的首選的價值。*（布林）*
+* **pref**： 設置為 `true` 如果這個 `ContactField` 包含使用者的首選的價值。*（布林）*
### 支援的平臺
@@ -497,41 +507,41 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
### Android 的怪癖
-* **上一頁**: 不受支援，返回`false`.
+* **pref**: 不受支援，返回`false`.
### 黑莓 10 的怪癖
-* **類型**： 部分支援。使用的電話號碼。
+* **type**： 部分支援。使用的電話號碼。
-* **價值**： 支援。
+* **value**： 支援。
-* **究竟**: 不受支援，返回`false`.
+* **pref**: 不受支援，返回`false`.
### iOS 的怪癖
-* **究竟**: 不受支援，返回`false`.
+* **pref**: 不受支援，返回`false`.
### Windows8 的怪癖
-* **究竟**: 不受支援，返回`false`.
+* **pref**: 不受支援，返回`false`.
### Windows 的怪癖
-* **究竟**: 不受支援，返回`false`.
+* **pref**: 不受支援，返回`false`.
-## 連絡人姓名
+## ContactName
-關於包含不同種類的資訊 `Contact` 物件的名稱。
+包含不同種類的 `Contact` 物件名稱有關的資訊。
### 屬性
-* **格式化**： 該連絡人的完整名稱。*() DOMString*
+* **formatted**： 該連絡人的完整名稱。*() DOMString*
-* **字體集**： 連絡人的姓氏。*() DOMString*
+* **familyName**： 連絡人的姓氏。*() DOMString*
* **givenName**： 連絡人的名字。*() DOMString*
-* **連絡人**： 連絡人的中間名。*() DOMString*
+* **middleName**： 連絡人的中間名。*() DOMString*
* **honorificPrefix**： 連絡人的首碼 （例如*先生*或*博士*） *(DOMString)*
@@ -540,7 +550,7 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
### 支援的平臺
* 亞馬遜火 OS
-* Android 2.X
+* Android 系統
* 黑莓 10
* 火狐瀏覽器的作業系統
* iOS
@@ -573,17 +583,17 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
### Android 的怪癖
-* **格式化**： 部分受支援，並為唯讀。 返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
+* **formatted**： 部分受支援，並為唯讀。 返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
### 黑莓 10 的怪癖
-* **格式化**： 部分支援。返回的串聯的黑莓手機**名字**和**姓氏**欄位。
+* **formatted**： 部分支援。返回的串聯的黑莓手機**firstName**和**lastName**欄位。
-* **字體集**： 支援。黑莓**姓氏**欄位中存儲。
+* **familyName**： 支援。黑莓**lastName**欄位中存儲。
-* **givenName**： 支援。黑莓**名字**欄位中存儲。
+* **givenName**： 支援。黑莓**firstName**欄位中存儲。
-* **連絡人**: 不受支援，返回`null`.
+* **middleName**: 不受支援，返回`null`.
* **honorificPrefix**: 不受支援，返回`null`.
@@ -591,21 +601,21 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
### FirefoxOS 的怪癖
-* **格式化**： 部分受支援，並為唯讀。 返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
+* **formatted**： 部分受支援，並為唯讀。 返回的串聯的 `honorificPrefix` ， `givenName` ， `middleName` ， `familyName` ，和`honorificSuffix`.
### iOS 的怪癖
-* **格式化**： 部分支援。返回 iOS 複合名稱，但為唯讀。
+* **formatted**： 部分支援。返回 iOS 複合名稱，但為唯讀。
### Windows 8 的怪癖
-* **格式**： 這是唯一名稱屬性，並且是相同的 `displayName` ，和`nickname`
+* **formatted**： 這是唯一名稱屬性，並且是相同的 `displayName` ，和`nickname`
-* **字體集**： 不支援
+* **familyName**： 不支援
* **givenName**： 不支援
-* **連絡人**： 不支援
+* **middleName**： 不支援
* **honorificPrefix**: 不支援
@@ -613,23 +623,23 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
### Windows 的怪癖
-* **格式**： 它是完全相同`displayName`
+* **formatted**： 它是完全相同`displayName`
## ContactOrganization
-`ContactOrganization`物件存儲連絡人的組織屬性。A `Contact` 物件存儲一個或多個 `ContactOrganization` 陣列中的物件。
+`ContactOrganization` 物件存儲連絡人的組織屬性。`Contact` 物件將一個或多個 `ContactOrganization` 物件存儲在一個陣列中。
### 屬性
-* **那個 + 號**： 設置為 `true` 如果這個 `ContactOrganization` 包含使用者的首選的價值。*（布林）*
+* **pref**： 設置為 `true` 如果這個 `ContactOrganization` 包含使用者的首選的價值。*（布林）*
-* **類型**： 一個字串，例如指示哪種類型的欄位，這是*回家*。_(DOMString)
+* **type**： 一個字串，例如指示哪種類型的欄位，這是*回家*。_(DOMString)
-* **名稱**： 組織的名稱。*() DOMString*
+* **name**： 組織的名稱。*() DOMString*
-* **部門**： 合同工作為的部門。*() DOMString*
+* **department**： 合同工作為的部門。*() DOMString*
-* **標題**： 在組織連絡人的標題。*() DOMString*
+* **title**： 在組織連絡人的標題。*() DOMString*
### 支援的平臺
@@ -666,44 +676,44 @@ Windows 8 連絡人是唯讀的。 透過科爾多瓦 API 接觸的不是可查
### Android 2.X 的怪癖
-* **那個 + 號**： 不支援的 Android 2.X 的設備，返回`false`.
+* **pref**： 不支援的 Android 2.X 的設備，返回`false`.
### 黑莓 10 的怪癖
-* **那個 + 號**： 不支援的黑莓手機，返回`false`.
+* **pref**： 不支援的黑莓手機，返回`false`.
-* **類型**： 不支援的黑莓手機，返回`null`.
+* **type**： 不支援的黑莓手機，返回`null`.
-* **名稱**： 部分支援。第一次組織名稱存儲在黑莓**公司**欄位中。
+* **name**： 部分支援。第一次組織名稱存儲在黑莓**company**欄位中。
-* **部**: 不受支援，返回`null`.
+* **department**: 不受支援，返回`null`.
-* **標題**： 部分支援。第一次組織標題存儲在欄位中黑莓**渺小**。
+* **title**： 部分支援。第一次組織標題存儲在欄位中黑莓**jobTitle**。
### 火狐瀏覽器作業系統的怪癖
-* **那個 + 號**： 不支援
+* **pref**： 不支援
-* **類型**： 不支援
+* **type**： 不支援
-* **部門**： 不支援
+* **department**： 不支援
-* 欄位**名稱**和**標題**存儲在**組織結構圖**和**渺小**.
+* 欄位**name**和**title**存儲在**org**和**jobTitle**.
### iOS 的怪癖
-* **那個 + 號**： 不支援在 iOS 設備上，返回`false`.
+* **pref**： 不支援在 iOS 設備上，返回`false`.
-* **類型**： 不支援在 iOS 設備上，返回`null`.
+* **type**： 不支援在 iOS 設備上，返回`null`.
-* **名稱**： 部分支援。第一次組織名稱存儲在 iOS **kABPersonOrganizationProperty**欄位中。
+* **name**： 部分支援。第一次組織名稱存儲在 iOS **kABPersonOrganizationProperty**欄位中。
-* **部門**： 部分支援。第一部門名稱存儲在 iOS **kABPersonDepartmentProperty**欄位中。
+* **department**： 部分支援。第一部門名稱存儲在 iOS **kABPersonDepartmentProperty**欄位中。
-* **標題**： 部分支援。第一個標題存儲在 iOS **kABPersonJobTitleProperty**欄位中。
+* **title**： 部分支援。第一個標題存儲在 iOS **kABPersonJobTitleProperty**欄位中。
### Windows 的怪癖
-* **究竟**: 不受支援，返回`false`.
+* **pref**: 不受支援，返回`false`.
-* **類型**： 不受支援，返回`null`.
\ No newline at end of file
+* **type**： 不受支援，返回`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
[2/2] cordova-plugin-contacts git commit: CB-8438
cordova-plugin-contacts documentation translation: cordova-plugin-contacts
Posted by vi...@apache.org.
CB-8438 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/293c8b3f
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/tree/293c8b3f
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/diff/293c8b3f
Branch: refs/heads/master
Commit: 293c8b3f8f3be1f61b9207cc4e3acd1c0cc9ede3
Parents: c40de8a
Author: Victor Sosa <vi...@apache.org>
Authored: Fri Feb 27 12:47:49 2015 -0600
Committer: Victor Sosa <vi...@apache.org>
Committed: Fri Feb 27 12:47:49 2015 -0600
----------------------------------------------------------------------
doc/de/index.md | 76 ++++++++-------
doc/es/index.md | 207 ++++++++++++++-------------------------
doc/fr/index.md | 205 ++++++++++++++------------------------
doc/it/index.md | 68 +++++++------
doc/ja/index.md | 66 +++++++------
doc/ko/index.md | 64 ++++++------
doc/pl/index.md | 62 +++++++-----
doc/zh/index.md | 270 ++++++++++++++++++++++++++-------------------------
8 files changed, 482 insertions(+), 536 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/293c8b3f/doc/de/index.md
----------------------------------------------------------------------
diff --git a/doc/de/index.md b/doc/de/index.md
index 756ed8a..6321c9e 100644
--- a/doc/de/index.md
+++ b/doc/de/index.md
@@ -19,9 +19,17 @@
# org.apache.cordova.contacts
-Ermöglicht den Zugriff auf die Kontaktdatenbank Gerät.
+Dieses Plugin definiert eine globale `navigator.contacts`-Objekt bietet Zugriff auf die Geräte-Kontakte-Datenbank.
-**Warnung**: Erhebung und Nutzung von Kontaktdaten löst wichtige Datenschutzprobleme. Ihre app-Datenschutzerklärung sollten besprechen, wie die app Kontaktdaten verwendet und ob es mit irgendwelchen anderen Parteien geteilt wird. Kontaktinformationen ist als vertraulich angesehen, weil es die Menschen zeigt, mit denen eine Person kommuniziert. Daher neben der app-Privacy Policy sollten stark Sie Bereitstellung einer just-in-Time-Bekanntmachung, bevor die app zugreift oder Kontaktdaten verwendet, wenn das Betriebssystem des Geräts bereits tun nicht. Diese Benachrichtigung sollte der gleichen Informationen, die vorstehend, sowie die Zustimmung des Benutzers (z.B. durch Präsentation Entscheidungen für das **OK** und **Nein danke**). Beachten Sie, dass einige app-Marktplätze die app eine Frist eine just-in-Time und erhalten die Erlaubnis des Benutzers vor dem Zugriff auf Kontaktdaten verlangen können. Eine klare und leicht verständliche Benutzererfahrung rund um die Verwendung d
er Kontakt-Daten Benutzer Verwirrung zu vermeiden können und wahrgenommene Missbrauch der Kontaktdaten. Weitere Informationen finden Sie in der Datenschutz-Guide.
+Obwohl das Objekt mit der globalen Gültigkeitsbereich `navigator` verbunden ist, steht es nicht bis nach dem `Deviceready`-Ereignis.
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+ function onDeviceReady() {
+ console.log(navigator.contacts);
+ }
+
+
+**Warnung**: Erhebung und Nutzung von Kontaktdaten löst wichtige Datenschutzprobleme. Ihre app-Datenschutzerklärung sollten besprechen, wie die app Kontaktdaten verwendet und ob es mit irgendwelchen anderen Parteien geteilt wird. Kontaktinformationen ist als vertraulich angesehen, weil es die Menschen zeigt, mit denen eine Person kommuniziert. Daher neben der app-Privacy Policy sollten stark Sie Bereitstellung eine just-in-Time-Bekanntmachung, bevor die app zugreift oder Kontaktdaten verwendet, wenn Betriebssystem des Geräts nicht dies bereits tun. Diese Benachrichtigung sollte der gleichen Informationen, die vorstehend, sowie die Zustimmung des Benutzers (z.B. durch Präsentation Entscheidungen für das **OK** und **Nein danke**). Beachten Sie, dass einige app-Marktplätze die app eine Frist eine just-in-Time und erhalten die Erlaubnis des Benutzers vor dem Zugriff auf Kontaktdaten verlangen können. Eine klare und leicht verständliche Benutzererfahrung rund um die Verwendung d
er Kontakt-Daten Benutzer Verwirrung zu vermeiden können und wahrgenommene Missbrauch der Kontaktdaten. Weitere Informationen finden Sie in der Datenschutz-Guide.
## Installation
@@ -30,7 +38,7 @@ Ermöglicht den Zugriff auf die Kontaktdatenbank Gerät.
### Firefox OS Macken
-Erstellen Sie **www/manifest.webapp** , wie in [Docs Manifest][1]beschrieben. Fügen Sie die entsprechenden Permisions. Es muss auch die Webapp um "privilegierte" - [Manifest Docs][2]ändern. **Warnung**: alle privilegierten apps [Content Security Policy][3] , welche Inlineskript verbietet zu erzwingen. Initialisieren Sie die Anwendung auf andere Weise.
+Erstellen Sie **www/manifest.webapp**, wie in [Docs Manifest][1] beschrieben. Fügen Sie die entsprechenden Permisions. Es muss auch die Webapp um "privileged" - [Manifest Docs][2] ändern. **Warnung**: alle privilegierten apps [Content Security Policy][3], welche Inlineskript verbietet zu erzwingen. Initialisieren Sie die Anwendung auf andere Weise.
[1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
[2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
@@ -47,7 +55,7 @@ Erstellen Sie **www/manifest.webapp** , wie in [Docs Manifest][1]beschrieben. F
### Windows-Eigenheiten
-Alle Kontakte von zurückgegebenen `find` und `pickContact` Methoden sind schreibgeschützt, so dass sie von die Anwendung nicht geändert werden kann. `find`Methode nur auf Windows Phone 8.1-Geräten verfügbar.
+Keine Kontakte von `find` und `pickContact`-Methoden zurückgegebenen sind schreibgeschützt, so die Anwendung geändert werden kann. `find`-Methode nur auf Windows Phone 8.1-Geräten verfügbar.
### Windows 8 Macken
@@ -74,9 +82,9 @@ Windows 8 Kontakte sind Readonly. Über die Cordova-API-Kontakte nicht abgefragt
## Navigator.Contacts.Create
-Die `navigator.contacts.create` Methode ist synchron und gibt eine neue `Contact` Objekt.
+Die `navigator.contacts.create`-Methode ist synchron und gibt ein neues `Contact` objekt.
-Diese Methode behält nicht das Kontakt-Objekt in der Gerät-Kontakte-Datenbank, wofür Sie aufrufen müssen der `Contact.save` Methode.
+Diese Methode behält nicht das Kontakt-Objekt in der Gerät-Kontakte-Datenbank, für die Sie benötigen, um die `Contact.save`-Methode aufzurufen.
### Unterstützte Plattformen
@@ -93,27 +101,29 @@ Diese Methode behält nicht das Kontakt-Objekt in der Gerät-Kontakte-Datenbank,
## navigator.contacts.find
-Die `navigator.contacts.find` Methode wird asynchron ausgeführt, Abfragen der Gerät-Kontakte-Datenbank und gibt ein Array von `Contact` Objekten. Die resultierenden Objekte werden an übergeben die `contactSuccess` Callback-Funktion, die durch den **ContactSuccess** -Parameter angegeben.
+Die `navigator.contacts.find`-Methode führt asynchron, Abfragen der Gerät-Kontakte-Datenbank und gibt ein Array von `Contact`-Objekte. Die resultierenden Objekte werden an die durch den **contactSuccess**-Parameter angegebenen `contactSuccess`-Callback-Funktion übergeben.
-Der **ContactFields** -Parameter gibt die Felder als Qualifizierer Suche verwendet werden. Ein leere **ContactFields** -Parameter ist ungültig und führt zu `ContactError.INVALID_ARGUMENT_ERROR` . **ContactFields** der Wert `"*"` gibt alle Kontaktfelder.
+Der **contactFields**-Parameter gibt die Felder als Qualifizierer Suche verwendet werden. Ein leere **contactFields**-Parameter ist ungültig und führt zu `ContactError.INVALID_ARGUMENT_ERROR`. **contactFields** Wert `"*"` sucht alle Kontaktfelder.
-Die **contactFindOptions.filter** -Zeichenfolge kann als einen Suchfilter verwendet, wenn die Kontaktdatenbank Abfragen. Wenn angeboten, ein groß-und Kleinschreibung, wird jedes Feld in der **ContactFields** -Parameter angegebenen Teilwert Übereinstimmung. Wenn eine Übereinstimmung für *alle* angegebenen Felder vorliegt, wird der Kontakt zurückgegeben. Verwendung **contactFindOptions.desiredFields** Parameter steuern, welche Eigenschaften kontaktieren muss wieder zurückgegeben werden.
+Die **contactFindOptions.filter**-Zeichenfolge kann als einen Suchfilter verwendet, wenn die Kontaktdatenbank Abfragen. Wenn angeboten, ein groß-und Kleinschreibung, wird jedes Feld in der **contactFields**-Parameter angegebenen Teilwert Übereinstimmung. Wenn eine Übereinstimmung für *alle* angegebenen Felder vorliegt, wird der Kontakt zurückgegeben. Verwendung **contactFindOptions.desiredFields** Parameter steuern, welche Eigenschaften kontaktieren muss wieder zurückgegeben werden.
### Parameter
-* **ContactSuccess**: Erfolg-Callback-Funktion aufgerufen, die mit dem Array von Contact-Objekte aus der Datenbank zurückgegeben. [Erforderlich]
-
-* **ContactError**: Fehler-Callback-Funktion wird aufgerufen, wenn ein Fehler auftritt. [Optional]
+* **contactFields**: Kontaktfelder als Qualifizierer Suche verwenden. *(DOMString[])* [Required]
-* **ContactFields**: Kontaktfelder als Qualifizierer Suche verwenden. *(DOMString[])* [Erforderlich]
+* **contactSuccess**: Erfolg-Callback-Funktion aufgerufen, die mit dem Array von Contact-Objekte aus der Datenbank zurückgegeben. [Required]
-* **ContactFindOptions**: Optionen zum Filtern von navigator.contacts zu suchen. [Optional] Schlüssel enthalten:
+* **contactError**: Fehler-Callback-Funktion wird aufgerufen, wenn ein Fehler auftritt.[Optional]
-* **Filter**: die zu suchende Zeichenfolge verwendet, um navigator.contacts zu finden. *(DOM-String und enthält)* (Standard:`""`)
-
-* **mehrere**: bestimmt, ob der Suchvorgang mehrere navigator.contacts gibt. *(Boolesch)* (Standard:`false`)
+* **contactFindOptions**: Optionen zum Filtern von navigator.contacts zu suchen. [Optional]
+
+ Schlüssel enthalten:
+
+ * **filter**: die zu suchende Zeichenfolge verwendet, um navigator.contacts zu finden. *(DOM-String und enthält)* (Standard: `""`)
- * **DesiredFields**: Kontaktfelder wieder zurückgegeben werden. Wenn angegeben, die sich daraus ergebende `Contact` Objekt verfügt nur über Werte für diese Felder. *(DOMString[])* [Optional]
+ * **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
@@ -149,7 +159,7 @@ Die **contactFindOptions.filter** -Zeichenfolge kann als einen Suchfilter verwen
## navigator.contacts.pickContact
-Die `navigator.contacts.pickContact` -Methode startet im Kontakt Farbwähler wählen Sie einen einzigen Ansprechpartner. Das resultierende Objekt wird übergeben, um die `contactSuccess` Callback-Funktion, die durch den **ContactSuccess** -Parameter angegeben.
+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
@@ -176,7 +186,7 @@ Die `navigator.contacts.pickContact` -Methode startet im Kontakt Farbwähler wä
## Kontakt
-Das `Contact` -Objekt repräsentiert einen Benutzer Kontakt. Kontakte können erstellt, gespeichert oder aus der Gerät-Kontakte-Datenbank entfernt werden. Kontakte können auch abgerufen werden (einzeln oder als Gruppe) aus der Datenbank durch den Aufruf der `navigator.contacts.find` Methode.
+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.
@@ -212,11 +222,11 @@ Das `Contact` -Objekt repräsentiert einen Benutzer Kontakt. Kontakte können er
### Methoden
-* **Klon**: gibt eine neue `Contact` Objekt, das eine tiefe Kopie des aufrufenden Objekts, mit der `id` -Eigenschaft festgelegt`null`.
+* **clone**: gibt eine neue `Contact` Objekt, das eine tiefe Kopie des aufrufenden Objekts, mit der `id` -Eigenschaft festgelegt`null`.
-* **Entfernen**: entfernt den Kontakt aus der Gerät-Kontakte-Datenbank, ansonsten führt eine Fehler-Callback mit einem `ContactError` Objekt.
+* **remove**: entfernt den Kontakt aus der Gerät-Kontakte-Datenbank, ansonsten führt eine Fehler-Callback mit einem `ContactError` Objekt.
-* **Speichern**: speichert einen neuen Kontakt in der Gerätedatenbank Kontakte, oder einen vorhandenen Kontakt aktualisiert, wenn ein Kontakt mit der gleichen **Id** bereits vorhanden ist.
+* **save**: speichert einen neuen Kontakt in der Gerätedatenbank Kontakte, oder einen vorhandenen Kontakt aktualisiert, wenn ein Kontakt mit der gleichen **Id** bereits vorhanden ist.
### Unterstützte Plattformen
@@ -335,7 +345,7 @@ Das `Contact` -Objekt repräsentiert einen Benutzer Kontakt. Kontakte können er
## ContactAddress
-Das `ContactAddress` -Objekt speichert die Eigenschaften einer einzelnen Adresse eines Kontakts. A `Contact` Objekt gehören mehr als eine Adresse in ein `ContactAddress[]` Array.
+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
@@ -438,7 +448,7 @@ Das `ContactAddress` -Objekt speichert die Eigenschaften einer einzelnen Adresse
## ContactError
-Das `ContactError` -Objekt wird zurückgegeben, die der Benutzer über die `contactError` Callback-Funktion, wenn ein Fehler auftritt.
+Das `ContactError`-Objekt wird dem Benutzer über die `contactError`-Callback-Funktion zurückgegeben, wenn ein Fehler auftritt.
### Eigenschaften
@@ -456,17 +466,17 @@ Das `ContactError` -Objekt wird zurückgegeben, die der Benutzer über die `cont
## ContactField
-Das `ContactField` -Objekt ist eine wieder verwendbare Komponenten stellt Felder generisch kontaktieren. Jeder `ContactField` -Objekt enthält eine `value` , `type` , und `pref` Eigenschaft. A `Contact` -Objekt speichert mehrere Eigenschaften in `ContactField[]` -Arrays, wie Telefon-Nummern und e-Mail-Adressen.
+Das `ContactField`-Objekt ist eine wieder verwendbare Komponenten stellt Felder generisch kontaktieren. Jedes `ContactField`-Objekt enthält eine Eigenschaft `value`, `type` und `pref`. Ein `Contact`-Objekt speichert mehrere Eigenschaften in `ContactField []`-Arrays, wie Telefonnummern und e-Mail-Adressen.
-In den meisten Fällen gibt es keine vorher festgelegten Werte für ein `ContactField` **Typ** -Attribut des Objekts. Beispielsweise kann eine Telefonnummer angeben **Typwerte von *Zuhause*, *arbeiten*, *mobile*, *iPhone*oder ein beliebiger anderer Wert, der von einem bestimmten Geräteplattform Kontaktdatenbank unterstützt wird** . Jedoch für die `Contact` **Fotos** Feld, das **Typ** -Feld gibt das Format des zurückgegebenen Bild: **Url** wenn das **Value** -Attribut eine URL zu dem Foto Bild oder *base64* , enthält Wenn der **Wert** eine base64-codierte Bild-Zeichenfolge enthält.
+In den meisten Fällen gibt es keine vorher festgelegten Werte für ein `ContactField`-Objekt-**Type**-Attribut. Beispielsweise kann eine Telefonnummer angeben **type** werte von *home*, *work*, *mobile*, *iPhone* oder ein beliebiger anderer Wert, der von einem bestimmten Geräteplattform Kontaktdatenbank unterstützt wird. Jedoch für die `Contact`-**photos**-Feld, das **type**-Feld gibt das Format des zurückgegebenen Bild: **url** Wenn das **value**-Attribut eine URL zu dem Foto Bild oder *base64*, enthält Wenn der **Wert** eine base64-codierte Bild-Zeichenfolge enthält.
### Eigenschaften
-* **Typ**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. *(DOM-String und enthält)*
+* **type**: eine Zeichenfolge, die angibt, welche Art von Feld in diesem *Hause* zum Beispiel. *(DOM-String und enthält)*
-* **Wert**: der Wert des Feldes, wie z. B. eine Telefonnummer oder e-Mail-Adresse. *(DOM-String und enthält)*
+* **value**: der Wert des Feldes, wie z. B. eine Telefonnummer oder e-Mail-Adresse. *(DOM-String und enthält)*
-* **Pref**: Legen Sie auf `true` Wenn dieses `ContactField` des Benutzers bevorzugten Wert enthält. *(boolesch)*
+* **pref**: Legen Sie auf `true` Wenn dieses `ContactField` des Benutzers bevorzugten Wert enthält. *(boolesch)*
### Unterstützte Plattformen
@@ -521,7 +531,7 @@ In den meisten Fällen gibt es keine vorher festgelegten Werte für ein `Contact
## ContactName
-Enthält verschiedene Arten von Informationen über ein `Contact` Name des Objekts.
+Enthält verschiedene Arten von Informationen über `ein Kontaktobjekt` Namen.
### Eigenschaften
@@ -540,7 +550,7 @@ Enthält verschiedene Arten von Informationen über ein `Contact` Name des Objek
### Unterstützte Plattformen
* Amazon Fire OS
-* Android 2.X
+* Android
* BlackBerry 10
* Firefox OS
* iOS
@@ -617,7 +627,7 @@ Enthält verschiedene Arten von Informationen über ein `Contact` Name des Objek
## ContactOrganization
-Das `ContactOrganization` -Objekt speichert Organisationseigenschaften eines Kontakts. A `Contact` -Objekt speichert eine oder mehrere `ContactOrganization` Objekte in einem Array.
+Das `ContactOrganization`-Objekt speichert Organisationseigenschaften eines Kontakts. Ein `Contact` objekt werden ein oder mehrere `ContactOrganization`-Objekte in einem Array gespeichert.
### Eigenschaften
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/293c8b3f/doc/es/index.md
----------------------------------------------------------------------
diff --git a/doc/es/index.md b/doc/es/index.md
index 4c70b48..93b58cd 100644
--- a/doc/es/index.md
+++ b/doc/es/index.md
@@ -19,13 +19,19 @@
# org.apache.cordova.contacts
-Proporciona acceso a la base de datos de contactos de dispositivo.
+Este plugin define un global `navigator.contacts` objeto que proporciona acceso a la base de datos de contactos de dispositivo.
-**ADVERTENCIA**: recopilación y uso de datos plantea cuestiones de privacidad importante. Política de privacidad de su aplicación debe discutir cómo la aplicación utiliza datos de contacto y si es compartida con terceros. Información de contacto se considera sensible porque revela la gente con quien se comunica una persona. Por lo tanto, además de política de privacidad de la app, fuertemente considere dar un aviso de just-in-time antes de la aplicación accede a ellos o utiliza los datos de contacto, si el sistema operativo del dispositivo no hacerlo ya. Que el aviso debe proporcionar la misma información mencionada, además de obtener un permiso del usuario (por ejemplo, presentando opciones para **Aceptar** y **No gracias**). Tenga en cuenta que algunos mercados de aplicación podrán exigir la aplicación para proporcionar un aviso de just-in-time y obtener el permiso del usuario antes de acceder a datos de contacto. Una experiencia de usuario clara y fácil de entender
que rodean el uso de contacto datos ayuda a evitar la confusión del usuario y percibe uso indebido de los datos de contacto. Para obtener más información, consulte a la guía de privacidad.
+Aunque el objeto está unido al ámbito global `navigator` , no estará disponible hasta después de la `deviceready` evento.
+
+ document.addEventListener ("deviceready", onDeviceReady, false);
+ function onDeviceReady() {console.log(navigator.contacts)};
+
+
+**ADVERTENCIA**: recopilación y uso de datos plantea cuestiones de privacidad importante. Política de privacidad de su aplicación debe discutir cómo la aplicación utiliza datos de contacto y si es compartida con terceros. Información de contacto se considera sensible porque revela la gente con quien se comunica una persona. Por lo tanto, además de política de privacidad de la app, fuertemente considere dar un aviso de just-in-time antes de la aplicación accede a ellos o utiliza los datos de contacto, si el sistema operativo del dispositivo no hacerlo ya. Que el aviso debe proporcionar la misma información mencionada, además de obtener un permiso del usuario (por ejemplo, presentando opciones para **Aceptar** y **No gracias**). Tenga en cuenta que algunos mercados de aplicación podrán exigir la aplicación para proporcionar un aviso de just-in-time y obtener el permiso del usuario antes de acceder a datos de contacto. Una experiencia de usuario clara y fácil de entender
que rodean el uso de contacto datos ayuda a evitar la confusión del usuario y percibe uso indebido de los datos de contacto. Para obtener más información, por favor consulte a la guía de privacidad.
## Instalación
- cordova plugin add org.apache.cordova.contacts
+ Cordova plugin agregar org.apache.cordova.contacts
### Firefox OS rarezas
@@ -36,18 +42,12 @@ Crear **www/manifest.webapp** como se describe en [Manifestar Docs][1]. Agregar
[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"
- }
- }
+ "tipo": "el privilegio", "permisos": {"contactos": {"acceso": "readwrite", "Descripción": "describir por qué hay una necesidad de tal autorización"}}
### Windows rarezas
-Cualquier contacto regresado de `find` y `pickContact` los métodos son readonly, así que su aplicación no puede modificarlos. `find`método disponible sólo en dispositivos Windows Phone 8.1.
+Cualquier contacto regresado de `find` y `pickContact` métodos son readonly, por lo que su aplicación no puede modificarlos. `find`método disponible sólo en dispositivos Windows Phone 8.1.
### Rarezas de Windows 8
@@ -76,7 +76,7 @@ Windows 8 contactos son de sólo lectura. Través de los contactos de la API de
El `navigator.contacts.create` método es sincrónico y devuelve una nueva `Contact` objeto.
-Este método no retener el objeto de contacto en la base de contactos de dispositivo, para lo cual necesitas invocar el método `Contact.save`.
+Este método no retiene el objeto de contacto en la base de contactos de dispositivo, para lo cual necesita invocar el `Contact.save` método.
### Plataformas soportadas
@@ -88,32 +88,34 @@ Este método no retener el objeto de contacto en la base de contactos de disposi
### Ejemplo
- var myContact = navigator.contacts.create({"displayName": "Test User"});
+ 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 función de callback `contactSuccess` especificada por el parámetro **contactSuccess**.
+El `navigator.contacts.find` método se ejecuta asincrónicamente, consultando la base de datos de contactos de dispositivo y devolver una matriz de `Contact` objetos. Los objetos resultantes son pasados a la `contactSuccess` función de devolución de llamada especificada por el parámetro **contactSuccess** .
-El parámetro **contactFields** especifica los campos para ser utilizado como un calificador de búsqueda. Un parámetro de longitud cero **contactFields** no es válido y resultados en `ContactError.INVALID_ARGUMENT_ERROR` . Un valor de **contactFields** de `"*"` devuelve todo contacto con campos.
+El parámetro **contactFields** especifica los campos para ser utilizado como un calificador de búsqueda. Un parámetro de longitud cero **contactFields** no es válido y resultados en `ContactError.INVALID_ARGUMENT_ERROR` . Un valor de **contactFields** de `"*"` busca campos todo contactos.
-La cadena de **contactFindOptions.filter** puede ser usada como un filtro de búsqueda al consultar la base de datos de contactos. Si proporciona, mayúsculas y minúsculas, coincidencia parcial valor se aplica a cada campo especificado en el parámetro **contactFields**. Si hay un partido para *cualquier* de los campos especificados, se devuelve el contacto. Uso **contactFindOptions.desiredFields** parámetro al control que Contacta con propiedades debe devolverse atrás.
+La cadena de **contactFindOptions.filter** puede ser usada como un filtro de búsqueda al consultar la base de datos de contactos. Si proporciona, una entre mayúsculas y minúsculas, coincidencia parcial valor se aplica a cada campo especificado en el parámetro **contactFields** . Si hay un partido para *cualquier* de los campos especificados, se devuelve el contacto. Uso **contactFindOptions.desiredFields** parámetro al control que Contacta con propiedades debe devolverse atrás.
### Parámetros
-* **contactSuccess**: función de callback de éxito se invoca con la matriz de objetos contacto devueltos desde la base de datos. [Obligatorio]
-
-* **contactError**: función de callback de Error, se invoca cuando se produce un error. [Opcional]
+* **contactFields**: póngase en contacto con campos para usar como un calificador de búsqueda. *(DOMString[])* [Required]
-* **contactFields**: póngase en contacto con campos para usar como un calificador de búsqueda. *(DOMString[])* [Obligatorio]
+* **contactSuccess**: función de callback de éxito se invoca con la matriz de objetos contacto devueltos desde la base de datos. [Required]
-* **contactFindOptions**: buscar opciones para filtrar navigator.contacts. [Opcional] Claves incluyen:
+* **contactError**: función de callback de Error, se invoca cuando se produce un error. [Optional]
-* **filtro**: la cadena de búsqueda utilizada para encontrar navigator.contacts. *(DOMString)* (Por defecto:`""`)
-
-* **múltiples**: determina si la operación de búsqueda devuelve múltiples navigator.contacts. *(Booleano)* (Por defecto:`false`)
+* **contactFindOptions**: buscar opciones para filtrar navigator.contacts. [Optional]
+
+ Claves incluyen:
+
+ * **filtro**: la cadena de búsqueda utilizada para encontrar navigator.contacts. *(DOMString)* (Por defecto:`""`)
- * **desiredFields**: póngase en contacto con campos para volver atrás. Si se especifica, la resultante `Contact` objeto sólo cuenta con los valores de estos campos. *(DOMString[])* [Opcional]
+ * **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
@@ -126,21 +128,16 @@ La cadena de **contactFindOptions.filter** puede ser usada como un filtro de bú
### Ejemplo
- function onSuccess(contacts) {
- alert('Found ' + contacts.length + ' contacts.');
- };
+ function onSuccess(contacts) {alert ('Encontrados' + contacts.length + 'contactos de.');};
- function onError(contactError) {
- alert('onError!');
- };
+ function onError(contactError) {alert('onError!');};
- // find all contacts with 'Bob' in any name field
- var options = new ContactFindOptions();
- options.filter = "Bob";
- options.multiple = true;
+ encuentra todos los contactos con 'Bob' en cualquier nombre campo var opciones = new ContactFindOptions();
+ options.Filter = "Bob";
+ options.Multiple = true;
options.desiredFields = [navigator.contacts.fieldType.id];
- var fields = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
- navigator.contacts.find(fields, onSuccess, onError, options);
+ campos var = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
+ Navigator.contacts.Find (campos, onSuccess, onError, opciones);
### Windows rarezas
@@ -167,10 +164,8 @@ El `navigator.contacts.pickContact` método lanza el selector para seleccionar u
### Ejemplo
- navigator.contacts.pickContact(function(contact){
- console.log('The following contact has been selected:' + JSON.stringify(contact));
- },function(err){
- console.log('Error: ' + err);
+ navigator.contacts.pickContact(function(contact) {console.log (' se ha seleccionado el siguiente contacto: "+ JSON.stringify(contact));
+ }, function(err) {console.log ('Error: ' + err);
});
@@ -231,50 +226,35 @@ El `Contact` objeto representa el contacto de un usuario. Contactos pueden ser c
### Salvar ejemplo
- function onSuccess(contact) {
- alert("Save Success");
- };
-
- function onError(contactError) {
- alert("Error = " + contactError.code);
- };
+ function onSuccess(contact) {alert ("salvar con éxito");};
- // create a new contact object
- var contact = navigator.contacts.create();
- contact.displayName = "Plumber";
- contact.nickname = "Plumber"; // specify both to support all devices
+ function onError(contactError) {alert ("Error =" + contactError.code);};
- // populate some fields
- var name = new ContactName();
+ crear un nuevo objeto contacto var contacto = navigator.contacts.create();
+ contact.displayName = "Plomero";
+ Contact.nickname = "Plomero"; especificar tanto para todos los dispositivos de apoyo / / rellenar algún nombre var campos = new ContactName();
name.givenName = "Jane";
name.familyName = "Doe";
- contact.name = name;
+ Contact.name = nombre;
- // save to device
- contact.save(onSuccess,onError);
+ guardar en el dispositivo contact.save(onSuccess,onError);
### Ejemplo de clon
- // clone the contact object
- var clone = contact.clone();
+ clon del clon de contacto objeto var = contact.clone();
clone.name.givenName = "John";
- console.log("Original contact name = " + contact.name.givenName);
- console.log("Cloned contact name = " + clone.name.givenName);
+ Console.log ("contacto Original nombre =" + contact.name.givenName);
+ Console.log ("Cloned contacto nombre =" + clone.name.givenName);
### Quitar ejemplo
- function onSuccess() {
- alert("Removal Success");
- };
+ function onSuccess() {alert ("retiro el éxito");};
- function onError(contactError) {
- alert("Error = " + contactError.code);
- };
+ function onError(contactError) {alert ("Error =" + contactError.code);};
- // remove the contact from the device
- contact.remove(onSuccess,onError);
+ quitar el contacto de la contact.remove(onSuccess,onError) del dispositivo;
### Rarezas Android 2.X
@@ -335,7 +315,7 @@ El `Contact` objeto representa el contacto de un usuario. Contactos pueden ser c
## ContactAddress
-El objeto `ContactAddress` almacena las propiedades de una única dirección de un contacto. Un objeto de `Contact` puede incluir más de una dirección en un array `ContactAddress[]`.
+El `ContactAddress` objeto almacena las propiedades de una única dirección de un contacto. A `Contact` objeto puede incluir más de una dirección en un `ContactAddress[]` matriz.
### Propiedades
@@ -368,32 +348,17 @@ El objeto `ContactAddress` almacena las propiedades de una única dirección de
### 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);
+ Mostrar la información de dirección para el funcionan de todos los contactos onSuccess(contacts) {para (var = 0; < contacts.length; i ++) {para (var j = 0; j < contacts[i].addresses.length; j ++) {alert ("Pref:" + contacts[i].addresses[j].pref + "\n" + "tipo:" + contacts[i].addresses[j].type + "\n" + "formato:" + contacts[i].addresses[j].formatted + "\n" + "dirección: "+ contacts[i].addresses[j].streetAddress +"\n"+" localidad: "+ contacts[i].addresses[j].locality +"\n"+" región: "+ contacts[i].addresses[j].region +"\n"+" Código Postal: "+ contacts[i].addresses[j].postalCode +"\n"+" país: "+ contacts[i].addresses[j].country);
}
}
};
- function onError(contactError) {
- alert('onError!');
- };
+ function onError(contactError) {alert('onError!');};
- // find all contacts
- var options = new ContactFindOptions();
- options.filter = "";
- var filter = ["displayName", "addresses"];
- navigator.contacts.find(filter, onSuccess, onError, options);
+ encontrar todos los contactos var opciones = new ContactFindOptions();
+ options.Filter = "";
+ filtro var = ["displayName", "direcciones"];
+ Navigator.contacts.Find (filtro, onSuccess, onError, opciones);
### Rarezas Android 2.X
@@ -481,18 +446,14 @@ En la mayoría de los casos, no existen previamente determinados valores para un
### Ejemplo
- // create a new contact
- var contact = navigator.contacts.create();
+ crear un nuevo contacto contacto var = navigator.contacts.create();
- // store contact phone numbers in ContactField[]
- var phoneNumbers = [];
- phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
- phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
- phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
- contact.phoneNumbers = phoneNumbers;
+ almacenar números de teléfono de contacto en números de var ContactField [] = [];
+ phoneNumbers[0] = new ContactField ('trabajo', ' 212-555-1234', false);
+ phoneNumbers[1] = new ContactField ('móviles', ' 917-555-5432', true); recomendado: número phoneNumbers[2] = new ContactField ('home', ' 203-555-7890', false);
+ contact.phoneNumbers = números;
- // save the contact
- contact.save();
+ guardar el contacto contact.save();
### Rarezas Android
@@ -540,7 +501,7 @@ Contiene diferentes tipos de información sobre un `Contact` nombre del objeto.
### Plataformas soportadas
* Amazon fire OS
-* Android 2.X
+* Android
* BlackBerry 10
* Firefox OS
* iOS
@@ -550,25 +511,16 @@ Contiene diferentes tipos de información sobre un `Contact` nombre del objeto.
### 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);
+ función onSuccess(contacts) {para (var = 0; < contacts.length; i ++) {alert ("formateada:" + contacts[i].name.formatted + "\n" + "Apellido:" + contacts[i].name.familyName + "\n" + "nombre:" + contacts[i].name.givenName + "\n" + "segundo nombre:" + contacts[i].name.middleName + "\n" + "sufijo:" + contacts[i].name.honorificSuffix + "\n" + "prefijo:" + contacts[i].name.honorificSuffix);
}
};
- function onError(contactError) {
- alert('onError!');
- };
+ function onError(contactError) {alert('onError!');};
- var options = new ContactFindOptions();
- options.filter = "";
- filter = ["displayName", "name"];
- navigator.contacts.find(filter, onSuccess, onError, options);
+ var opciones = new ContactFindOptions();
+ options.Filter = "";
+ filtro = ["displayName", "nombre"];
+ Navigator.contacts.Find (filtro, onSuccess, onError, opciones);
### Rarezas Android
@@ -642,26 +594,17 @@ El `ContactOrganization` objeto almacena las propiedades de organización de un
### 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 onSuccess(contacts) {para (var = 0; < contacts.length; i ++) {para (var j = 0; j < contacts[i].organizations.length; j ++) {alert ("Pref:" + contacts[i].organizations[j].pref + "\n" + "tipo:" + contacts[i].organizations[j].type + "\n" + "nombre:" + contacts[i].organizations[j].name + "\n" + "Departamento:" + contacts[i].organizations[j].department + "\n" + "título: "+ contacts[i].organizations[j].title);
}
}
};
- function onError(contactError) {
- alert('onError!');
- };
+ function onError(contactError) {alert('onError!');};
- var options = new ContactFindOptions();
- options.filter = "";
- filter = ["displayName", "organizations"];
- navigator.contacts.find(filter, onSuccess, onError, options);
+ var opciones = new ContactFindOptions();
+ options.Filter = "";
+ filtro = ["displayName", "organizaciones"];
+ Navigator.contacts.Find (filtro, onSuccess, onError, opciones);
### Rarezas Android 2.X
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/293c8b3f/doc/fr/index.md
----------------------------------------------------------------------
diff --git a/doc/fr/index.md b/doc/fr/index.md
index d10d6f9..fe06cf5 100644
--- a/doc/fr/index.md
+++ b/doc/fr/index.md
@@ -19,13 +19,19 @@
# org.apache.cordova.contacts
-Donne accès à la base de données de contacts de dispositif.
+Ce plugin définit un global `navigator.contacts` objet, ce qui permet d'accéder à la base de données de contacts de dispositif.
-**Avertissement**: collecte et utilisation des données de contact soulève des questions importantes de la vie privée. La politique de confidentialité de votre application doit examiner comment l'application utilise les données de contact et si elles sont partagées avec d'autres parties. Les information de contact sont considérés comme sensibles parce qu'elles révèlent les gens avec lesquels une personne communique. Par conséquent, en plus de la politique de confidentialité de l'application, vous devez envisager fortement fournissant un avis juste-à-temps, avant que l'application accède ou utilise des données de contact, si le système d'exploitation de périphérique ne fait donc pas déjà. Cet avis doit fournir les mêmes renseignements mentionnés précédemment, ainsi qu'obtenir l'autorisation de l'utilisateur (par exemple, en présentant des choix **OK** et **Non merci**). Notez que certains marchés app peuvent exiger l'application de fournir un avis juste-à-te
mps et obtenir la permission de l'utilisateur avant d'accéder à des données de contact. Une expérience utilisateur claire et facile à comprendre qui entourent l'utilisation de données permettent d'éviter la confusion des utilisateurs de contact et une utilisation jugée abusive des données de contact. Pour plus d'informations, consultez le Guide de la vie privée.
+Bien que l'objet est attaché à la portée globale `navigator` , il n'est pas disponible jusqu'après la `deviceready` événement.
+
+ document.addEventListener (« deviceready », onDeviceReady, false) ;
+ function onDeviceReady() {console.log(navigator.contacts);}
+
+
+**Avertissement**: collecte et utilisation des données de contact soulève des questions importantes de la vie privée. Politique de confidentialité de votre application doit examiner comment l'application utilise les données de contact et si il est partagé avec d'autres parties. Information de contact est considéré comme sensible parce qu'il révèle les gens avec lesquels une personne communique. Par conséquent, en plus de la politique de confidentialité de l'application, vous devez envisager fortement fournissant un avis juste-à-temps, avant que l'application accède ou utilise des données de contact, si le système d'exploitation de périphérique ne fait donc pas déjà. Cet avis doit fournir les mêmes renseignements susmentionnées, ainsi que d'obtenir l'autorisation de l'utilisateur (par exemple, en présentant des choix **OK** et **Non merci**). Notez que certains marchés app peuvent exiger l'application de fournir un avis juste-à-temps et obtenir la permission
de l'utilisateur avant d'accéder à des données de contact. Une expérience utilisateur claire et facile à comprendre qui entourent l'utilisation de données permettent d'éviter la confusion des utilisateurs de contact et une utilisation jugée abusive des données de contact. Pour plus d'informations, consultez le Guide de la vie privée.
## Installation
- cordova plugin add org.apache.cordova.contacts
+ Cordova plugin ajouter org.apache.cordova.contacts
### Firefox OS Quirks
@@ -36,13 +42,7 @@ Créez **www/manifest.webapp** comme décrit dans [Les Docs manifeste][1]. Ajout
[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"
- }
- }
+ « type »: "le privilège", "autorisations": {« contacts »: {« accès »: "readwrite", "description": "décrire pourquoi il est nécessaire pour obtenir cette permission"}}
### Bizarreries de Windows
@@ -88,32 +88,34 @@ Cette méthode ne conserve pas l'objet de Contact dans la base de données des c
### Exemple
- var myContact = navigator.contacts.create({"displayName": "Test User"});
+ 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 `"*"` retourne les champs de tout contact.
+Le paramètre **contactFields** spécifie les champs à utiliser comme un qualificateur de recherche. Un paramètre de longueur nulle **contactFields** n'est pas valide et se traduit par `ContactError.INVALID_ARGUMENT_ERROR` . Une valeur de **contactFields** de `"*"` recherche dans les champs de tout contact.
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
-* **contactSuccess**: fonction de rappel de succès avec le tableau d'objets Contact appelée retournée par la base de données. [Obligatoire]
-
-* **contactError**: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Facultatif]
+* **contactFields**: communiquer avec les champs à utiliser comme un qualificateur de recherche. *(DOMString[])* [Required]
-* **contactFields**: communiquer avec les champs à utiliser comme un qualificateur de recherche. *(DOMString[])* [Obligatoire]
+* **contactSuccess**: fonction de rappel de succès avec le tableau d'objets Contact appelée retournée par la base de données. [Required]
-* **contactFindOptions**: recherche d'options pour filtrer navigator.contacts. [Facultatif] Clés incluent :
+* **contactError**: fonction de rappel d'erreur, appelée lorsqu'une erreur se produit. [Optional]
-* **filtre**: la chaîne de recherche utilisée pour trouver navigator.contacts. *(DOMString)* (Par défaut :`""`)
-
-* **multiples**: détermine si l'opération find retourne plusieurs navigator.contacts. *(Booléen)* (Par défaut :`false`)
+* **contactFindOptions**: recherche d'options pour filtrer navigator.contacts. [Optional]
+
+ Clés incluent :
+
+ * **filtre**: la chaîne de recherche utilisée pour trouver navigator.contacts. *(DOMString)* (Par défaut :`""`)
- * **desiredFields**: Contactez champs soit retourné en arrière. Si spécifié, l'entraînant `Contact` objet dispose seulement des valeurs de ces champs. *(DOMString[])* [Facultatif]
+ * **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 prises en charge
@@ -126,21 +128,16 @@ La chaîne **contactFindOptions.filter** peut servir comme un filtre de recherch
### Exemple
- function onSuccess(contacts) {
- alert('Found ' + contacts.length + ' contacts.');
- };
+ function onSuccess(contacts) {alert (« Found » + contacts.length + « contacts. »);} ;
- function onError(contactError) {
- alert('onError!');
- };
+ function onError(contactError) {alert('onError!');} ;
- // find all contacts with 'Bob' in any name field
- var options = new ContactFindOptions();
- options.filter = "Bob";
- options.multiple = true;
- options.desiredFields = [navigator.contacts.fieldType.id];
- var fields = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name];
- navigator.contacts.find(fields, onSuccess, onError, options);
+ trouver tous les contacts avec « Bob » dans toute option de var de champ nom = new ContactFindOptions() ;
+ options.Filter = « Bob » ;
+ options.multiple = true ;
+ options.desiredFields = [navigator.contacts.fieldType.id] ;
+ champs var = [navigator.contacts.fieldType.displayName, navigator.contacts.fieldType.name] ;
+ Navigator.contacts.Find (champs, onSuccess, onError, options) ;
### Bizarreries de Windows
@@ -167,10 +164,8 @@ La `navigator.contacts.pickContact` méthode lance le sélecteur de Contact pour
### Exemple
- navigator.contacts.pickContact(function(contact){
- console.log('The following contact has been selected:' + JSON.stringify(contact));
- },function(err){
- console.log('Error: ' + err);
+ navigator.contacts.pickContact(function(contact) {console.log ("le contact suivant a été retenu:" + JSON.stringify(contact)) ;
+ }, function(err) {console.log ("Error:" + err) ;
});
@@ -231,50 +226,35 @@ Le `Contact` objet représente le contact de l'utilisateur. Contacts peuvent êt
### Enregistrez l'exemple
- function onSuccess(contact) {
- alert("Save Success");
- };
-
- function onError(contactError) {
- alert("Error = " + contactError.code);
- };
+ function onSuccess(contact) {alert ("sauver succès");} ;
- // create a new contact object
- var contact = navigator.contacts.create();
- contact.displayName = "Plumber";
- contact.nickname = "Plumber"; // specify both to support all devices
+ function onError(contactError) {alert ("erreur =" + contactError.code);} ;
- // populate some fields
- var name = new ContactName();
- name.givenName = "Jane";
- name.familyName = "Doe";
- contact.name = name;
+ 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 ;
- // save to device
- contact.save(onSuccess,onError);
+ enregistrer dans contact.save(onSuccess,onError) de l'appareil ;
### Exemple de clone
- // clone the contact object
- var clone = contact.clone();
- clone.name.givenName = "John";
- console.log("Original contact name = " + contact.name.givenName);
- console.log("Cloned contact name = " + clone.name.givenName);
+ Clone clone objet contact var = contact.clone() ;
+ clone.name.givenName = « John » ;
+ Console.log ("contact Original nom =" + contact.name.givenName) ;
+ Console.log ("nom de contact clonés =" + clone.name.givenName) ;
### Supprimer l'exemple
- function onSuccess() {
- alert("Removal Success");
- };
+ fonction onSuccess() {alert ("succès");} ;
- function onError(contactError) {
- alert("Error = " + contactError.code);
- };
+ function onError(contactError) {alert ("erreur =" + contactError.code);} ;
- // remove the contact from the device
- contact.remove(onSuccess,onError);
+ supprimer le contact de l'appareil contact.remove(onSuccess,onError) ;
### Android 2.X Quirks
@@ -368,32 +348,17 @@ Le `ContactAddress` objet Stocke les propriétés d'une seule adresse d'un conta
### Exemple
- // display the address information for all contacts
-
- function onSuccess(contacts) {
- for (var i = 0; i < contacts.length; i++) {
- for (var j = 0; j < contacts[i].addresses.length; j++) {
- alert("Pref: " + contacts[i].addresses[j].pref + "\n" +
- "Type: " + contacts[i].addresses[j].type + "\n" +
- "Formatted: " + contacts[i].addresses[j].formatted + "\n" +
- "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
- "Locality: " + contacts[i].addresses[j].locality + "\n" +
- "Region: " + contacts[i].addresses[j].region + "\n" +
- "Postal Code: " + contacts[i].addresses[j].postalCode + "\n" +
- "Country: " + contacts[i].addresses[j].country);
+ Affichez les informations d'adresse pour tous les contacts fonctionnent onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {pour (var j = 0; j < contacts[i].addresses.length; j ++) {alert ("Pref:" + contacts[i].addresses[j].pref + « \n » + "Type:" + contacts[i].addresses[j].type + « \n » + "au format:" + contacts[i].addresses[j].formatted + « \n » + "adresse de rue: "+ contacts[i].addresses[j].streetAddress +"\n"+" localité: "+ contacts[i].addresses[j].locality +"\n"+" région: "+ contacts[i].addresses[j].region +"\n"+" Code Postal: "+ contacts[i].addresses[j].postalCode +"\n"+" pays: "+ contacts[i].addresses[j].country) ;
}
}
};
- function onError(contactError) {
- alert('onError!');
- };
+ function onError(contactError) {alert('onError!');} ;
- // find all contacts
- var options = new ContactFindOptions();
- options.filter = "";
- var filter = ["displayName", "addresses"];
- navigator.contacts.find(filter, onSuccess, onError, options);
+ trouver tous les contacts options var = new ContactFindOptions() ;
+ options.Filter = "" ;
+ filtre var = ["name", « adresses »] ;
+ Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
### Android 2.X Quirks
@@ -481,18 +446,14 @@ Dans la plupart des cas, il n'y a pas de valeurs prédéterminées pour une `Con
### Exemple
- // create a new contact
- var contact = navigator.contacts.create();
+ créer un nouveau contact contact var = navigator.contacts.create() ;
- // store contact phone numbers in ContactField[]
- var phoneNumbers = [];
- phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
- phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
- phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
- contact.phoneNumbers = phoneNumbers;
+ stocker des numéros de téléphone de contact en ContactField [] var phoneNumbers = [] ;
+ phoneNumbers[0] = new ContactField (« travail », ' 212-555-1234', false) ;
+ phoneNumbers[1] = new ContactField (« mobile », ' 917-555-5432', true) ; phoneNumbers[2] numéro préféré = new ContactField (« home », ' 203-555-7890', false) ;
+ contact.phoneNumbers = phoneNumbers ;
- // save the contact
- contact.save();
+ enregistrer le contact contact.save() ;
### Quirks Android
@@ -540,7 +501,7 @@ Contient différents types d'informations sur un `Contact` nom de l'objet.
### Plates-formes prises en charge
* Amazon Fire OS
-* Android 2.X
+* Android
* BlackBerry 10
* Firefox OS
* iOS
@@ -550,25 +511,16 @@ Contient différents types d'informations sur un `Contact` nom de l'objet.
### Exemple
- function onSuccess(contacts) {
- for (var i = 0; i < contacts.length; i++) {
- alert("Formatted: " + contacts[i].name.formatted + "\n" +
- "Family Name: " + contacts[i].name.familyName + "\n" +
- "Given Name: " + contacts[i].name.givenName + "\n" +
- "Middle Name: " + contacts[i].name.middleName + "\n" +
- "Suffix: " + contacts[i].name.honorificSuffix + "\n" +
- "Prefix: " + contacts[i].name.honorificSuffix);
+ function onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {alert ("Formatted:" + contacts[i].name.formatted + « \n » + "patronyme:" + contacts[i].name.familyName + « \n » + "Prénom:" + contacts[i].name.givenName + « \n » + "Prénom:" + contacts[i].name.middleName + « \n » + "suffixe:" + contacts[i].name.honorificSuffix + « \n » + "préfixe:" + contacts[i].name.honorificSuffix) ;
}
};
- function onError(contactError) {
- alert('onError!');
- };
+ function onError(contactError) {alert('onError!');} ;
- var options = new ContactFindOptions();
- options.filter = "";
- filter = ["displayName", "name"];
- navigator.contacts.find(filter, onSuccess, onError, options);
+ options de var = new ContactFindOptions() ;
+ options.Filter = "" ;
+ filtre = ["name", « nom »] ;
+ Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
### Quirks Android
@@ -642,26 +594,17 @@ Le `ContactOrganization` objet Stocke des propriétés un contact de l'organisat
### Exemple
- function onSuccess(contacts) {
- for (var i = 0; i < contacts.length; i++) {
- for (var j = 0; j < contacts[i].organizations.length; j++) {
- alert("Pref: " + contacts[i].organizations[j].pref + "\n" +
- "Type: " + contacts[i].organizations[j].type + "\n" +
- "Name: " + contacts[i].organizations[j].name + "\n" +
- "Department: " + contacts[i].organizations[j].department + "\n" +
- "Title: " + contacts[i].organizations[j].title);
+ function onSuccess(contacts) {pour (var j'ai = 0; j'ai < contacts.length; i ++) {pour (var j = 0; j < contacts[i].organizations.length; j ++) {alert ("Pref:" + contacts[i].organizations[j].pref + « \n » + "Type:" + contacts[i].organizations[j].type + « \n » + "nom:" + contacts[i].organizations[j].name + « \n » + "Département:" + contacts[i].organizations[j].department + « \n » + "Title: "+ contacts[i].organizations[j].title) ;
}
}
};
- function onError(contactError) {
- alert('onError!');
- };
+ function onError(contactError) {alert('onError!');} ;
- var options = new ContactFindOptions();
- options.filter = "";
- filter = ["displayName", "organizations"];
- navigator.contacts.find(filter, onSuccess, onError, options);
+ options de var = new ContactFindOptions() ;
+ options.Filter = "" ;
+ filtre = ["displayName", « organisations »] ;
+ Navigator.contacts.Find (filtre, onSuccess, onError, options) ;
### Android 2.X Quirks
http://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts/blob/293c8b3f/doc/it/index.md
----------------------------------------------------------------------
diff --git a/doc/it/index.md b/doc/it/index.md
index 14caae6..29d7bf6 100644
--- a/doc/it/index.md
+++ b/doc/it/index.md
@@ -19,7 +19,15 @@
# org.apache.cordova.contacts
-Fornisce l'accesso al database di contatti del dispositivo.
+Questo plugin definisce un oggetto globale `navigator.contacts`, che fornisce l'accesso al database di contatti del dispositivo.
+
+Anche se l'oggetto è associato con ambito globale del `navigator`, non è disponibile fino a dopo l'evento `deviceready`.
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+ function onDeviceReady() {
+ console.log(navigator.contacts);
+ }
+
**Avviso**: raccolta e utilizzo dei dati di contatto solleva questioni di privacy importante. Politica sulla privacy dell'app dovrebbe discutere come app utilizza i dati di contatto e se è condiviso con altre parti. Informazioni di contatto sono considerate sensibile perché rivela le persone con cui una persona comunica. Pertanto, oltre alla politica di privacy dell'app, è fortemente consigliabile fornendo un preavviso di just-in-time prima app accede o utilizza i dati di contatto, se il sistema operativo del dispositivo non farlo già. Tale comunicazione deve fornire le informazioni stesse notate sopra, oltre ad ottenere l'autorizzazione (ad esempio, presentando scelte per **OK** e **No grazie**). Si noti che alcuni mercati app possono richiedere l'app per fornire un preavviso di just-in-time e ottenere l'autorizzazione dell'utente prima di accedere ai dati di contatto. Un'esperienza utente chiara e facile--capisce che circonda l'uso del contatto dati aiuta a evitare la confusio
ne dell'utente e percepito un uso improprio dei dati di contatto. Per ulteriori informazioni, vedere la guida sulla Privacy.
@@ -30,7 +38,7 @@ Fornisce l'accesso al database di contatti del dispositivo.
### 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.
+Creare **www/manifest.webapp** come descritto nel [Manifest Docs][1]. Aggiungi permisions rilevanti. C'è anche la necessità di modificare il tipo di webapp in "privilegiato" - [Manifest Docs][2]. **AVVERTENZA**: tutte le apps privilegiato applicare [Content Security Policy][3] che vieta script inline. Inizializzare l'applicazione in un altro modo.
[1]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest
[2]: https://developer.mozilla.org/en-US/Apps/Developing/Manifest#type
@@ -47,7 +55,7 @@ Creare **www/manifest.webapp** come descritto nel [Manifesto Docs][1]. Aggiungi
### Stranezze di Windows
-Eventuali contatti restituiti da `find` e `pickContact` metodi sono readonly, quindi l'applicazione non può modificarli. `find`Metodo disponibile solo sui dispositivi Windows Phone 8.1.
+Eventuali contatti restituiti dai metodi `find` e `pickContact` sono readonly, quindi l'applicazione non può modificarli. Metodo `find` disponibile solo sui dispositivi Windows Phone 8.1.
### Stranezze di Windows 8
@@ -63,7 +71,7 @@ Windows 8 contatti sono readonly. Tramite i contatti di Cordova API non sono que
### Oggetti
-* Contatto
+* Contact
* ContactName
* ContactField
* ContactAddress
@@ -72,11 +80,11 @@ Windows 8 contatti sono readonly. Tramite i contatti di Cordova API non sono que
* ContactError
* ContactFieldType
-## Navigator.contacts.Create
+## navigator.contacts.create
-Il `navigator.contacts.create` metodo sincrono e restituisce un nuovo `Contact` oggetto.
+Il metodo `navigator.contacts.create` è sincrono e restituisce un nuovo oggetto di `Contact`.
-Questo metodo non mantiene l'oggetto contatto nel database contatti dispositivo, per cui è necessario richiamare il `Contact.save` metodo.
+Questo metodo non mantiene l'oggetto contatto nel database contatti dispositivo, per cui è necessario richiamare il metodo `Contact.save`.
### Piattaforme supportate
@@ -93,27 +101,29 @@ Questo metodo non mantiene l'oggetto contatto nel database contatti dispositivo,
## 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 metodo `navigator.contacts.find` in modo asincrono, esegue una query sul database di contatti del dispositivo e restituisce una matrice di oggetti `Contact`. Gli oggetti risultanti vengono passati alla funzione di callback `contactSuccess` specificata dal parametro **contactSuccess**.
-Il parametro **contactFields** specifica i campi per essere utilizzato come un qualificatore di ricerca. Un parametro di lunghezza zero, **contactFields** non è valido e si traduce in `ContactError.INVALID_ARGUMENT_ERROR` . Un valore di **contactFields** di `"*"` restituisce tutti i contatti di campi.
+Il parametro **contactFields** specifica i campi per essere utilizzato come un qualificatore di ricerca. Un parametro di lunghezza zero, **contactFields** non è valido e si traduce in `ContactError.INVALID_ARGUMENT_ERROR`. Un valore di **contactFields** di `"*"` ricerche campi tutti i contatti.
-La stringa di **contactFindOptions.filter** può essere utilizzata come un filtro di ricerca quando una query sul database di contatti. Se fornito, una distinzione, corrispondenza parziale valore viene applicato a ogni campo specificato nel parametro **contactFields** . Se esiste una corrispondenza per *qualsiasi* dei campi specificati, viene restituito il contatto. Uso **contactFindOptions.desiredFields** parametro di controllo quale contattare la proprietà deve essere rispedito indietro.
+La stringa di **contactFindOptions.filter** può essere utilizzata come un filtro di ricerca quando una query sul database di contatti. Se fornito, una distinzione, corrispondenza parziale valore viene applicato a ogni campo specificato nel parametro **contactFields**. Se esiste una corrispondenza per *qualsiasi* dei campi specificati, viene restituito il contatto. Uso **contactFindOptions.desiredFields** parametro di controllo quale contattare la proprietà deve essere rispedito indietro.
### Parametri
-* **contactSuccess**: funzione di callback successo richiamato con la matrice di oggetti contatto restituiti dal database. [Richiesto]
-
-* **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[])* [Required]
-* **contactFields**: contattare campi da utilizzare come un qualificatore di ricerca. *(DOMString[])* [Richiesto]
+* **contactSuccess**: funzione di callback successo richiamato con la matrice di oggetti contatto restituiti dal database. [Required]
-* **contactFindOptions**: opzioni per filtrare navigator.contacts di ricerca. [Facoltativo] I tasti sono:
-
-* **filtro**: la stringa di ricerca utilizzata per trovare navigator.contacts. *(DOMString)* (Default:`""`)
+* **contactError**: funzione di callback di errore, viene richiamato quando si verifica un errore. [Facoltativo]
-* **multiple**: determina se l'operazione di ricerca restituisce più navigator.contacts. *(Booleano)* (Default:`false`)
+* **contactFindOptions**: opzioni per filtrare navigator.contacts di ricerca. [Optional]
+
+ I tasti sono:
- * **desiredFields**: contattare i campi per essere tornato indietro. Se specificato, il conseguente `Contact` oggetto presenta solo i valori per questi campi. *(DOMString[])* [Facoltativo]
+ * **filter**: la stringa di ricerca utilizzata per trovare navigator.contacts. *(DOMString)* (Default: `""`)
+
+ * **multiple**: determina se l'operazione di ricerca restituisce più navigator.contacts. *(Boolean)* (Default: `false`)
+
+ * **desiredFields**: contattare i campi per essere tornato indietro. Se specificato, il risultante `contatto` oggetto solo caratteristiche valori per questi campi. *(DOMString[])* [Optional]
### Piattaforme supportate
@@ -149,7 +159,7 @@ La stringa di **contactFindOptions.filter** può essere utilizzata come un filtr
## 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** .
+Il metodo `navigator.contacts.pickContact` lancia il contatto selettore per selezionare un singolo contatto. L'oggetto risultante viene passato alla funzione di callback `contactSuccess` specificata dal parametro **contactSuccess**.
### Parametri
@@ -174,9 +184,9 @@ Il `navigator.contacts.pickContact` Metodo lancia il contatto selettore per sele
});
-## Contatto
+## Contact
-Il `Contact` oggetto rappresenta il contatto di un utente. Contatti possono essere creati, memorizzati o rimossi dal database di contatti dispositivo. Contatti possono anche essere estratto (singolarmente o in blocco) dal database richiamando il `navigator.contacts.find` metodo.
+L'oggetto `Contact` rappresenta il contatto di un utente. Contatti possono essere creati, memorizzati o rimossi dal database di contatti dispositivo. Contatti possono anche essere estratto (singolarmente o in blocco) dal database richiamando il metodo `navigator.contacts.find`.
**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.
@@ -335,7 +345,7 @@ Il `Contact` oggetto rappresenta il contatto di un utente. Contatti possono esse
## 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.
+L'oggetto `ContactAddress` memorizza le proprietà di un singolo indirizzo di un contatto. Un oggetto `Contact` può includere più di un indirizzo in una matrice `[] ContactAddress`.
### Proprietà
@@ -438,7 +448,7 @@ Il `ContactAddress` oggetto memorizza le proprietà di un singolo indirizzo di u
## ContactError
-Il `ContactError` oggetto viene restituito all'utente attraverso la `contactError` funzione di callback quando si verifica un errore.
+L'oggetto `ContactError` viene restituito all'utente tramite la funzione di callback `contactError` quando si verifica un errore.
### Proprietà
@@ -456,9 +466,9 @@ Il `ContactError` oggetto viene restituito all'utente attraverso la `contactErro
## 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.
+L'oggetto `ContactField` è un componente riutilizzabile che rappresenta Contatta campi genericamente. Ogni oggetto `ContactField` contiene una proprietà di `value`, `type` e `pref`. Un oggetto `Contact` memorizza diverse proprietà in matrici `[] ContactField`, come numeri di telefono e indirizzi email.
-Nella maggior parte dei casi, non esistono valori pre-determinati per un `ContactField` **tipo** attributo oggetto. Ad esempio, un numero di telefono può specificare valori di **tipo** di *casa*, *lavoro*, *mobile*, *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.
+Nella maggior parte dei casi, esistono pre-determinati valori per l'attributo `type` di un oggetto **ContactField**. Ad esempio, un numero di telefono può specificare valori di **type** di *casa*, *lavoro*, *mobile*, *iPhone* o qualsiasi altro valore che è supportato dal database dei contatti su una piattaforma particolare dispositivo. Tuttavia, per il campo di **photo** del `Contacto`, il campo **type** indica il formato dell'immagine restituita: **url** quando il **value** di attributo contiene un URL per l'immagine fotografica, o *base64*, quando il **value** contiene una stringa con codifica base64 immagine.
### Proprietà
@@ -521,7 +531,7 @@ Nella maggior parte dei casi, non esistono valori pre-determinati per un `Contac
## ContactName
-Contiene diversi tipi di informazioni circa un `Contact` nome dell'oggetto.
+Contiene diversi tipi di informazioni sul nome di un oggetto `Contact`.
### Proprietà
@@ -540,7 +550,7 @@ Contiene diversi tipi di informazioni circa un `Contact` nome dell'oggetto.
### Piattaforme supportate
* Amazon fuoco OS
-* Android 2. x
+* Android
* BlackBerry 10
* Firefox OS
* iOS
@@ -617,7 +627,7 @@ Contiene diversi tipi di informazioni circa un `Contact` nome dell'oggetto.
## 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.
+L'oggetto `ContactOrganization` memorizza la proprietà di organizzazione di un contatto. Un oggetto `Contact` memorizza uno o più oggetti `ContactOrganization` in una matrice.
### Proprietà
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org