ContactField

一般的なフィールドをサポートしている、 Contact オブジェクト。いくつかのプロパティとして格納されている ContactField オブジェクトには、電子メール アドレス、電話番号と Url が含まれます。

プロパティ

  • タイプ: たとえばフィールドこれはホームの種類を示す文字列。（，）

  • 値: 電話番号や電子メール アドレスなど、フィールドの値。（，）

  • 県: に設定されている true 場合は、この ContactField ユーザーの推奨値が含まれています。(ブール値)

詳細

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

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

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

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

簡単な例

    // create a new contact
    var contact = navigator.contacts.create();

    // store contact phone numbers in ContactField[]
    var phoneNumbers = [];
    phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
    phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
    phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
    contact.phoneNumbers = phoneNumbers;

    // save the contact
    contact.save();

完全な例

<!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 a new contact
        var contact = navigator.contacts.create();

        // store contact phone numbers in ContactField[]
        var phoneNumbers = [];
        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
        contact.phoneNumbers = phoneNumbers;

        // save the contact
        contact.save();

        // search contacts, returning display name and phone numbers
        var options = new ContactFindOptions();
        options.filter = "";
        filter = ["displayName", "phoneNumbers"];
        navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: Get a snapshot of the current contacts
    //
    function onSuccess(contacts) {
        for (var i = 0; i < contacts.length; i++) {
            // display phone numbers
            for (var j = 0; j < contacts[i].phoneNumbers.length; j++) {
                alert("Type: "      + contacts[i].phoneNumbers[j].type  + "\n" +
                      "Value: "     + contacts[i].phoneNumbers[j].value + "\n" +
                      "Preferred: " + contacts[i].phoneNumbers[j].pref);
            }
        }
    };

    // onError: Failed to get the contacts
    //
    function onError(contactError) {
        alert('onError!');
    }

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

Android の癖

  • 県: サポートされていないを返すfalse.

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

  • 種類: 部分的にサポートされます。電話番号を使用します。

  • 値: サポートされています。

  • 県: サポートされていないを返すfalse.

iOS の癖

  • 県: サポートされていないを返すfalse.