日期时间选择 DateTimePicker
示例
基本形式
<dateTimePicker />
<dateTimePicker date="2012-12-21 12:21" />
禁用组件
<dateTimePicker disabled />
日期范围
<dateTimePicker minDate={minDate} maxDate={maxDate} />
<dateTimePicker minDate="2008-08-08 12:00" maxDate="2008-08-12 14:45" />
var component = new RGUI.Component({
template: template,
data: {
minDate: new Date(+new Date + 2*24*3600*1000),
maxDate: new Date(+new Date + 7*24*3600*1000)
}
});
数据绑定
<dateTimePicker date={date} />
<dateTimePicker date={date} />
<p>当前选择的日期为:{date | format: 'yyyy-MM-dd HH:mm'}</p>
事件
请打开浏览器的控制台查看结果。
<dateTimePicker
on-toggle={console.log('on-toggle:', '$event.open:', $event.open)}
on-change={console.log('on-change:', '$event.date:', $event.date)} />
API
Class
DateTimePicker
继承自Dropdown。
Options
new DateTimePicker()
参数 | 类型 | 默认值 | 数据流向 | 描述 |
---|---|---|---|---|
data | object | 绑定属性 | ||
data.date | object | null | outer <=> inner | 当前选择的日期时间 |
data.placeholder | string | '请输入' | outer => inner | 文本框的占位文字 |
data.minDate | Date string | null | outer => inner | 最小日期时间,如果为空则不限制 |
data.maxDate | Date string | null | outer => inner | 最大日期时间,如果为空则不限制 |
data.autofocus | boolean | false | outer => inner | 是否自动获得焦点 |
data.readonly | boolean | false | outer => inner | 是否只读 |
data.disabled | boolean | false | outer => inner | 是否禁用 |
data.visible | boolean | true | outer => inner | 是否显示 |
data.class | string | '' | outer => inner | 补充class |
Methods
dateTimePicker.isOutOfRange(date)
是否超出规定的日期时间范围
参数 | 类型 | 默认值 | 描述 |
---|---|---|---|
date | Date | 待测的日期时间 | |
返回值 | 类型 | 描述 | |
date | boolean Date | 如果没有超出日期时间范围,则返回false;如果超出日期时间范围,则返回范围边界的日期时间 |
Inherited Methods
dateTimePicker.toggle(open)
展开/收起
参数 | 类型 | 默认值 | 描述 |
---|---|---|---|
open | boolean | 展开/收起状态。如果无此参数,则在两种状态之间切换。 | |
返回值 | 类型 | 描述 | |
无返回值 |
@override dateTimePicker.select(item)
@deprecated dateTimePicker.$updateSource()
从service中更新数据源
参数 | 类型 | 默认值 | 描述 |
---|---|---|---|
无参数 | |||
返回值 | 类型 | 描述 | |
this | SourceComponent |
Events
dateTimePicker.$on('change')
日期时间改变时触发
属性 | 类型 | 描述 |
---|---|---|
sender | object | 事件发送对象 |
date | object | 改变后的日期时间 |
Inherited Events
dateTimePicker.$on('toggle')
展开/收起时触发
属性 | 类型 | 描述 |
---|---|---|
sender | object | 事件发送对象 |
open | object | 展开/收起状态 |