ContactAddress

包含位址屬性的 Contact 物件。

屬性

  • 上一頁: 設置為 true 如果此 ContactAddress 包含使用者的首選的值。（布林）

  • 類型： 一個字串，例如指示哪種類型的欄位這是回家。() DOMString

  • 格式： 顯示格式的完整位址。() DOMString

  • streetAddress： 完整的街道位址。() DOMString

  • 地點： 城市或地點。() DOMString

  • 區域： 國家或地區。() DOMString

  • 郵遞區號： 郵遞區號或郵政代碼。() DOMString

  • 國家： 國家名稱。() DOMString

詳細資訊

ContactAddress物件存儲的單一位址的連絡人的屬性。 A Contact 物件可能包括多個位址在 ContactAddress[] 陣列。

支援的平臺

  • Android 系統
  • 黑莓手機 WebWorks （OS 5.0 和更高）
  • iOS
  • Windows Phone 7 和 8
  • Windows 8

快速的示例

// display the address information for all contacts

function onSuccess(contacts) {
    for (var i = 0; i < contacts.length; i++) {
        for (var j = 0; j < contacts[i].addresses.length; j++) {
            alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
                "Type: "           + contacts[i].addresses[j].type          + "\n" +
                "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
                "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
                "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
                "Region: "         + contacts[i].addresses[j].region        + "\n" +
                "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
                "Country: "        + contacts[i].addresses[j].country);
        }
    }
};

function onError(contactError) {
    alert('onError!');
};

// find all contacts
var options = new ContactFindOptions();
options.filter = "";
var filter = ["displayName", "addresses"];
navigator.contacts.find(filter, onSuccess, onError, options);

完整的示例

<!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() {
        // find all contacts
        var options = new ContactFindOptions();
        options.filter = "";
        var filter = ["displayName", "addresses"];
        navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: Get a snapshot of the current contacts
    //
    function onSuccess(contacts) {
        // display the address information for all 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);
            }
        }
    };

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

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

Android 2.X 的怪癖

  • 上一頁: 不受支援，返回 false Android 2.X 的設備上。

黑莓手機 WebWorks （OS 5.0 和更高） 的怪癖

  • 上一頁： 返回的黑莓設備上不支援false.

  • 類型： 部分支援。工作和家庭類型位址的每個唯一一個可以存儲每個連絡人。

  • 格式化： 部分支援。返回的串聯的所有黑莓手機位址欄位。

  • streetAddress: 支援。返回的串聯的黑莓位址 1和位址 2的位址欄位。

  • 現場: 支援。黑莓手機城位址欄位中存儲。

  • 區域： 支援。黑莓手機stateProvince位址欄位中存儲。

  • 郵遞區號: 支援。黑莓手機zipPostal位址欄位中存儲。

  • 國家： 支援。

iOS 的怪癖

  • 上一頁： 返回的 iOS 設備上不支援false.

  • 格式化： 目前不支援。