customSelector

open

set

close

hide

show

概述

customSelector 是自定义分级选择器插件，开发者可自定义选择器的大小、位置、内容级别（Android 暂仅最大支持3级）和数据源及其显示样式，可设置指定选中项。本插件是由第三方插件开发者提供，使用此插件需在线应用打包安装包。本插件已停止优化更新，建议使用UISelector

图片说明

open

打开选择器

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

params

x：

  • 类型：数字
  • 默认值：当前设备屏幕宽度除以4.0
  • 描述：（可选项）选择器视图左上角点坐标

y：

  • 类型：数字
  • 默认值：0
  • 描述：（可选项）选择器视图左上角点坐标

w：

  • 类型：数字
  • 默认值：当前设备屏幕的宽度除以2.0
  • 描述：（可选项）选择器视图宽

h：

  • 类型：数字
  • 默认值：当前设备屏幕的高度减80
  • 描述：（可选项）选择器视图高

bg：

  • 类型：字符串
  • 默认值：rgba(0,0,0,0)
  • 描述：（可选项）视图背景设置，支持 rgb、rgba、#、img

style：

  • 类型：JSON 对象
  • 默认值：见内部字段
  • 描述：（可选项）设置选择器的样式
  • 内部字段：
{
    row：                        //数字类型，每列显示的行数，默认7，可为空
        text:{
            size:                //字体大小，数字类型，默认50，可为空
            selectedColor:       //选中色，字符串，支持 rgb,rgba,#,默认#ffffff，可为空
            color:               //常态文字颜色，字符串，支持 rgb,rgba,#,默认#218868，可为空
            }
        bg:{
            color:               //常态背景色，字符串，支持 rgb,rgba,#,默认#87ceeb,可为空
               selectedColor:       //选中后的背景色,字符串,支持 rgb,rgba,#,默认,#218868可为空
            rect:                //背景视图在选择器单元格内的位置大小信息,json对象，可为空
               {
                w:               //背景视图的宽，默认单元格宽-20，可为空
                h:               //背景视图的高，默认单元格高-20，可为空
            },
            zoomIn：             //选中后放大倍数，数字类型，默认1.2，可为空
    }
}

dataSource：

  • 类型：数组对象/字符串
  • 默认值：无
  • 描述：选择器的数据源，若为字符串，则表示 JSON 文件的路径(支持widget,fs等协议)，文件格式同下文内部字段
  • 内部字段：
[{
      title:   		    //一级目录的标题，字符串，不可为空
      contents:		    //一级目录的内容组成的数组，可为字符串或json对象，不可为空        
      [{                //此内容若是字符串组成的数组，则表示该选择器为二级选择器，若本字段内容是json对象组成的数组，则表示该选择器为三级选择器，最高支持到三级，json对象的内部字段如下：
            title：     //二级目录的标题列表，字符串，不可为空
            contents：  //三级目录的内容组成的数组，数组类型，不可为空
       }]
}]

fixedOn：

  • 类型：字符串类型
  • 描述：（可选项）插件视图添加到指定 frame 的名字（只指 frame，传 window 无效）
  • 默认：插件依附于当前 window

indexs：

  • 类型：数组
  • 默认值：每列的第一条数据
  • 描述：（可选项）设置的各列 item 的下标(不可超过本列 item 总数)组成的数组

bounce：

  • 类型：布尔
  • 默认值：true
  • 描述：（可选项）列表滑动到头是否弹动

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    status:             //布尔值，操作是否成功
    selects:            //从各级目录选取的内容组成的数组，若本选择器是自定义的二级选择器，则此数组包含两个元素，若本选择器是自定义的三级选择器，则此数组包含三个元素
}

err：

  • 类型：JSON 对象
  • 内部字段：
{
    msg:               //错误信息，字符串类型
}

示例代码

var customSelector = api.require('customSelector');
customSelector.open({
    dataSource: [{
        title: 'A',
        contents: [{
            title: 'a',
            contents: ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10']
        }]
    }, {
        title: 'B',
        contents: ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j']
    }, {
        title: 'C',
        contents: ['1a', '2b', '3c', '4d', '5e', '6f', '7g', '8h', '9i', '10j']
    }, {
        title: 'D',
        contents: ['1t', '2t', '3t', '4t', '5t', '6t', '7t', '8t', '9t', '10t']
    }, {
        title: 'E',
        contents: ['1a', '2a', '3a', '4a', '5a', '6a', '7a', '8a', '9a', '10a']
    }, {
        title: 'F',
        contents: ['1f', '2f', '3f', '4f', '5f', '6f', '7f', '8f', '9f', '10f']
    }, {
        title: 'G',
        contents: ['1!', '2!', '3!', '4!', '5!', '6!', '7!', '8!', '9!', '10!']
    }, {
        title: 'H',
        contents: ['1th', '2th', '3th', '4th', '5th', '6th', '7th', '8th', '9th', '10th']
    }, {
        title: 'I',
        contents: ['one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten']
    }, {
        title: 'J',
        contents: ['壹', '貮', '叁', '肆', '伍', '陆', '柒', '捌', '玖', '拾']
    }, {
        title: 'K',
        contents: ['一', '二', '三', '四', '五', '六', '七', '八', '九', '十']
    }]
}, function(ret, err) {
    if (ret.status) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

补充说明

初始化选择器，并打开

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

set

设置选择器选中的 items

set({params})

params

indexs：

  • 类型：数组
  • 默认值：无
  • 描述：设置的各列 item 的下标(不可超过本列 item 总数)组成的数组

示例代码

var customSelector = api.require('customSelector');
customSelector.set({
    indexs: [2, 3, 6]
});

补充说明

设置选中状态

可用性

iOS 系统

可提供的1.0.0及更高版本

close

关闭选择器

close()

示例代码

var customSelector = api.require('customSelector');
customSelector.close();
```js

## 补充说明

关闭时间选择器

## 可用性

iOS 系统

可提供的1.0.0及更高版本


# **hide**<div id="4"></div>

隐藏选择器

hide()

## 示例代码

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


## 补充说明

隐藏选择器，并没有从内存里清除

## 可用性

iOS 系统

可提供的1.0.1及更高版本


# **show**<div id="5"></div>

显示选择器

show()

## 示例代码

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

```js

补充说明

显示已隐藏的选择器

可用性

iOS 系统

可提供的1.0.1及更高版本

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