AudioPlayer 设计文档
基于原生 <audio> 的音频播放器(对齐 Semi,无第三方媒体库)。audioUrl 接受 string | string[] | AudioInfo | AudioInfo[] 四形态并归一为曲目列表;多曲显示上/下曲。工具栏含播放/暂停、快退/快进(按 skipDuration)、上/下曲、重播、进度、时间、倍速、音量;深/浅双主题(默认 dark)。
← API 文档使用建议
基于原生 <audio> 的音频播放器(对齐 Semi,无第三方媒体库)。audioUrl 接受 string | string[] | AudioInfo | AudioInfo[] 四形态并归一为曲目列表;多曲显示上/下曲。工具栏含播放/暂停、快退/快进(按 skipDuration)、上/下曲、重播、进度、时间、倍速、音量;深/浅双主题(默认 dark)。
Accessibility
ARIA role:group
- 工具栏各按钮为原生 <button type=button>,aria-label 走 i18n(播放/暂停/上/下曲/快进/快退/重播/音量/倍速)
- 播放/暂停按钮带 aria-pressed 反映播放态
- 进度条为原生 range input,补 aria-valuemin/max/now + aria-valuetext(当前/总时长)纯标注
- 首/末曲时上/下曲按钮 disabled(对齐 headless 无环绕边界)
- 播放出错时用 role=status / aria-live=polite live region 播报错误文案
- 图标不依赖颜色单通道,语义由 aria-label 承载
设计变量
该组件暂无专属设计变量。