正文
手机联系人信息获取(contacts) ---- HTML5+
小程序：扫一扫查出行【扫一扫了解最新限行尾号】
复制小程序
模块：contacts
Contacts模块管理系统通讯录，用于可对系统通讯录进行增、删、改、查等操作。通过plus.contacts获取系统通讯录管理对象。
对象：联系人对象（属性：电话，地址等）针对它可以进行修改删除；
应用场景：查找联系人，导入联系人，通讯录备份，通讯录同步；
通讯录对象：AddressBook
interface AddressBook {
function Contact create();
function void find( contactFields, successCB, errorCB, findOptions );
}
AddressBook：里有个 create(); 创建方法；还有个 find() 方法;
find()；方法里的contactFields 查找返回联系人中需要包含的信息（查找的这个联系人包含的那些字段，例如只想要联系人的姓名和电话）这个是一个字符串数组；
finOptions：过滤条件：{logic:'or',field:'displayNam',value:'*王*'} 查找出来所有显示名和昵称有“王”的信息；
logic就是逻辑运算符，是“或”还是“与”的关系； or / and / not 它是json的对象数组；
获取通讯录对象：getAddressBook
plus.contacts.getAddressBook(type,succesCB,errorCB); 这个是查询通讯录的；
通讯录属性：type
id: 联系人的id
displayName: 联系人显示的名字
name: 联系人的名称
nickname: 联系人的昵称
phoneNumbers: 数组，联系人的电话
emails: 数组，联系人的邮箱
addresses: 数组，联系人的地址
ims: 数组，联系人的即时通讯地址
organizations: 数组，联系人所属组织信息
birthday: 联系人的生日
note: 联系人的备注
photos: 数组，联系人的头像
categories: 数组，联系人的组名
urls: 数组，联系人的网址
示例：添加联系人
mui.plusReady(function(){
var addressBookObj = null;
// 保证我们的addressBookObj 对象是存在的
plus.contacts.getAddressBook(plus.contacts.ADDRESSBOOK_PHONE,function(addressBook){
addressBookObj = addressBook;
// 添加联系人
$("#btnAddContac").bind('tap',function(){
plus.contacts.getAddressBook(plus.contacts.ADDRESSBOOK_PHONE,function(addressBook){
var contact = addressBookObj.create();
contact.name = {givenName:'张三'};
contact.phoneNumbers = {type:"手机",value:"1388888888",preferred:true};
contact.save();
mui.alert('添加成功');
},function(){});
});
},function(){});});
具体示例：添加联系人，查找联系人，删除联系人，修改联系人
<header class="mui-bar mui-bar-nav">
<a class="mui-action-back mui-icon mui-icon-left-nav mui-pull-left"></a>
<h1 class="mui-title">通讯录管理</h1>
</header>
<div class="mui-content mui-content-padded">
<button type="button" id="btnAddContac" class="mui-btn mui-btn-blue mui-btn-block">添加联系人</button>
<button type="button" id="btnDelContact" class="mui-btn mui-btn-blue mui-btn-block">删除联系人</button>
<button type="button" id="btnSearchContact" class="mui-btn mui-btn-blue mui-btn-block">查找联系人</button>
<button type="button" id="btnModifyContact" class="mui-btn mui-btn-blue mui-btn-block">修改联系人</button>
</div>
<script src='http://libs.baidu.com/jquery/1.8.3/jquery.min.js'></script>
<script src="js/mui.min.js"></script>
<script type="text/javascript">
mui.plusReady(function(){
var addressBookObj = null;
// 保证我们的addressBookObj 对象是存在的
plus.contacts.getAddressBook(plus.contacts.ADDRESSBOOK_PHONE,function(addressBook){
addressBookObj = addressBook;
// 添加联系人
$("#btnAddContac").bind('tap',function(){
plus.contacts.getAddressBook(plus.contacts.ADDRESSBOOK_PHONE,function(addressBook){
var contact = addressBookObj.create();
contact.name = {givenName:'张三'};
contact.phoneNumbers = {type:"手机",value:"1388888888",preferred:true};
contact.save();
mui.alert('添加成功');
},function(){});
});
// 查找联系人
$("#btnModifyContact").bind('tap',function(){
addressBookObj.find("",function(contacs){
//alert(contacs);
for(var i=0;i<contacs.length;++i){
alert(contacs[i].name.givenName);
};
},function(e){
console.log(e.message);
},{filter:[{logic:'and',field:'givenName',value:'*张*'}]});
});
// 修改联系人
$("#btnModifyContact").bind('tap',function(){
addressBookObj.find("",function(contacs){
//alert(contacs);
for(var i=0;i<contacs.length;++i){
contacs[i].name.givenName ="李四";
contacs[i].save();
};
mui.alert("修改成功");
},function(e){
console.log(e.message);
},{filter:[{logic:'and',field:'givenName',value:'*张*'}]});
});
// 删除联系人
$("#btnDelContact").bind('tap',function(){
addressBookObj.find("",function(contacs){
//alert(contacs);
for(var i=0;i<contacs.length;++i){
contacs[i].remove();
};
mui.alert("删除成功");
},function(e){
console.log(e.message);
},{filter:[{logic:'and',field:'givenName',value:'*李四*'}]});
});
},function(){});
});
</script>
