8.7 版本发布—WinterCG 兼容性第一部分
了解更多

<DatePicker> 是一个 UI 组件,允许用户从预配置的范围内选择日期。

另请参阅:时间选择器

xml
<DatePicker />
xml
<DatePicker
  year="2023"
  month="8"
  day="28"
  date="{{ date }}"
  minDate="{{ minDate }}"
  maxDate="{{ maxDate }}"
/>

属性

date

ts
date: Date

获取或设置完整日期。

minDate

ts
minDate: Date

获取或设置可选择的最早日期。

maxDate

ts
maxDate: Date

获取或设置可选择的最新日期。

day

ts
day: number

获取或设置月份中的日期。

month

ts
month: number

获取或设置月份。

year

ts
year: number

获取或设置年份。

iosPreferredDatePickerStyle

ts
iosPreferredDatePickerStyle: UIDatePickerStyle

在 iOS 13.4+ 中获取或设置 DatePicker 的 UIDatePickerStyle。

默认值:0(自动)。

有效值

  • 0 = 自动:系统根据当前平台和 DatePicker 模式选择具体样式。
  • 1 = 轮盘:DatePicker 显示为轮盘选择器。
  • 2 = 紧凑:DatePicker 显示为标签,点击时显示日历样式的编辑器。
  • 3 = 内联:DatePicker 显示为内联的可编辑字段

事件

dateChange

ts
on('dateChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New date:', args.value)
})

当所选日期更改时发出。

参见 PropertyChangeData

minDateChange

ts
on('minDateChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New minDate:', args.value)
})

当最小日期更改时发出。

参见 PropertyChangeData

maxDateChange

ts
on('maxDateChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New maxDate:', args.value)
})

当最大日期更改时发出。

参见 PropertyChangeData

dayChange

ts
on('dayChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New day:', args.value)
})

当日期更改时发出。

参见 PropertyChangeData

monthChange

ts
on('monthChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New month:', args.value)
})

当月份更改时发出。

参见 PropertyChangeData

yearChange

ts
on('yearChange', (args: PropertyChangeData) => {
  const picker = args.object as DatePicker
  console.log('New year:', args.value)
})

当年份更改时发出。

参见 PropertyChangeData

原生组件

上一个
按钮
下一个
HtmlView