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 显示秒列)

设计变量

该组件暂无专属设计变量。