得意先コード

についての異なる種類情報にはが含まれています、 Contact オブジェクトの名前。

プロパティ

  • フォーマット: 連絡先の完全な名前。（，）

  • familyName: 連絡先の姓。（，）

  • givenName: 連絡先の名前。（，）

  • ミドル ネーム: 連絡先のミドル ネーム。（，）

  • honorificPrefix: 連絡先のプレフィックス (例氏または博士) (，)

  • honorificSuffix: 連絡先のサフィックス (弁護士の例)。（，）

詳細

ContactNameオブジェクト、連絡先の名前のプロパティが格納されます。

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

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

簡単な例

function onSuccess(contacts) {
    for (var i = 0; i < contacts.length; i++) {
        alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
            "Family Name: "  + contacts[i].name.familyName      + "\n" +
            "Given Name: "   + contacts[i].name.givenName       + "\n" +
            "Middle Name: "  + contacts[i].name.middleName      + "\n" +
            "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
            "Prefix: "       + contacts[i].name.honorificSuffix);
    }
};

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

var options = new ContactFindOptions();
options.filter = "";
filter = ["displayName", "name"];
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() {
        var options = new ContactFindOptions();
        options.filter="";
        filter = ["displayName","name"];
        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 ++) {
            alert("Formatted: " + contacts[i].name.formatted       + "\n" +
                "Family Name: " + contacts[i].name.familyName      + "\n" +
                "Given Name: "  + contacts[i].name.givenName       + "\n" +
                "Middle Name: " + contacts[i].name.middleName      + "\n" +
                "Suffix: "      + contacts[i].name.honorificSuffix + "\n" +
                "Prefix: "      + contacts[i].name.honorificPrefix);
        }
    };

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

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

Android の癖

  • フォーマット： 部分的にサポートされると読み取り専用です。 連結を返します honorificPrefix 、 givenName 、 middleName 、 familyName とhonorificSuffix.

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

  • フォーマット： 部分的にサポートされます。ブラックベリー firstNameとlastNameフィールドの連結を返します。

  • familyName: サポートされています。ブラックベリー [氏名]フィールドに格納されます。

  • givenName: サポートされています。ブラックベリーのfirstNameフィールドに格納されます。

  • ミドル ネーム: サポートされていないを返すnull.

  • honorificPrefix: サポートされていないを返すnull.

  • honorificSuffix: サポートされていないを返すnull.

iOS の癖

  • フォーマット： 部分的にサポートされます。IOS 複合名を返しますが、読み取り専用です。