|
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对象代表一个用户联系人。Contacts可以在设备通讯录数据库中被创建,存储或者删除,同样也可以使用 contacts.find方法从数据库中进行检索。
备注:并不是所有的设备平台都支持以上列出的所有联系人字段。请通过查看每个平台的特异情况描述部分,了解每个平台分别支持哪些字段。
Save 简单的范例: |
|