DateInput Props

名称	类型	默认值	说明
modelValue	Date | null	null	当前选中的日期。
placeholder	string	Select a date / 选择日期	占位文本。未设置语言时为英文，提供 zh-CN 后为中文。
min	Date	—	最早可选日期。
max	Date	—	最晚可选日期。
isDateDisabled	(date: Date) => boolean	—	返回 true 时该日期不可选。
dateConstraints	Array<(date: Date) => boolean>	—	任一函数返回 false 时该日期不可选。
name	string	—	表单字段名。
label	string	—	字段标签。
description	string	—	标签下方的说明。
isLabelHidden	boolean	false	标签只留给读屏，页面上不显示。旧名 labelHidden 同样可用，两者任一为真就隐藏。
isOptional	boolean	—	在标签旁标成可选。
isRequired	boolean	—	把字段标成必填，输入框带上 aria-required。
labelTooltip	string	—	标签末尾信息图标里的说明。
format	'date' | 'date_long' | 'date_weekday' | 'system_date' | ((iso: string) => string)	'date_long'	已提交日期的显示方式。函数收到的是 YYYY-MM-DD。
presentation	'popover' | 'bottom-sheet' | 'native' | 'adaptive-bottom-sheet' | 'adaptive-native'	未设置时为 adaptive-native	弹出层、底部面板、系统日期控件，或按指针在它们之间切换。同时传了 nativePicker 时以这项为准。
nativePicker	'touch' | 'always' | 'never'	—	旧的打开方式。touch 跟随指针，always 用系统控件，never 按指针在弹出层和底部面板之间切换。同时传了 presentation 时以 presentation 为准。
numberOfMonths	1 | 2	1	弹出日历并排的月份数。系统日期控件表达不了这项。
weekStartsOn	0-6 | 'sun' | 'mon' | ...	—	弹出日历从哪一天开始一周。系统日期控件表达不了这项。
disabled	boolean	false	是否禁用。
isLoading	boolean	false	字段不可改，并显示加载指示。
changeAction	(value: Date | null) => void | Promise<void>	—	值提交之后再跑。返回 Promise 时，字段保持加载直到它结束。
width	number | string	—	整段字段的宽度。数字按像素算。
disabledMessage	string	—	禁用原因。和 disabled 一起用时，悬停或键盘聚焦会显示这段提示，输入框仍可聚焦（带 aria-disabled），但改不了值。旧名 disabledReason 同样可用。
hasClear	boolean	false	有值时显示清除按钮，清空后焦点回到输入框。旧名 clearable 同样可用。
clearLabel	string	Clear / 清除	清除按钮的无障碍名称。设置了 label 时会带上它。未设置语言时为英文，提供 zh-CN 后为中文。
size	'sm' | 'md' | 'lg'	'md'	尺寸。
status	'default' | 'error' | 'warning' | 'success' | { type, message? }	—	校验状态。对象带 message 时，说明会显示在字段下方。
statusVariant	'attached' | 'detached' | 'tooltip'	'attached'	状态说明的位置。
containerClass	string | object | array	—	加到字段外壳的 class。在 InputGroup 和横向标签的 FormLayout 里没有外壳，此时不生效，开发环境会警告。
containerStyle	StyleValue	—	加到字段外壳的行内样式。落点规则同 containerClass。
controlClass	string | object | array	—	加到带边框本体的 class。直接写在组件上的 class 也落在本体，不会落到内部输入框上。
controlStyle	StyleValue	—	加到带边框本体的行内样式。

DateInput 事件

名称	载荷	说明
update:modelValue	value: Date | null	日期变化时触发。
change	value: Date | null	日期变化时触发。

DateInput 插槽

名称	说明
prefix	输入框前面的图标。
suffix	输入框后面的内容。