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

补充说明

应用打包时注意勾选通讯录权限。

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18