constactOperate

来自于：开发者立即使用

input hide show destroy getSelect

论坛示例

为帮助用户更好更快的使用模块，论坛维护了一个示例，示例中包含示例代码供您参考。

概述

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及更高版本

补充说明

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