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时候

  1. {
  2. name:"",//String类型
  3. phone:"" //String类型
  4. }

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

err:

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

示例代码

  1. var ConstactModule = api.require('constactOperate');
  2. var param = {
  3. x : 0,
  4. y : 0,
  5. w : 0,
  6. h : 0,
  7. type : 1,
  8. notice:'您未打开联系人权限或没有联系人'
  9. };
  10. ConstactModule.input(param, function(ret) {
  11. alert(JSON.stringify(ret));
  12. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

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

hide()

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

show

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

show()

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

destroy

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getSelect

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

getSelect(callback(ret))

callback(ret)

ret:

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

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

补充说明

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