TimePicker 设计文档
时间选择器,严格对齐 Semi。触发器复用 Input(可键入时间串),面板复用 ScrollList/ScrollItem 滚动列。单选 type=time(HH:mm:ss 三列,+12h AM/PM 列),type=timeRange 左右双列并排选起止。format 字符串决定显示列与 12h(含 ss 即显示秒列)。
← API 文档使用建议
时间选择器,严格对齐 Semi。触发器复用 Input(可键入时间串),面板复用 ScrollList/ScrollItem 滚动列。单选 type=time(HH:mm:ss 三列,+12h AM/PM 列),type=timeRange 左右双列并排选起止。format 字符串决定显示列与 12h(含 ss 即显示秒列)。
Accessibility
ARIA role:dialog
- 触发器复用 Input,aria-haspopup=dialog、aria-expanded、aria-controls 指向面板
- 面板 role=dialog;时间列复用 ScrollList/ScrollItem(-scrolllist-item > ul > li[role=option])
- 禁用项 aria-disabled=true 且不可点击;hideDisabledOptions 时从列移除
- 触发器可键入时间串(Enter/Blur 解析提交);Enter/↓ 打开;Esc 关闭
- 12h 制额外 AM/PM 列;文案经 locale TimePicker.am/pm
- 选择即生效(点击 ScrollItem 项 onSelect 立即 onChange),无「此刻」「确定」按钮
- timeRange 模式:左右两个 ScrollList 并排(对齐 Semi RANGE_PANEL_LISTS),一次编辑起止两端
- format 字符串经 core parseFormatSpec 决定显示列与 12h(含 ss 显示秒列)
设计变量
该组件暂无专属设计变量。