담당자 이름

에 대 한 다양 한 정보를 포함 한 Contact 개체의 이름.

속성

  • 포맷: 연락처의 전체 이름. (DOMString)

  • familyName: 연락처의 성. (DOMString)

  • givenName: 연락처의 이름. (DOMString)

  • middleName: 연락처의 중간 이름을. (DOMString)

  • honorificPrefix: 연락처의 접두사 (예: 미스터 또는 닥터) (DOMString)

  • honorificSuffix: 연락처의 접미사 ( esq.예). (DOMString)

세부 정보

ContactName개체는 연락처의 이름 속성에 저장 합니다.

지원 되는 플랫폼

  • 안 드 로이드 2.X
  • 블랙베리 WebWorks (운영 체제 5.0와 더 높은)
  • iOS
  • Windows Phone 7과 8
  • 윈도우 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>

안 드 로이드 단점

  • 포맷: 부분적으로 지원 되 고 읽기 전용. 연결을 반환 합니다 honorificPrefix , givenName , middleName , familyName , 그리고honorificSuffix.

블랙베리 WebWorks (운영 체제 5.0와 더 높은) 단점이

  • 포맷: 부분적으로 지원 합니다. 블랙베리 firstNamelastName 필드의 연결을 반환합니다.

  • familyName: 지원. 블랙베리 lastName 필드에 저장 합니다.

  • givenName: 지원. 블랙베리 firstName 필드에 저장 합니다.

  • middleName: 지원 되지 않는 반환null.

  • honorificPrefix: 지원 되지 않는 반환null.

  • honorificSuffix: 지원 되지 않는 반환null.

iOS 단점

  • 포맷: 부분적으로 지원 합니다. IOS 복합 이름 반환 하지만 읽기 전용입니다.