PhoneGap中文网

标题: phonegap查询设备通讯录数据库方法 contacts.find [打印本页]

作者: admin    时间: 2013-6-24 19:50
标题: phonegap查询设备通讯录数据库方法 contacts.find
contacts.find 查询设备通讯录数据库,并返回包含指定字段的一个或多个Contact对象。
  1. navigator.service.contacts.find(contactFields, contactSuccess, contactError, contactFindOptions);
复制代码
说明:
contacts.find是一个查询设备通讯录数据库并返回Contact对象数组的同步函数。返回的对象会被传递给contactSuccess回调函数的contactSuccess参数。
用户必须在contactFields参数中指定联系人的字段作为搜索限定符。系统传递给contactSuccess回调函数的Contact对象属性只会包含在contactFields参数中定义的字段。如果定义0长度的contactFields参数会导致返回的Contact对象只填充了id属性。
contactFindOptions.filter字符串可以用来作为查询通讯录数据库时的搜索过滤器。如果设定了该参数,系统会对通讯录数据库中所有联系人按照contactFields参数中指定的每个字段进行不区分大小写的部分值匹配。任何指定的字段符合过滤器所要求的内容的联系人数据都会被返回。
属性:

    contactFields:Contact字段,用作搜索限定符。在返回的Contact对象中只有这些字段有值。(DOMString[]类型)[必填]
    contactSuccess:通讯录获取成功时调用的回调函数,将从通讯录数据库获取的联系人作为参数。[必填]
    contactError:错误回调函数,当发生错误的时候被调用。[可选]
    contactFindOptions:用于过滤通讯录的搜索选项。[可选]


简单的范例:

  1. function onSuccess(contacts) {
  2.     alert('Found ' + contacts.length + ' contacts.');
  3. }

  4. function onError() {
  5.     alert('onError!');
  6. }

  7. // 从所有联系人中查找任意名字字段中包含“Bob”的联系人
  8. var options = new ContactFindOptions();
  9. options.filter="Bob";
  10. var fields = ["displayName", "name"];
  11. navigator.service.contacts.find(fields, onSuccess, onError, options);
复制代码
完整的范例:
  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <title>Contact Example</title>

  5. <script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
  6. <script type="text/javascript" charset="utf-8">

  7.     // PhoneGap加载完毕
  8.     function onDeviceReady() {

  9.         // 从所有联系人中查找任意名字字段中包含“Bob”的联系人
  10.         var options = new ContactFindOptions();
  11.         options.filter="Bob";
  12.         var fields = ["displayName", "name"];
  13.         navigator.service.contacts.find(fields, onSuccess, onError, options);
  14.     }

  15.     // onSuccess: 获取当前联系人结果集的快照
  16.     function onSuccess(contacts) {
  17.         for (var i=0; i<contacts.length; i++) {
  18.             console.log("Display Name = " + contacts[i].displayName);
  19.         }
  20.     }

  21.     // onError: 获得联系人失败
  22.     function onError() {
  23.         alert('onError!');
  24.     }

  25. </script>
  26. </head>
  27. <body>
  28. <h1>Example</h1>
  29. <p>Find Contact</p>
  30. </body>
  31. </html>
复制代码

作者: mywb6992    时间: 2014-2-20 19:46
现在都是navigator.contacts.find
作者: 0饕餮0    时间: 2014-12-24 13:31
树根老师,请问一下
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
这上面的phonegap.js,文件哪里有?,那个用命令下载的,很不稳定下不了,下着下着就停了




欢迎光临 PhoneGap中文网 (http://bbs.phonegap100.com/) Powered by Discuz! X3.2