multiSelector

来自于:官方立即使用

概述

multiSelector 封装了一个支持多选的选择器,开发者可自定义该选择器的样式及其数据源 本模块已停止更新,建议使用UIMultiSelector

图片说明

open

打开选择器

open({params}, callback(ret, err))

params

y:

  • 类型:数字
  • 默认值:屏幕高度-244
  • 描述:(可选项)视图的起点y轴坐标

height:

  • 类型:数字
  • 默认值:244
  • 描述:(可选项)视图的高度

cancelImg:

  • 类型:字符串
  • 默认值:默认图片
  • 描述:(可选项)选择器左上角取消按钮的图片

enterImg:

  • 类型:字符串
  • 默认值:默认图片
  • 描述:(可选项)选择器右上角确定按钮的图片

titleImg:

  • 类型:字符串
  • 默认值:默认图片
  • 描述:(可选项)选择器工具栏的背景图片

bgImg:

  • 类型:字符串
  • 默认值:默认图片
  • 描述:(可选项)选择的背景图片

fontColor:

  • 类型:字符串
  • 默认值:#828282
  • 描述:(可选项)常态字体颜色,支持 rgb,rgba,#

selectedColor:

  • 类型:字符串
  • 默认值:#79CDCD
  • 描述:(可选项)选中字体颜色,支持 rgb,rgba,#

anim:

  • 类型:布尔值
  • 默认值:true
  • 描述:(可选项)打开关闭时是否添加动画

content:

  • 类型:数组
  • 默认值:无
  • 描述:选择器的内容

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

selectedItems:

  • 类型:数组
  • 默认值:无
  • 描述:(可选项)默认选中的条目的下标组成的数组,下标从0开始,-1表示全选
  • 备注:不传则 open 时未有选中项

selectIcon:

  • 类型:JSON 对象
  • 默认值:见内部字段
  • 描述:(可选项)表示选中、未选中的图标设置
  • 内部字段:
  {
       normal:        //(可选项)选中提示图标常态图片路径,支持fs、widget等本地路径协议,有默认图标
       selected:      //(可选项)选中后的图标路径,支持fs、widget等本地路径协议,有默认图片
  }

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    selectAry:             //选中的字符串组成的数组 deprecate
    selectArray:           //选中的字符串组成的数组
}

示例代码

var multiSelector = api.require('multiSelector');
multiSelector.open({
    content: [
        '第一条',
        '第二条',
        '第三条'
    ],
    fixedOn: api.frameName
}, function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

补充说明

打开选择器

可用性

iOS系统 android系统

可提供的1.0.0及更高版本

setSelect

设置/取消选中条目

setSelect({params})

params

indexs:

  • 类型:数组
  • 默认值:-1
  • 描述:(可选项)设置要选中的条目的下标组成的数组(若该条目为已选中状态则会取消其选中状态),下标从0开始,-1表示全选

示例代码

var multiSelector = api.require('multiSelector');
multiSelector.setSelect({
    index: [-1]
});

补充说明

可用性

iOS系统 android系统

可提供的1.0.1及更高版本

close

关闭选择器

close()

示例代码

var multiSelector = api.require('multiSelector');
multiSelector.close();

补充说明

关闭选择器

可用性

iOS系统 android系统

可提供的1.0.1及更高版本

show

显示选择器

show()

示例代码

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

补充说明

可用性

iOS系统 android系统

可提供的1.0.1及更高版本

hide

隐藏选择器

hide()

示例代码

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

补充说明

可用性

iOS系统 android系统

可提供的1.0.1及更高版本