类型对象phonegap入门--10 Contacts
这两天朋友几篇文章绍介了改类型对象的文章. 关联文章的地址
在机手我们会问访机手的通讯录,这个时候须要应用phonegap供提的Contacts对象.
Contacts有两个方法create、find，估计大家一看就知道了，一个是建创联系人、一个是查找联系人。
create方法返回一个Contact对象，Contact对象上面再绍介。
var myContact = navigator.contacts.create({"displayName": "Test User"});
find方法：
navigator.contacts.find(contactFields, contactSuccess, contactError, contactFindOptions);
查询备设通讯录数据库，并返回含包指定字段的一个或多个Contact对象。
上面写一个例子码代，但是我在三星pad上测试，除删的时候老是错出，还望希大家测试一下。
<!DOCTYPE html>
<html>
<head>
<title>Contact Example</title>
<script type="text/javascript" charset="utf-8" src="cordova-2.6.0.js"></script>
<script type="text/javascript" charset="utf-8">
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
// create
var contact = navigator.contacts.create();
contact.displayName = "Plumber";
contact.nickname = "Plumber"; //specify both to support all devices
var name = new ContactName();
name.givenName = "Jane";
name.familyName = "Doe";
contact.name = name;
// save
contact.save(onSaveSuccess,onSaveError);
// clone
var clone = contact.clone();
clone.name.givenName = "John";
console.log("Original contact name = " + contact.name.givenName);
console.log("Cloned contact name = " + clone.name.givenName);
// remove 测试的时候老是这里报错
contact.remove(onRemoveSuccess,onRemoveError);
}
function onSaveSuccess(contact) {
alert("Save Success");
}
function onSaveError(contactError) {
alert("save Error = " + contactError.code);
}
function onRemoveSuccess(contacts) {
alert("Removal Success");
}
function onRemoveError(contactError) {
alert("Remove Error = " + contactError.code);
}
</script>
</head>
<body>
<h1>Example</h1>
<p>Find Contacts</p>
</body>
</html>
这里首先绍介一下Contact对象.
性属：
id：全局独一标识符。（DOMString类型）
displayname：联系人表现名称，合适向最终用户示展的联系人名称。（DOMString类型）
name：联系人姓名全部部份的对象。（CantactName类型）
nickname：昵称，对联系人的非正式呼称。（DOMString类型）
phoneNumbers：联系人全部联系电话的组数。（ContactField[]类型）
emails：联系人全部email地址的组数。（ContactField[]类型）
addrsses：联系人全部联系地址的组数。（ContactAddresses[]类型）
ims：联系人全部IM地址的组数。（ContactField[]类型）
organizations：联系人所属全部织组的组数。（ContactOrganization[]类型）
birthday：联系人的诞辰。（日期类型）
note：联系人的释注信息。（DOMString类型）
photos：联系人全部照片的组数.（ContactField[]类型）
categories：联系人所属的全部用户自定义类别的组数。（ContactField[]类型）
urls：与联系人相干网页的组数。（ContactField[]类型）
方法：
clone：返回一个新的Contact对象，它是调用对象的深度拷贝，其id性属被设为null。
remove：从通讯录数据库中除删联系人。当除删不成功的时候，发触以ContactError对象为参数的错误处理回调函数。
save：将一个新联系人存储到通讯录数据库，如果通讯录数据库中已含包与其ID同相的录记，则更新该已有录记。
在Contact中的name性属是一个ContactName类型的对象,在Contact开辟的进程还会应用其他的对象就不细详绍介了,大家可以看查官方文档,上面列出一些关联的对象
Contact ContactName ContactField ContactAddress ContactOrganization ContactFindOptions ContactError
再绍介一下find方法的两个性属:contactFields 、contactFindOptions
contactFields
contacts.find方法的必填参数，该参数定义了查找操纵返回的Contact对象中该应含包哪些字段。
contactFindOptions
contats.find方法的可选参数，通过该参数从通讯录数据库中筛选联系人。
写的好不，别拍砖啊。
文章结束给大家分享下程序员的一些笑话语录：
一边用着越狱的ip，一边拜乔帮主的果粉自以为是果粉，其实在乔帮主的眼里是不折不扣的叛徒。
