contacts.find
장치 연락처 데이터베이스 쿼리 및 반환 합니다 하나 이상의 Contact
개체를 지정 하는 필드가 들어 있는 각.
navigator.contacts.find(contactFields, contactSuccess, contactError, contactFindOptions);
설명
contacts.find
장치 연락처 데이터베이스 쿼리 및의 배열을 반환 메서드가 비동기적으로 실행 될 Contact
개체. 결과 객체에 전달 되는 [contactSuccess](parameters/contactSuccess.html)
contactSuccess 매개 변수로 지정 된 콜백 함수.
ContactFields 매개 변수 검색 한정자로 사용할 수 있는 필드를 지정 하 고 그 결과 contactSuccess 콜백 함수에 전달 됩니다. 길이가 0 인 contactFields 매개 변수 유효 하지 않습니다 및 결과 [ContactError](ContactError/contactError.html).INVALID_ARGUMENT_ERROR
. ContactFields 값이 "*"
모든 연락처 필드를 반환 합니다.
ContactFindOptions.filter 문자열 연락처 데이터베이스를 쿼리할 때 검색 필터로 사용할 수 있습니다. 제공 된, 대/소문자, 부분 값 일치 contactFields 매개 변수에 지정 된 각 필드에 적용 됩니다. 모든 지정 된 필드의 일치 하는 경우 연락처 반환 됩니다.
매개 변수
contactFields: 검색 한정자로 사용 하는 필드에 문의. 그 결과
Contact
만이 필드의 값을 보유 하는 개체. (DOMString[]) [필수]contactSuccess: 데이터베이스에서 반환 되는 성공 콜백 함수는 연락처와 함께 호출 합니다. [필수]
contactError: 오류 콜백 함수에 오류가 발생할 때 호출 됩니다. [선택 사항]
contactFindOptions: 연락처를 필터링 하는 옵션을 검색 합니다. [선택 사항]
지원 되는 플랫폼
- 안 드 로이드
- 블랙베리 WebWorks (운영 체제 5.0와 더 높은)
- iOS
- Windows Phone 7과 8
- 윈도우 8
빠른 예제
function onSuccess(contacts) {
alert('Found ' + contacts.length + ' contacts.');
};
function onError(contactError) {
alert('onError!');
};
// find all contacts with 'Bob' in any name field
var options = new ContactFindOptions();
options.filter = "Bob";
options.multiple = true;
var fields = ["displayName", "name"];
navigator.contacts.find(fields, 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() {
// find all contacts with 'Bob' in any name field
var options = new ContactFindOptions();
options.filter = "Bob";
var fields = ["displayName", "name"];
navigator.contacts.find(fields, onSuccess, onError, options);
}
// onSuccess: Get a snapshot of the current contacts
function onSuccess(contacts) {
for (var i = 0; i < contacts.length; i++) {
console.log("Display Name = " + contacts[i].displayName);
}
}
// onError: Failed to get the contacts
function onError(contactError) {
alert('onError!');
}
</script>
</head>
<body>
<h1>Example</h1>
<p>Find Contacts</p>
</body>
</html>