AudioPlayer 设计文档
基于原生 <audio> 的音频播放器(严格对齐 Semi,无第三方媒体库)。audioUrl 接受 string | AudioInfo | (string|AudioInfo)[] 四形态;数组时启用播放列表(上/下曲、ended 自动切下一曲、取模循环连播)。工具栏含音量(Popover 竖向 slider)、快退/快进(按 skipDuration)、倍速(Dropdown 5 档 0.5/0.75/1/1.5/2)、刷新;播放控制含上/下曲(多曲)+播放/暂停(圆形)。进度/音量用自建 AudioSlider(hover 变粗+拖拽圆点+Tooltip 时间预览)。深/浅双主题(默认 dark)。静音切换 0↔50%(照搬 Semi)。
← API 文档使用建议
基于原生 <audio> 的音频播放器(严格对齐 Semi,无第三方媒体库)。audioUrl 接受 string | AudioInfo | (string|AudioInfo)[] 四形态;数组时启用播放列表(上/下曲、ended 自动切下一曲、取模循环连播)。工具栏含音量(Popover 竖向 slider)、快退/快进(按 skipDuration)、倍速(Dropdown 5 档 0.5/0.75/1/1.5/2)、刷新;播放控制含上/下曲(多曲)+播放/暂停(圆形)。进度/音量用自建 AudioSlider(hover 变粗+拖拽圆点+Tooltip 时间预览)。深/浅双主题(默认 dark)。静音切换 0↔50%(照搬 Semi)。
Accessibility
ARIA role:group
- 各控制按钮为本库 Button,外包 Tooltip(走 i18n 文案:prev/next/backward/forward/volume)
- 倍速触发器 role=button + tabindex=0(Dropdown 附加 aria-haspopup/expanded,补 role 使其合法可键盘聚焦)
- 自建 AudioSlider role=slider + aria-valuemin/max/now + aria-orientation + aria-label(进度/音量)
- 多曲取模循环(对齐 Semi,无边界 disabled;末曲 next 绕回首曲)
- 播放出错时工具栏仅保留刷新按钮(对齐 Semi error 分支);错误块图标 + 硬编码文案(照搬 Semi)
设计变量
该组件暂无专属设计变量。