类型对象phonegap入门--10 Contacts

最新推荐文章于 2025-09-11 20:53:34 发布

weixin_34413357

最新推荐文章于 2025-09-11 20:53:34 发布

阅读量1.1k

点赞数

文章标签：数据库 javascript ViewUI

本文详细介绍了如何使用PhoneGap提供的Contacts对象来管理手机通讯录，包括创建、查找、保存、克隆和删除联系人。同时分享了一个实例代码，并提供了Contact对象的相关属性和方法说明。

这两天朋友几篇文章绍介了改类型对象的文章. 关联文章的地址

在机手我们会问访机手的通讯录,这个时候须要应用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，一边拜乔帮主的果粉自以为是果粉，其实在乔帮主的眼里是不折不扣的叛徒。