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) {
alert(JSON.stringify(ret));
} else {
alert(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及更高版本