ContactName

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

プロパティー

  • formatted: 連絡先のフルネームを表します (DOMString)
  • familyName: 連絡先の姓を表します (DOMString)
  • givenName: 連絡先の名を表します (DOMString)
  • middleName: 連絡先のミドルネームを表します (DOMString)
  • honorificPrefix: 連絡先の接頭敬称を表します (例: Mr. Dr.) (DOMString)
  • honorificSuffix: 連絡先の接尾敬称を表します (例: Esq.) (DOMString)

詳細

ContactName オブジェクトは連絡先の名前プロパティーの情報を格納します。

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

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

使用例

function onSuccess(contacts) {
    for (var i=0; i<contacts.length; i++) {
        alert("名前: " + contacts[i].name.formatted + "\n" +
                "姓: " + contacts[i].name.familyName + "\n" +
                "名: " + contacts[i].name.givenName + "\n" +
                "ミドルネーム: " + contacts[i].name.middleName + "\n" +
                "接頭敬称: " + contacts[i].name.honorificSuffix + "\n" +
                "接尾敬称: " + contacts[i].name.honorificSuffix);
    }
};

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

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

詳細な使用例

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

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

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

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

    // onSuccess: 連絡先の取得に成功した場合
    //
    function onSuccess(contacts) {
        for (var i=0; i<contacts.length; i++) {
            alert("名前: " + contacts[i].name.formatted + "\n" +
                    "姓: " + contacts[i].name.familyName + "\n" +
                    "名: " + contacts[i].name.givenName + "\n" +
                    "ミドルネーム: " + contacts[i].name.middleName + "\n" +
                    "接頭敬称: " + contacts[i].name.honorificSuffix + "\n" +
                    "接尾敬称: " + contacts[i].name.honorificSuffix);
        }
    };

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

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

Android に関する注意点

  • formatted: 部分的にサポートされています。 honorificPrefix, givenName, middleName, familyName, honorificSuffix を連結したものを返しますが、保存は行われません。

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

  • formatted: 部分的にサポートされています。 BlackBerry の firstName と lastName フィールドを連結したものを返します。
  • familyName: サポートされています。 BlackBerry の lastName フィールドに保存されています。
  • givenName: サポートされています。 BlackBerry の firstName フィールドに保存されています。
  • middleName: このプロパティーはサポートされておらず、常に null を返します。
  • honorificPrefix: このプロパティーはサポートされておらず、常に null を返します。
  • honorificSuffix: このプロパティーはサポートされておらず、常に null を返します。

iOS に関する注意点

  • formatted: 部分的にサポートされています。 iOS の合成名を返しますが、保存は行われません。

Bada に関する注意点

  • formatted: サポートされていません。
  • middleName: サポートされていません。 _ honorificPrefix: サポートされていません。
  • honorificSuffix: サポートされていません。