UIDatePickerTool

立即使用

open close hide show

概述

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

open

打开选择器

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

params

rowHeight:

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

styles:

  • 类型:JSON 对象
  • 描述:(可选项)模块各部分的样式
  • 内部字段:
  1. {
  2. bg: 'rgba(0,0,0,0)', //(可选项)字符串类型;模块背景,支持 rgb、rgba、#;默认:'#FFFFFF'
  3. headerViewBackgroundColor: 'rgba(0,0,0,0)', //(可选项)字符串类型;设置头部的背景颜色,支持 rgb、rgba、#;默认:'#FFFFFF'
  4. lineBackgroundColor: 'rgba(0,0,0,0)', //(可选项)字符串类型;设置线条的颜色,支持 rgb、rgba、#;默认:'#cccccc'
  5. item:{ //(可选项)JSON对象;item 样式;默认值见内部字段
  6. normal: '#f00', //(可选项)字符串类型;常态字体色,支持 rgb、rgba、#;默认:‘#000000’
  7. normalFont: 14 //(可选项)数字类型;常态字体大小,;默认值:14
  8. selected: '#000079', //(可选项)字符串类型;选中后的字体色,支持 rgb、rgba、#
  9. cancelBtn:{
  10. cancelButtonTextColor: '#1E1E1E', //(可选项)字符串类型;设置取消按钮的字体颜色,支持 rgb、rgba、#;默认值:#1E1E1E
  11. cancelButtonText: 'cancel' , //(可选项)字符串类型;设置取消按钮的字,;默认值:'cancel'
  12. cancelButtonFont:17 //(可选项)数字类型;设置取消按钮的字体大小,;默认值:17
  13. cancelButtonImage:'' //(可选项)字符串类型;设置取消按钮的图片,与cancelButtonText互斥,只能存在一个
  14. },
  15. confirmBtn:{
  16. confirmButtonTextColor: '#1E1E1E', //(可选项)字符串类型;设置确定按钮的字体颜色,支持 rgb、rgba、#;默认值:#1E1E1E
  17. confirmButtonText: 'confirm' , //(可选项)字符串类型;设置确定按钮的字,;默认值:'confirm'
  18. confirmButtonFont:17 //(可选项)数字类型;设置确定按钮的字体大小,;默认值:17
  19. confirmButtonImage:'' //(可选项)字符串类型;设置确定按钮的图片,与confirmButtonText互斥,只能存在一个
  20. }
  21. },
  22. bottomButton{ //(可选项)JSON对象类型;底部按钮设置;默认不显示此按钮
  23. bg:'', //(可选项)字符串类型;底部按钮背景颜色,支持rgb,rgba,#;
  24. height:, //(可选项)数字类型;底部按钮高度;默认:根据textSize自适应
  25. text:'', //(可选项)字符串类型;底部按钮文字;默认:‘确定’
  26. textSize:, //(可选项)数字类型;底部按钮文字大小;默认:14
  27. textColor:'', //(可选项)字符串类型;底部按钮文字颜色;默认:‘#1E1E1E’
  28. marginL:, //(可选项)数字类型;底部按钮左边距;默认:0
  29. marginB:, //(可选项)数字类型;底部按钮下边距;默认:0
  30. marginR:, //(可选项)数字类型;底部按钮右边距;默认:0
  31. marginT:, //(可选项)数字类型;底部按钮上边距;默认:0
  32. }
  33. }

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. eventType:'submit'/'cancle' //字符串类型 确定返回'submit' 取消返回'cancle'(点击取消或点击空白区域均按取消 返回)
  3. year:2000, //年
  4. month:1, //月
  5. day:1, //日
  6. hour:12, //时
  7. minute:00 //分
  8. }

示例代码

  1. var UIDatePickerTool = api.require('UIDatePickerTool');
  2. UIDatePickerTool.open({
  3. rowHeight:40,
  4. styles: {
  5. bg: 'rgba(0,0,0,0)',
  6. headerViewBackgroundColor:'rgba(0,0,0,0)',
  7. lineBackgroundColor: 'rgba(0,0,0,0)',
  8. item:{
  9. normal: '#f00',
  10. normalFont: 14,
  11. selected: '#000079',
  12. cancelBtn:{
  13. cancelButtonTextColor: '#1E1E1E',
  14. cancelButtonText: 'cancel' ,
  15. cancelButtonFont:17
  16. },
  17. confirmBtn:{
  18. confirmButtonTextColor: '#1E1E1E',
  19. confirmButtonText: 'confirm' ,
  20. confirmButtonFont:17
  21. },
  22. }
  23. },
  24. }, function(ret, err) {
  25. if (ret) {
  26. alert(JSON.stringify(ret));
  27. } else {
  28. alert(JSON.stringify(err));
  29. }
  30. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭选择器

close()

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

隐藏选择器

hide()

示例代码

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

补充说明

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

show

显示已隐藏的选择器

show()

示例代码

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本