下载文档

uexWheelPickView
更新时间:2016-05-10

1、简介

通用选择器插件

1.1、说明

该插件为通用选择器插件,是三级联动结构,支持数据源自定义和默认选中数据源,最多支持自定义三个级别的选择数据,但格式要符合要求,具体见下面。点击确认后返回选中数据源和其所在列的索引值。

1.2、UI展示

1.3、开源源码

插件测试用例与源码下载:点击 插件中心至插件详情页 (插件测试用例与插件源码已经提供)

2、API概览

2.1、方法

open 打开选择器

uexWheelPickView.open(params)

说明:

通过此方法打开选择器,进入选择器界面。

参数:

  1. var params ={
  2. x:,
  3. y:,
  4. width:,
  5. height:,
  6. src:,
  7. select:[]
  8. }

各字段含义如下:

参数名称 参数类型 是否必选 说明
x Number 距离屏幕左边距离
y Number 距离屏幕顶部距离
width Number
height Number
src String 传入的数据源(json)的路径
select Array 选中数据源所在列的索引值,默认从0开始
  1. 注意:json数据源的格式示例如下(namesub为关键字,不可改动):
  2. [
  3. {"name":"湖北省","sub":[{"name":"武汉市","sub":["武昌区","洪山区","江汉区","江夏区"]},{"name":"宜昌市","sub":["夷陵区","西陵区","伍家岗","白龙岗"]},{"name":"襄阳市","sub":["樊城区","襄城区"," 襄州区","鱼梁洲"]}]},
  4. {"name":"湖南省","sub":[{"name":"长沙市","sub":["天心区","芙蓉区","开福区","雨花区"]},{"name":"株洲市","sub":["天元区","荷塘区","石峰区"]},{"name":"湘潭市","sub":["岳塘区","雨湖区"]}]},
  5. {"name":"江苏省","sub":[{"name":"南京市","sub":["下关区","玄武区","鼓楼区","秦淮区"]},{"name":"苏州市","sub":["吴中区","平江区","沧浪区","虎丘区"]},{"name":"徐州市","sub":["云龙区","泉山区","铜山区","鼓楼区"]}]},
  6. ...
  7. ]
  8. 特别说明,如:select:[1,2,0],代表:湖南省-湘潭市-岳塘区

平台支持:
Android2.2+
iOS6.0+

版本支持:
Android3.0.0+
iOS3.0.0+

示例:

  1. var params = {
  2. x:0,
  3. y:100,
  4. width:window.screen.width,
  5. height:300,
  6. src:"res://test.json",
  7. select:[13,3,0]
  8. };
  9. uexWheelPickView.open(JSON.stringify(params));

close 关闭选择器

uexWheelPickView.close();

说明:

通过此方法关闭选择器。

参数:

平台支持:
Android2.2+
iOS6.0+

版本支持:
Android3.0.0+
iOS3.0.0+

示例:

  1. uexWheelPickView.close();

2.2、监听方法

onConfirmClick 对确认按钮的监听方法

uexWheelPickView.onConfirmClick(result)

参数:

  1. var result ={
  2. data:[],
  3. index:[]
  4. }

各字段含义如下:

参数名称 参数类型 是否必选 说明
data Array 选中数据源的值
index Array 选中数据源所在列的索引值,默认从0开始

平台支持:
Android2.2+
iOS6.0+

版本支持:
Android3.0.0+
iOS3.0.0+

示例:

  1. window.uexOnload = function() {
  2. uexWheelPickView.onConfirmClick = function(result){
  3. alert(result);
  4. }
  5. }

3、更新历史

iOS

API版本:uexWheelPickView-3.0.1

最近更新时间:2016-5-10

历史发布版本 更新内容
3.0.1 新增默认值选项
3.0.0 通用选择器插件

Android

API版本:uexWheelPickView-3.0.1

最近更新时间:2016-5-10

历史发布版本 更新内容
3.0.1 新增默认值选项,点击”确定”按钮时,关闭选择器
3.0.0 通用选择器插件