DatePicker
基于原生 input 封装的输入或选择日期的控件。
引用
js
import { DatePicker, regist } from "litos-ui";
regist(DatePicker);1
2
3
2
3
演示
基础用法
通过 type 属性指定类型,date、datetime-local、time、month、week。value 设置初始值。
注意使用
month、week时需要考虑兼容性
限定日期范围
通过 min 和 max 限定日期范围。
范围选择器
通过 range 属性开启范围选择。
API
DatePicker Attibutes
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
value | 初始值, 如果是范围选择,则逗号分隔开始结束日期, 例如: 2025-04-01,2025-04-15 | string | - |
min | 最小日期 | string | - |
max | 最大日期 | string | - |
type | 类型, 可选值: date、datetime-local、time、month、week | string | date |
range | 是否开启范围选择 | boolean | false |
allow-empty | 是否允许空值, 设置为 false 时如果为空会赋值初始值 | boolean | true |
disabled | 是否禁用 | boolean | false |
width | 宽度 | string | - |
emit-timeout | 触发 change 事件时延时, 在范围选择时有效;为了性能考虑, 立即改变一个日期后,会延迟 300ms 通知, 以响应其它选择器, 0 - 立即触发 | number | number |
DatePicker Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
change | 日期改变时触发, 通过 event.detail 可以获取到当前值 | (event: CustomEvent) |
DatePicker CSS Variables
| 变量名 | 说明 | 默认值 |
|---|---|---|
--l | x | #fff |