PhoneGapAPI帮助文档翻译整理6Contacts通讯录文档格式.docx
- 文档编号:17228781
- 上传时间:2022-11-29
- 格式:DOCX
- 页数:22
- 大小:25.84KB
PhoneGapAPI帮助文档翻译整理6Contacts通讯录文档格式.docx
《PhoneGapAPI帮助文档翻译整理6Contacts通讯录文档格式.docx》由会员分享,可在线阅读,更多相关《PhoneGapAPI帮助文档翻译整理6Contacts通讯录文档格式.docx(22页珍藏版)》请在冰豆网上搜索。
displayName"
:
"
TestUser"
});
完整的例子
<
!
DOCTYPEHTMLPUBLIC"
-//W3C//DTDHTML4.01//EN"
http:
//www.w3.org/TR/html4/strict.dtd"
>
html>
<
head>
title>
ContactExample<
/title>
scripttype="
text/javascript"
charset="
utf-8"
src="
phonegap.js"
/script>
//WaitforPhoneGaptoload
//
functiononLoad(){
document.addEventListener("
deviceready"
onDeviceReady,false);
}
//PhoneGapisready
functiononDeviceReady(){
varmyContact=navigator.service.contacts.create({"
myContact.gender="
male"
;
console.log("
Thecontact,"
+myContact.displayName+"
isofthe"
+myContact.gender+"
gender"
);
/head>
bodyonload="
onLoad()"
h1>
Example<
/h1>
p>
CreateContact<
/p>
/body>
/html>
contacts.find
查询设备联系人数据库,并返回一个或多个
对象,每个包含字段中指定。
navigator.service.contacts.find(contactFields,contactSuccess,contactError,contactFindOptions);
contacts.find
是一个异步函数,查询设备联系人数据库,并返回一个数组的
由此产生的对象被传递给
contactSuccess
回调函数指定
参数。
用户必须指定联系人字段是作为限定在搜索
contactFields
只有在字段中指定
参数将返回的属性作为
联系的对象传递给
回调函数。
一个零长度
参数将导致数组
的对象,只有
身份证
填充属性。
该
contactFindOptions
。
过滤
字符串可以被用来作为搜索过滤器时,查询联系人数据库。
如果提供,不区分大小写,部分值匹配应用到指定的每个字段
如果匹配是一个比较发现
任何
指定的领域,接触被返回。
∙contactFields
:
联系人
字段用作搜索预选赛。
只有这些领域将有结果值的
(DOMString[])
[必需的]
∙contactSuccess
成功回调函数,从数据库调用的接触与交往返回。
∙contactError
错误回调函数。
发生错误时调用。
[可选]
∙contactFindOptions
搜索选项来过滤接触。
functiononSuccess(contacts){
alert('
Found'
+contacts.length+'
contacts.'
};
functiononError(){
onError!
'
//findallcontactswith'
Bob'
inanynamefield
varoptions=newContactFindOptions();
options.filter="
Bob"
varfields=["
"
name"
];
navigator.service.contacts.find(fields,onSuccess,onError,options);
//findallcontactswith'
varoptions=newContactFindOptions();
options.filter="
varfields=["
navigator.service.contacts.find(fields,onSuccess,onError,options);
//onSuccess:
Getasnapshotofthecurrentcontacts
functiononSuccess(contacts){
for(vari=0;
i<
contacts.length;
i++){
DisplayName="
+contacts[i].displayName);
//onError:
Failedtogetthecontacts
functiononError(){
FindContacts<
iOS怪癖
∙iOS中返回数组属性没有结果无效,其他平台返回一个空数组。
Contact
包含的属性描述一接触,如用户的个人或商业联系。
属性
∙id:
一个全局唯一标识符。
(DOMString)
∙displayname:
名称
本
合适的显示给最终用户。
,
∙name
一个对象,它包含一个人所有组件的
(
ContactName
)
∙Nickname:
一个偶然
的名称
,以解决联系的。
∙Phonenumbers:
一个数字的数组的所有联系人的电话。
ContactField
[])
∙Emails:
一个地址的数组的所有联系人的电子邮件。
∙Addresses:
地址数组的所有联系人。
(ContactAddresses[])
∙Ims:
一个地址的数组的所有联系人的聊天室。
∙Organizations:
一个组织的数组的所有联系人。
ContactOrganization
∙Revision:
最后日期接触进行了修订。
∙Birthday:
接触寿辰。
(日期)
∙Gender:
性别的接触。
∙Note:
一个联系注意到有关。
∙Photos:
照片阵列中的一个联系人。
∙Categories:
一个用户的所有联系人的数组定义的类别。
∙Urls:
数组。
接触到相关网页
∙Timezone:
时区的conact的。
∙Cone
返回一个新的
对象,它是调用对象的深层副本到,ID属性设定为
空
remove:
删除数据库与从设备联系人。
错误回调被称为一个
ContactError
对象如果去除是不成功的。
∙Seve:
保存一个新的联系人到设备上的联系人数据库,或更新现有的联系,如果同一个接触
的ID
已经存在。
详情
在
对象表示用户的联系。
可以创建,保存,或数据库中删除从设备接触。
,也可以检索到散装)从数据库(个别或通过调用
方法。
注意:
并非所有上述领域的接触是每一个支持的
设备平台
请检查每个平台的怪癖信息部分有关的字段都支持。
保存快速范例
alert("
SaveSuccess"
functiononError(contactError){
Error="
+contactError.code);
//createanewcontactobject
varcontact=navigator.service.contacts.create();
contact.displayName="
Plumber"
contact.nickname="
//specifybothtosupportalldevices
//populatesomefields
varname=newContactName();
name.givenName="
Jane"
name.familyName="
Doe"
contact.name=name;
//savetodevice
contact.save(onSuccess,onError);
克隆快速范例
//克隆对象的接触
//clonethecontactobject
varclone=contact.clone();
clone.name.givenName="
John"
console.log("
Originalcontactname="
+contact.name.givenName);
Clonedcontactname="
+clone.name.givenName);
删除快速范例
functiononSuccess(){
RemovalSuccess"
//removethecontactfromthedevice
contact.remove(onSuccess,onError);
//create
varcontact=navigator.service.contacts.create();
contact.displayName="
contact.nickname="
varname=newContactName();
name.givenName="
name.familyName="
contact.name=name;
//save
contact.save(onSaveSuccess,onSaveError);
//clone
varclone=contact.clone();
clone.name.givenName="
//remove
contact.remove(onRemoveSuccess,onRemoveError);
//onSaveSuccess:
functiononSaveSuccess(contacts){
//onSaveError:
functiononSaveError(contactError){
//onRemoveSuccess:
functiononRemoveSuccess(contacts){
//onRemoveError:
functiononRemoveError(contactError){
Android的2.X的怪癖
∙revision:
不支持此属性是由Android2.x的设备,而且将永远是为返回
∙gender:
∙categories:
∙timezone:
Android的1.X的怪癖
∙name:
不支持此属性是由Android1.x设备,而且将永远是为返回
BlackBerryWebWorks(操作系统5.0和更高版本)怪癖
∙Id:
支持。
设备分配时接触被保存。
∙Displayname:
存储在黑莓
user1的
领域。
此属性是不支持,而且将永远是为返回
部分支持。
电话号码字段中存储将在BlackBerry
homePhone1
和
homePhone2
如果
类型
是'
家'
,workPhone1
workPhone2
工作'
手机
移动'
faxPhone
真'
pagerPhone如果
寻呼机'
otherPhone
是上面没有的。
前三个电子邮件地址将被存储在BlackBerry
email1
email2
email3
领域,分别为。
第一和第二地址将存储在黑莓
是homeAddress
招聘人数
等领域,分别为。
∙IMS:
这个属性是不支持,而且将永远是为返回
的
标题
的第一个组织都存储在黑莓
公司
字段,分别为。
不支持此属性,而且将永远是为返回
-部分支持。
单一缩略图大小的照片的支持。
要设置一个联系人的照片,无论是传递一个Base64编码的图像,或者一个URL指向图像。
图像将被保存之前缩小到BlackBerry联系人数据库。
接触照片的形式返回Base64编码的图像。
只有'
商'
和'
个人'
类别的支持。
第一个URL存储在黑莓
网页
不支持此属性是由内部监督办公室,将作为返回
,除非没有
联系人姓名
指定。
如果没有
,然后复合
nickame
或“”是返回
的displayName
分别。
此属性是只输出,不能修改。
它返回为一个JavaScriptDate对象。
对于输入,此属性必须提供一个JavaScriptDate对象。
不支持此属性是内部监督办公室的设备,而且将永远是为返回
返回的照片是存储在应用程序的临时目录和
文件
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- PhoneGapAPI 帮助 文档 翻译 整理 Contacts 通讯录