数据录入与表单有已知边界
NnRangePicker 日期范围
日期或日期时间范围选择。
示例
API
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
value | [DateLike, DateLike] | null | null | 日期范围，配合 v-model:value。可识别非空的 Date、带 toDate()/toISOString() 的对象，以及能被 new Date(value) 解析的 truthy 值。确认后统一输出两个新的 Date；时间戳 0 会被当作空值。 |
showTime | boolean | object | false | 真值时显示开始/结束时间输入并使用日期时间默认格式。 |
format | string | '' | 显示格式；支持替换 YYYY、MM、DD、HH、mm、ss。空值时按是否显示时间选择默认格式。 |
placeholder | [string, string] | ['开始日期', '结束日期'] | 两个只读输入框的占位和 aria-label。缺失项使用默认中文。 |
allowClear | boolean | true | 有草稿值且非禁用时显示清除按钮。 |
disabled | boolean | false | 禁用打开和清除。 |
status | string | '' | error 使用错误样式；其他值没有专用样式。 |
Events
| 事件 | 参数 | 说明 |
|---|---|---|
update:value | (value: [Date, Date] | null) | 点击“确定”或清除时触发。 |
change | (value: [Date, Date] | null, formatted: [string, string]) | 与更新事件同时触发；第二个参数使用当前 format。清除时为 ['', '']。 |
openChange | (open: boolean) | 面板打开或关闭时触发。取消、外部点击和 Escape 会关闭且不提交草稿。 |
当前限制
- 两个文本框都是只读，不能手工键入日期。
showTime对象当前只按真值处理，不读取对象中的时间格式、步长或默认时间配置。format只控制显示和格式化事件参数，不是自定义输入解析器。- 当前固定为单月面板，没有禁用日期/时间、快捷范围、国际化或受控
openProp。