ContactAddress

[Contact](../Contact/contact.html) オブジェクトの住所プロパティーを表します。

プロパティー

  • pref: ContactAddress がユーザーの推奨値を含むかどうかを表します。含む場合、 true がセットされます (boolean)
  • type: フィールドのタイプを表します (例: 'home') (DOMString)
  • formatted: 住所全体を表します (DOMString)
  • streetAddress: 番地を表します (DOMString)
  • locality: 都市名を表します (DOMString)
  • region: 地域名を表します (DOMString)
  • postalCode: 郵便番号を表します (DOMString)
  • country: 国を表します (DOMString)

詳細

ContactAddress オブジェクトは連絡先の住所に関するプロパティーを表します。 [Contact](../Contact/contact.html) オブジェクトは、複数の住所が格納された ContactAddress[] 配列を保持しています。

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

  • Android
  • BlackBerry WebWorks (OS 5.0 以上)
  • iOS
  • Bada 1.2 & 2.0

使用例

// すべての連絡先の住所情報を取得し、表示します
function onSuccess(contacts) {
    for (var i=0; i<contacts.length; i++) {
        for (var j=0; j<contacts[i].addresses.length; j++) {
            alert("推奨値: " + contacts[i].addresses[j].pref + "\n" +
                    "タイプ: " + contacts[i].addresses[j].type + "\n" +
                    "住所: " + contacts[i].addresses[j].formatted + "\n" +
                    "番地: " + contacts[i].addresses[j].streetAddress + "\n" +
                    "都市名: " + contacts[i].addresses[j].locality + "\n" +
                    "地域名: " + contacts[i].addresses[j].region + "\n" +
                    "郵便番号: " + contacts[i].addresses[j].postalCode + "\n" +
                    "国名: " + contacts[i].addresses[j].country);
        }
    }
};

function onError(contactError) {
    alert('エラーが発生しました。');
};

// 連絡先を検索します
var options = new ContactFindOptions();
options.filter="";
var filter = ["displayName","addresses"];
navigator.contacts.find(filter, onSuccess, onError, options);

詳細な使用例

<!DOCTYPE html>
<html>
  <head>
    <title>Contact の使用例</title>

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

    // Cordova の読み込み完了まで待機
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // Cordova 準備完了
    //
    function onDeviceReady() {
        // find all contacts
        var options = new ContactFindOptions();
        options.filter="";
        var filter = ["displayName","addresses"];
        navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: 連絡先の取得に成功した場合
    //
    function onSuccess(contacts) {
        // すべての連絡先の住所情報を取得し、表示します
        for (var i=0; i<contacts.length; i++) {
            for (var j=0; j<contacts[i].addresses.length; j++) {
                alert("推奨値: " + contacts[i].addresses[j].pref + "\n" +
                        "タイプ: " + contacts[i].addresses[j].type + "\n" +
                        "住所: " + contacts[i].addresses[j].formatted + "\n" +
                        "番地: " + contacts[i].addresses[j].streetAddress + "\n" +
                        "都市名: " + contacts[i].addresses[j].locality + "\n" +
                        "地域名: " + contacts[i].addresses[j].region + "\n" +
                        "郵便番号: " + contacts[i].addresses[j].postalCode + "\n" +
                        "国名: " + contacts[i].addresses[j].country);
            }
        }
    };

    // onError: 連絡先の取得に失敗した場合
    //
    function onError(contactError) {
        alert('エラーが発生しました。');
    }

    </script>
  </head>
  <body>
    <h1>使用例</h1>
    <p>連絡先の検索</p>
  </body>
</html>

Android 2.X に関する注意点

  • pref: このプロパティーは Android 2.X ではサポートされておらず、常に false を返します。

Android 1.X に関する注意点

  • pref: このプロパティーは Android 1.X ではサポートされておらず、常に false を返します。
  • type: このプロパティーは Android 1.X ではサポートされておらず、常に null を返します。
  • streetAddress: このプロパティーは Android 1.X ではサポートされておらず、常に null を返します。
  • locality: このプロパティーは Android 1.X ではサポートされておらず、常に null を返します。
  • region: このプロパティーは Android 1.X ではサポートされておらず、常に null を返します。
  • postalCode: このプロパティーは Android 1.X ではサポートされておらず、常に null を返します。
  • country: このプロパティーは Android 1.X ではサポートされておらず、常に null を返します。

BlackBerry WebWorks (OS 5.0 and higher) に関する注意点

  • pref: このプロパティーは BlackBerry ではサポートされておらず、常に false を返します。
  • type: 部分的にサポートされています。 一つの連絡先につき、一つずつの "Work" と "Home" タイプの住所が保存できます。
  • formatted: 部分的にサポートされています。 BlackBerry のアドレスフィールドの連結を返します。
  • streetAddress: サポートされています。 BlackBerry の address1 と address2 アドレスフィールドの連結を返します。
  • locality: サポートされています。 BlackBerry の city アドレスフィールドに保存されます。
  • region: サポートされています。 BlackBerry の stateProvince アドレスフィールドに保存されます。
  • postalCode: サポートされています。 BlackBerry の zipPostal アドレスフィールドに保存されます。
  • country: サポートされています。

iOS に関する注意点

  • pref: このプロパティーは iOS ではサポートされておらず、常に false を返します。
  • formatted: サポートされていません。

Bada に関する注意点

  • formatted: このプロパティーはサポートされていません。
  • type: WORK か HOME かのいずれかである必要があります。