constactOperate

来自于:开发者立即使用

概述

ContactsOperation是一个选择手机联系人的模块,以在h5页面中插入一个view的形式选择手机内联系人,返回联系人姓名和手机号,可多选单选,iPhone手机支持9.0系统版本以上

模块接口

input

input方法将view添加到页面中

input({params},callback(ret))

params

x:

  • 类型:整数类型
  • 描述:以左上角为原点 x轴偏移量。
  • 默认值:0
  • 取值范围: 0到屏幕宽。

y:

  • 类型:整数类型
  • 描述:以左上角为原点 y轴偏移量。
  • 默认值:0
  • 取值范围: 0到屏幕宽。

w:

  • 类型:整数类型
  • 描述:view 宽度 。
  • 默认值:宽度满屏
  • 取值范围: 0到屏幕宽。

h:

  • 类型:整数类型
  • 描述:view 高度 。
  • 默认值:高度满屏
  • 取值范围: 0到屏幕宽。

type:

  • 类型:整数类型
  • 描述:类型 1、单选 2、多选
  • 默认值:1
  • 取值范围: 1或2。

notice:

  • 类型:字符串
  • 描述:用户禁用权限或无联系人提示语 。

callback(ret,err)

ret:

  • 类型:JSON对象
  • 内部字段:

当type为1时候

{
   name:"",//String类型
   phone:""  //String类型
}

当type为1时候此方法不返回值

err:

  • 类型:JSON 对象
  • 内部字段:
{
    success: NO     //;布尔类型 NO失败 YES成功
    msg:您为打开通讯录权限     //字符串类型 错误提示

}

示例代码

var ConstactModule  = api.require('constactOperate');
var param = {
            x : 0,
            y : 0,
            w : 0,
            h : 0,
            type : 1,
            notice:'您未打开联系人权限或没有联系人'
        };
        ConstactModule.input(param, function(ret) {
            alert(JSON.stringify(ret));
        });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

隐藏view,已调用input情况下可调用此方法隐藏

hide()

示例代码

var ConstactModule = api.require('ConstactModule');
ConstactModule.hide();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

show

显示隐藏的view,调用input,hide 的情况下将原view对象重新显示,节省内存,无需重新创建

show()

示例代码

var ConstactModule = api.require('ConstactModule');
ConstactModule.show();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

destroy

在不使用此联系人view的情况下销毁释放内存 destroy()

示例代码

var ConstactModule = api.require('ConstactModule');
ConstactModule.destroy();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getSelect

input type=2的情况下多选返回多个联系人的数据

getSelect(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 内部字段:
{
    data:"[{\"name\":\"xxxx\",\"phone\":\"xxxx\"},{\"name\":\"xx\",\"phone\":\"xxxx\"}]"}" 
}

示例代码


var ConstactModule = api.require('ConstactModule');
ConstactModule.getSelect(function(ret) {
            alert(JSON.stringify(ret));
        });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

补充说明

云编译时注意勾选通讯录权限。