이 아닌 문서의 최신 버전입니다!
Click here for the latest released version.
담당자 이름
에 대 한 다양 한 정보를 포함 한 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와 더 높은) 단점이
포맷: 부분적으로 지원 합니다. 블랙베리 firstName 및 lastName 필드의 연결을 반환합니다.
familyName: 지원. 블랙베리 lastName 필드에 저장 합니다.
givenName: 지원. 블랙베리 firstName 필드에 저장 합니다.
middleName: 지원 되지 않는 반환
null
.honorificPrefix: 지원 되지 않는 반환
null
.honorificSuffix: 지원 되지 않는 반환
null
.
iOS 단점
- 포맷: 부분적으로 지원 합니다. IOS 복합 이름 반환 하지만 읽기 전용입니다.