add vitepress docs

2026-09-21 16:05:14 +08:00
parent b435bf992e
commit 37cf38fe27
73 changed files with 7003 additions and 802 deletions
@@ -0,0 +1,42 @@
+# DurationPicker 时长选择
+
+按时长值选择并回填，单位与候选项由组件内部推导。
+
+## 基础用法
+
+:::preview 基础用法 || 选择后回填的是毫秒数
+
+demo-preview=../demos/duration-picker/basic.vue
+
+:::
+
+## 何时使用
+
+需要让用户选择一个时间跨度（缓存有效期、超时时长等）时使用。对外只暴露毫秒值，单位换算是内部细节。
+
+## 取值与单位
+
+`modelValue` 是**毫秒数**。组件内置了年 / 天 / 小时 / 分钟 / 秒 / 毫秒六个单位，各自带有取值范围与步长：
+
+| 单位 | 范围 | 步长 |
+| --- | --- | --- |
+| 年 | 1 - 100 | 1 |
+| 天 | 1 - 364 | 1 |
+| 小时 | 1 - 23 | 1 |
+| 分钟 | 1 - 59 | 1 |
+| 秒 | 1 - 59 | 1 |
+| 毫秒 | 50 - 950 | 50 |
+
+默认值为 1000 毫秒（1 秒）。
+
+## 两个事件
+
+`update:modelValue` 在滚动选择时触发，`change` 在确认选择时触发：
+
+```vue
+<duration-picker v-model="duration" @change="onConfirm" />
+```
+
+## API
+
+<api-table name="DurationPicker" />