Contacts(联系人)phonegap中文API(

Contacts（联系人）在交往对象提供对设备的访问联系人数据库。方法contacts.createcontacts.find参数contactFieldscontactSuccesscontactErrorcontactFindOptions对象ContactContactNameContactFieldContactAddressContactOrganizationContactFindOptionsContactErrorcontacts.create返回一个新的联系对象。varcontact=navigator.service.contacts.create(properties);说明contacts.create是一个同步函数，返回一个新的联系对象。这种方法不存在的联系对象到设备联系人数据库。要坚持的联系对象到设备，调用联系。保存方法。支持的平台AndroidBlackBerryWebWorks（操作系统5.0和更高版本）iOS简单的例子varmyContact=navigator.service.contacts.create({displayName:TestUser});完整的例子!DOCTYPEHTMLPUBLIC-//W3C//DTDHTML4.01//EN=text/javascriptcharset=utf-8src=phonegap.js/scriptscripttype=text/javascriptcharset=utf-8//WaitforPhoneGaptoload//functiononLoad(){document.addEventListener(deviceready,onDeviceReady,false);}//PhoneGapisready//functiononDeviceReady(){varmyContact=navigator.service.contacts.create({displayName:TestUser});myContact.gender=male;console.log(Thecontact,+myContact.displayName+,isofthe+myContact.gender+gender);}/script/headbodyonload=onLoad()h1Example/h1pCreateContact/p/body/htmlcontacts.find查询设备联系人数据库，并返回一个或多个联系对象，每个包含字段中指定。navigator.service.contacts.find(contactFields,contactSuccess,contactError,contactFindOptions);说明contacts.find是一个异步函数，查询设备联系人数据库，并返回一个数组的联系对象。由此产生的对象被传递给contactSuccess回调函数指定contactSuccess参数。用户必须指定联系人字段是作为限定在搜索contactFields参数。只有在字段中指定contactFields参数将返回的属性作为联系的对象传递给contactSuccess回调函数。一个零长度contactFields参数将导致数组联系的对象，只有身份证填充属性。该contactFindOptions。过滤字符串可以被用来作为搜索过滤器时，查询联系人数据库。如果提供，不区分大小写，部分值匹配应用到指定的每个字段contactFields参数。如果匹配是一个比较发现任何指定的领域，接触被返回。参数contactFields：联系人字段用作搜索预选赛。只有这些领域将有结果值的联系对象。（DOMString[]）[必需的]contactSuccess：成功回调函数，从数据库调用的接触与交往返回。[必需的]contactError：错误回调函数。发生错误时调用。[可选]contactFindOptions：搜索选项来过滤接触。[可选]支持的平台AndroidBlackBerryWebWorks（操作系统5.0和更高版本）iOS简单的例子functiononSuccess(contacts){alert('Found'+contacts.length+'contacts.');};functiononError(){alert('onError!');};//findallcontactswith'Bob'inanynamefieldvaroptions=newContactFindOptions();options.filter=Bob;varfields=[displayName,name];navigator.service.contacts.find(fields,onSuccess,onError,options);完整的例子!DOCTYPEHTMLPUBLIC-//W3C//DTDHTML4.01//EN=text/javascriptcharset=utf-8src=phonegap.js/scriptscripttype=text/javascriptcharset=utf-8//WaitforPhoneGaptoload//functiononLoad(){document.addEventListener(deviceready,onDeviceReady,false);}//PhoneGapisready//functiononDeviceReady(){//findallcontactswith'Bob'inanynamefieldvaroptions=newContactFindOptions();options.filter=Bob;varfields=[displayName,name];navigator.service.contacts.find(fields,onSuccess,onError,options);}//onSuccess:Getasnapshotofthecurrentcontacts//functiononSuccess(contacts){for(vari=0;icontacts.length;i++){console.log(DisplayName=+contacts[i].displayName);}}//onError:Failedtogetthecontacts//functiononError(){alert('onError!');}/script/headbodyonload=onLoad()h1Example/h1pFindContacts/p/body/htmliOS怪癖iOS中返回数组属性没有结果无效，其他平台返回一个空数组。Contact包含的属性描述一接触，如用户的个人或商业联系。属性id：一个全局唯一标识符。（DOMString）displayname：该名称本联系合适的显示给最终用户。，（DOMString）name：一个对象，它包含一个人所有组件的名称。（ContactName）Nickname：一个偶然的名称，以解决联系的。（DOMString）Phonenumbers：一个数字的数组的所有联系人的电话。（ContactField[]）Emails：一个地址的数组的所有联系人的电子邮件。（ContactField[]）Addresses：地址数组的所有联系人。（ContactAddresses[]）Ims：一个地址的数组的所有联系人的聊天室。（ContactField[]）Organizations：一个组织的数组的所有联系人。（ContactOrganization[]）Revision：最后日期接触进行了修订。（DOMString）Birthday：接触寿辰。（日期）Gender：性别的接触。（DOMString）Note：一个联系注意到有关。（DOMString）Photos：照片阵列中的一个联系人。（ContactField[]）Categories：一个用户的所有联系人的数组定义的类别。（ContactField[]）Urls：数组。接触到相关网页（ContactField[]）Timezone：时区的conact的。（DOMString）方法Cone：返回一个新的联系对象，它是调用对象的深层副本到，ID属性设定为空。remove：删除数据库与从设备联系人。错误回调被称为一个ContactError对象如果去除是不成功的。Seve：保存一个新的联系人到设备上的联系人数据库，或更新现有的联系，如果同一个接触的ID已经存在。详情在联系对象表示用户的联系。联系人可以创建，保存，或数据库中删除从设备接触。联系，也可以检索到散装）从数据库（个别或通过调用contacts.find方法。注意：并非所有上述领域的接触是每一个支持的设备平台。请检查每个平台的怪癖信息部分有关的字段都支持。支持的平台AndroidBlackBerryWebWorks（操作系统5.0和更高版本）iOS保存快速范例functiononSuccess(contacts){alert(SaveSuccess);};functiononError(contactError){alert(Error=+contactError.code);};//createanewcontactobjectvarcontact=navigator.service.contacts.create();contact.displayName=Plumber;contact.nickname=Plumber;//specifybothtosupportalldevices//populatesomefieldsvarname=newContactName();name.givenName=Jane;name.familyName=Doe;contact.name=name;//savetodevicecontact.save(onSuccess,onError);克隆快速范例//克隆对象的接触//clonethecontactobjectvarclone=contact.clone();clone.name.givenName=John;console.log(Originalcontactname=+contact.name.givenName);console.log(Clonedcontactname=+clone.name.givenName);删除快速范例functiononSuccess(){alert(RemovalSuccess);};functiononError(contactError){alert(Error=+contactError.code);};//removethecontactfromthedevicecontact.remove(onSuccess,onError);完整的例子!DOCTYPEHTMLPUBLIC-//W3C//DTDHTML4.01//EN