UIDatePickerTool

概述

UIDatePickerTool 是一个日期选择器,可选择三十天内时间。

open

打开选择器

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

params

rowHeight:

  • 类型:数字
  • 描述:(可选项)设置选择器的行高
  • 默认值:40

styles:

  • 类型:JSON 对象
  • 描述:(可选项)插件各部分的样式
  • 内部字段:
{
    bg: 'rgba(0,0,0,0)',     //(可选项)字符串类型;插件背景,支持 rgb、rgba、#;默认:'#FFFFFF'
    headerViewBackgroundColor: 'rgba(0,0,0,0)',     //(可选项)字符串类型;设置头部的背景颜色,支持 rgb、rgba、#;默认:'#FFFFFF'
    lineBackgroundColor: 'rgba(0,0,0,0)',     //(可选项)字符串类型;设置线条的颜色,支持 rgb、rgba、#;默认:'#cccccc'
    item:{                   //(可选项)JSON对象;item 样式;默认值见内部字段
      normal: '#f00',     //(可选项)字符串类型;常态字体色,支持 rgb、rgba、#;默认:‘#000000’
      normalFont: 14            //(可选项)数字类型;常态字体大小,;默认值:14
      selected: '#000079',   //(可选项)字符串类型;选中后的字体色,支持 rgb、rgba、#
      cancelBtn:{
      	 cancelButtonTextColor: '#1E1E1E',   //(可选项)字符串类型;设置取消按钮的字体颜色,支持 rgb、rgba、#;默认值:#1E1E1E
         cancelButtonText: 'cancel' ,         //(可选项)字符串类型;设置取消按钮的字,;默认值:'cancel'
         cancelButtonFont:17                  //(可选项)数字类型;设置取消按钮的字体大小,;默认值:17
         cancelButtonImage:''                 //(可选项)字符串类型;设置取消按钮的图片,与cancelButtonText互斥,只能存在一个
    
    },
    confirmBtn:{
        confirmButtonTextColor: '#1E1E1E',   //(可选项)字符串类型;设置确定按钮的字体颜色,支持 rgb、rgba、#;默认值:#1E1E1E
          confirmButtonText: 'confirm' ,         //(可选项)字符串类型;设置确定按钮的字,;默认值:'confirm'
        confirmButtonFont:17                  //(可选项)数字类型;设置确定按钮的字体大小,;默认值:17
        confirmButtonImage:''                 //(可选项)字符串类型;设置确定按钮的图片,与confirmButtonText互斥,只能存在一个
    }
    },
     bottomButton{         //(可选项)JSON对象类型;底部按钮设置;默认不显示此按钮
        bg:'',            //(可选项)字符串类型;底部按钮背景颜色,支持rgb,rgba,#;
        height:,        //(可选项)数字类型;底部按钮高度;默认:根据textSize自适应
        text:'',          //(可选项)字符串类型;底部按钮文字;默认:‘确定’
        textSize:,      //(可选项)数字类型;底部按钮文字大小;默认:14
        textColor:'',  //(可选项)字符串类型;底部按钮文字颜色;默认:‘#1E1E1E’
        marginL:,     //(可选项)数字类型;底部按钮左边距;默认:0
        marginB:,     //(可选项)数字类型;底部按钮下边距;默认:0
        marginR:,    //(可选项)数字类型;底部按钮右边距;默认:0
        marginT:,   //(可选项)数字类型;底部按钮上边距;默认:0
    }
  
}

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{

    eventType:'submit'/'cancle'        //字符串类型  确定返回'submit' 取消返回'cancle'(点击取消或点击空白区域均按取消 返回)
    year:2000,                  //年
    month:1,                    //月
    day:1,                      //日
    hour:12,                    //时
    minute:00                   //分
}

示例代码

var UIDatePickerTool = api.require('UIDatePickerTool');
UIDatePickerTool.open({
   rowHeight:40,
    styles: {
            bg: 'rgba(0,0,0,0)', 
           headerViewBackgroundColor:'rgba(0,0,0,0)',
           lineBackgroundColor: 'rgba(0,0,0,0)',    
    item:{                
         normal: '#f00',
      	  normalFont: 14,      
         selected: '#000079',   
         cancelBtn:{
      	     cancelButtonTextColor: '#1E1E1E',  
             cancelButtonText: 'cancel' ,         
             cancelButtonFont:17                     
         },
         confirmBtn:{
            confirmButtonTextColor: '#1E1E1E',  
             confirmButtonText: 'confirm' ,         
             confirmButtonFont:17                 
            },
    }
    },
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭选择器

close()

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

隐藏选择器

hide()

示例代码

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

补充说明

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

show

显示已隐藏的选择器

show()

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/07/31