これがないドキュメントの最新バージョンです！ Click here for the latest released version.

お問い合わせ

ユーザーの個人情報やビジネスの連絡先などの連絡先を記述するプロパティが含まれています。

プロパティ

id：グローバルに一意の識別子。（，）
displayName: エンドユーザへの表示に適した、この連絡先の名前。（，）
名前：人の名前のすべてのコンポーネントを格納するオブジェクト。(ContactName)
ニックネーム: 連絡先のアドレスに使用するカジュアルな名前。（，）
電話番号: 連絡先の電話番号の配列。(ContactField[])
メール：連絡先の電子メールアドレスの配列。(ContactField[])
アドレス: 連絡先のアドレスの配列。(ContactAddress[])
ims：連絡先の IM アドレスの配列。(ContactField[])
組織: 連絡先の組織の配列。(ContactOrganization[])
誕生日: 連絡先の誕生日。（日）
注: 連絡先についてのメモ。（，）
写真: 連絡先の写真の配列。(ContactField[])
カテゴリ: 取引先担当者に関連付けられているすべてのユーザー定義カテゴリの配列。(ContactField[])
url: 取引先担当者に関連付けられている web ページの配列。(ContactField[])

メソッド

クローン：新しいを返します Contact と呼び出し元のオブジェクトのディープコピーであるオブジェクトの id プロパティに設定null.
削除: デバイスの連絡先データベースから連絡先を削除します、それ以外の場合のためのエラーコールバックを実行する、 [ContactError](../ContactError/contactError.html) オブジェクト。
保存: デバイスの連絡先データベースに新しい連絡先を保存または同じidを持つ連絡先が既に存在する場合、既存の連絡先を更新します。

詳細

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

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

サポートされているプラットフォーム

アンドロイド
ブラックベリー WebWorks (OS 5.0 およびより高い)
iOS
Windows Phone 7 と 8
Windows 8

簡単な例を保存します。

function onSuccess(contact) {
    alert("Save Success");
};

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

// create a new contact object
var contact = navigator.contacts.create();
contact.displayName = "Plumber";
contact.nickname = "Plumber";            // specify both to support all devices

// populate some fields
var name = new ContactName();
name.givenName = "Jane";
name.familyName = "Doe";
contact.name = name;

// save to device
contact.save(onSuccess,onError);

簡単な例のクローンを作成します。

    // clone the contact object
    var clone = contact.clone();
    clone.name.givenName = "John";
    console.log("Original contact name = " + contact.name.givenName);
    console.log("Cloned contact name = " + clone.name.givenName);

簡単な例を削除します。

function onSuccess() {
    alert("Removal Success");
};

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

    // remove the contact from the device
    contact.remove(onSuccess,onError);

完全な例

<!DOCTYPE html>
<html>
  <head>
    <title>Contact Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        // create
        var contact = navigator.contacts.create();
        contact.displayName = "Plumber";
        contact.nickname = "Plumber";                 // specify both to support all devices
        var name = new ContactName();
        name.givenName = "Jane";
        name.familyName = "Doe";
        contact.name = name;

        // save
        contact.save(onSaveSuccess,onSaveError);

        // clone
        var clone = contact.clone();
        clone.name.givenName = "John";
        console.log("Original contact name = " + contact.name.givenName);
        console.log("Cloned contact name = " + clone.name.givenName);

        // remove
        contact.remove(onRemoveSuccess,onRemoveError);
    }

    // onSaveSuccess: Get a snapshot of the current contacts
    //
    function onSaveSuccess(contact) {
        alert("Save Success");
    }

    // onSaveError: Failed to get the contacts
    //
    function onSaveError(contactError) {
        alert("Error = " + contactError.code);
    }

    // onRemoveSuccess: Get a snapshot of the current contacts
    //
    function onRemoveSuccess(contacts) {
        alert("Removal Success");
    }

    // onRemoveError: Failed to get the contacts
    //
    function onRemoveError(contactError) {
        alert("Error = " + contactError.code);
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Find Contacts</p>
  </body>
</html>

アンドロイド 2.X 癖

カテゴリ: 返す 2.X の Android デバイスでサポートされていませんnull.

ブラックベリー WebWorks (OS 5.0 およびより高い) 癖

id: サポートされています。連絡先を保存するときに、デバイスによって割り当てられます。
displayName: サポートされています。ブラックベリー user1フィールドに格納されます。
ニックネーム: サポートされていないを返すnull.
電話番号: 部分的にサポートされます。電話番号は、型が 'ホーム'、 workPhone1とworkPhone2 型が '仕事'携帯電話型が '携帯電話' の場合の場合、 faxPhone タイプが「fax」、 pagerPhone 型は '' ページャー、およびその他の電話の種類が上記のいずれの場合場合場合ブラックベリーフィールドhomePhone1とhomePhone2に格納されます。
メール：部分的にサポートされます。最初の 3 つの電子メールアドレスはそれぞれブラックベリーのemail1、 email2、およびemail3フィールドに格納されます。
アドレス: 部分的にサポートされます。最初と 2 番目のアドレスはそれぞれ、ブラックベリー homeAddressとworkAddressフィールドに格納されます。
ims: サポートされていないを返すnull.
組織: 部分的にサポートされます。名前とタイトル最初の組織のそれぞれブラックベリー会社とタイトルのフィールドに格納されます。
写真：部分的にサポートされます。サムネイルサイズの画像を 1 つがサポートされています。連絡先の写真を設定するには渡す、いずれかで base64 エンコードイメージ、またはイメージを指している URL。イメージはブラックベリーの連絡先データベースに保存する前に縮小されます。連絡先の写真が base64 エンコードイメージとして返されます。
カテゴリ: 部分的にサポートされます。ビジネスと個人のカテゴリのみがサポートされます。
url: 部分的にサポートされます。最初の URL は、ブラックベリーのweb ページのフィールドに格納されます。

iOS の癖

displayName: 返す iOS でサポートされていない null がない限り、ない ContactName 指定すると、その場合は複合名、ニックネームを返しますまたは "" 、それぞれ。
誕生日: JavaScript として入力する必要があります Date オブジェクト、同じ方法が返されます。
写真：アプリケーションの一時ディレクトリに格納されているイメージへのファイルの URL を返します。一時ディレクトリの内容は、アプリケーションの終了時に削除されます。
カテゴリ: このプロパティは現在サポートされていません、返すnull.

Windows Phone 7 と 8 癖

displayName: 表示名パラメーターの表示名と異なるために提供値を取得、連絡先を検索するとき、連絡先を作成するとき。
url: 1 つだけが利用できるが、連絡先の作成、ユーザー入力し 1 つ以上の web アドレスを保存するときは、連絡先を検索するとき。
電話番号:県オプションはサポートされていません。型は、検索操作ではサポートされていません。 1 つだけ phoneNumber は各タイプの許可.
メール：県オプションはサポートされていません。家庭や個人的なメールと同じエントリを参照します。各タイプの 1 つだけのエントリが許可されて.
アドレス: 仕事とホーム/パーソナルタイプのみをサポートしています。家庭や個人型参照して同じアドレスエントリ。各タイプの 1 つだけのエントリが許可されて.
組織： 1 つだけが許可され、県、タイプ、および部門の属性をサポートしていません。
注: サポートされていないを返すnull.
ims: サポートされていないを返すnull.
誕生日: サポートされていないを返すnull.
カテゴリ: サポートされていないを返すnull.