UIPickerView

来自于:开发者立即使用

概述

UIPickerView 此模块封装了三级滚轮的UI效果(不联动)。

open

打开 UIPickerView 模块

open({params}, callback(ret))

params

datas:

  • 类型:JsonObject
  • 描述:数据源,最多时是三个滚轮的数据,dataOne是第一个滚轮数据源:必传字段.当dataOne有数据,dataTwo,dataThree可以不传,
  • dataTwo 是第二个滚轮数据源:此时dataOne必须有数据,dataThree可以不传
  • dataThree是第三个滚轮数据源:dataOne和必dataTwo须有数据
  • 内部字段:

 {
    dataOne:[{
             text: 'dataOne1', // 字符串类型;列表中显示的文本
             },{
             text: 'dataOne2',
             },{
            text: 'dataOne3', 
             },{
             text: 'dataOne4',
            }],
    dataTwo: [{
             text: 'dataTwo1',           
             },{
             text: 'dataTwo2',
            }], 
   dataThree: [{
             text: 'dataThree1', 
             },{
             text: 'dataThree2',
            }]
          }

styles:

  • 类型:JSON对象
  • 描述:(可选项)模块各部分的样式
  • 内部字段:
{
    setTitleText: '请选择',        //(可选项)字符串类型:标题文本,默认不显示
    setTitleColor: '#121212',     //(可选项)字符串类型;标题文本颜色;默认:#121212
    setTitleBgColor: '#969696',   // (可选项)字符串类型;设置标题栏区域的背景色;默认:#969696
    setCancelText: '取消',         // (可选项)字符串类型;标题栏区域左侧关闭弹框的提示文本;默认:取消
    setCancelColor: '#FFFFFF',    // (可选项)字符串类型;标题栏区域左侧关闭弹框的提示文本颜色;默认:#FFFFFF
    setSubmitText: '确认',         // (可选项)字符串类型;标题栏区域右侧确认选中的提示文本;默认:确认
    setSubmitColor: '#FFFFFF',    // (可选项)字符串类型;标题栏区域右侧确认选中的提示文本颜色;默认:#FFFFFF
    setContentTextSize: 12,       // (可选项)字符串类型;设置滚轮显示文字大小;默认:12
    setBgColor: '#F0F8FF',        // (可选项)字符串类型;设置轮子的背景区域;,默认:#F0F8FF
    setDividerColor: '#0D0D0D',   // (可选项)字符串类型;设置分隔线的颜色;默认:#0D0D0D
    setTextColorCenter: '#000000',// (可选项)字符串类型;滑到选中位置后的文本颜色;;默认:#000000  **iOS不支持此字段**
    setTextColorOut:'#8A8A8A',    // (可选项)字符串类型;滑到非选中位置后的文本颜色;默认:#8A8A8A 
}

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:
  • 内部字段:
{
    dataOne: '滚轮1',                // 字符串类型,滚轮一选中的数据返回
    dataTwo: '滚轮2',                // 字符串类型,滚轮二选中的数据返回
    dataThree: '滚轮3',            // 字符串类型, 滚轮三选中的数据返回
}

示例代码


var UIPickerView = api.require('UIPickerView');
UIPickerView.open({
  datas :{
       dataOne:[{
                 text: 'dataOne1',
                 },{
                 text: 'dataOne2',
                 },{
                text: 'dataOne3',
                 },{
                 text: 'dataOne4',
                }],
       dataTwo:[{
                text: 'dataTwo1',
                },{
                text: 'dataTwo2',
               }],
       dataThree:[{
             text: 'dataThree1',
              },{
               text: 'dataThree2',
              }]
          },
       styles:{
           setTitleText: '测试',             
           setTitleColor: '#121212',        
           setTitleBgColor: '#969696',    
           setCancelText: '关闭',            
           setCancelColor: '#FFFFFF',    
           setSubmitText: '确认1',    
           setSubmitColor: '#FFFFFF',    
           setContentTextSize: 12,                 
           setBgColor: '#F0F8FF',          
           setDividerColor: '#0D0D0D',
           setTextColorCenter: '#000000',
           setTextColorOut:'#8A8A8A',        
           }
           },function( ret ){
           api.alert( {msg:JSON.stringify( ret )});
              });

可用性

iOS,android系统

可提供的1.0.0及更高版本