界面组件 核心 C · 行业惯例

Media Player

媒体播放器

媒体播放器是一组控制音频或视频的组件,包含播放、进度、音量、字幕和其他播放选项。

动手试试看
也有人这样说 Media Player音视频播放器播放控件

动手试试看

媒体播放器

清晰的控件组让播放行为可预期。

1:17 / 2:00
字幕已开启 · 1× · 音量 72%

生活中的例子

课程播放器有播放、进度、倍速、字幕和文字稿。它也支持全屏和键盘快捷键。

主要部分

  1. 01可见标签
  2. 02交互目标
  3. 03当前状态
  4. 04键盘行为

什么时候用

先使用浏览器原生功能;只有产品需求值得承担无障碍成本时,才制作自定义控件。

什么时候不要用

不要自动播放声音、制作无法无障碍操作的自定义控件,或隐藏时长和加载状态。

代码里的名称

<video> / <audio>

上线前要检查

让辅助工具知道控件的名称(无障碍名称)、用途(角色)、值与状态。检查键盘操作、清楚可见的焦点、点击范围、禁用与忙碌状态、反馈及恢复。

可以直接复制的需求

预期结果:使用 媒体播放器 (Media Player) 解决这项需求,同时保留用户当前的操作上下文。 用户场景:课程播放器有播放、进度、倍速、字幕和文字稿。它也支持全屏和键盘快捷键。 建议界面模式:媒体播放器 (Media Player)。 适用理由:先使用浏览器原生功能;只有产品需求值得承担无障碍成本时,才制作自定义控件。 不应使用的情况:不要自动播放声音、制作无法无障碍操作的自定义控件,或隐藏时长和加载状态。 产品要求:定义默认、加载、没有内容、错误、成功与恢复状态。保留用户已输入的内容,每个操作后都提供清楚反馈。 无障碍与韧性:使用结构正确的 HTML(语义化 HTML)和完整键盘操作。焦点要清楚可见,布局缩放后仍要好用。也要提供减少动态效果。遵守项目现有规则。除非项目已采用,否则不要新增界面组件库。 验收标准:主要任务可只用键盘完成,在 320px 宽度也能正常使用。焦点与状态变化可被辅助工具读出。加载、失败、重试、取消与减少动态效果都已验证。 证据与限制(证据边界):没有一份官方标准能涵盖全部内容。不同团队、平台或框架的用法可能不同。 待确认:产品文字、数据来源、分析事件、支持设备与语言,以及平台特有限制。

检查这份需求

请 AI 编程助手检查当前如何使用 媒体播放器 (Media Player)。 定义:媒体播放器是一组控制音频或视频的组件,包含播放、进度、音量、字幕和其他播放选项。 生产环境检查:让辅助工具知道控件的名称(无障碍名称)、用途(角色)、值与状态。检查键盘操作、清楚可见的焦点、点击范围、禁用与忙碌状态、反馈及恢复。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

C
这个术语有多正式?

行业惯例

工作中经常会用到这个术语。列出的来源可能说明用法或限制,但不会定义全部内容。

没有一份官方标准能涵盖全部内容。不同团队、平台或框架的用法可能不同。

适用范围
只包含来源有说明的内容:正式名称、定义、语义、实现、无障碍、使用指南、避免事项
文档状态
持续更新标准
核验日期
2026-07-30

证据来源与适用范围

正式来源 · WHATWG · 持续更新标准 HTML Living Standard 适用范围: 正式名称、定义、语义、实现 本页用途: 提供背景,不是正式定义 来源涵盖内容: 正式名称, 定义, 语义, 实现 正式来源 · W3C · 正式推荐标准 Web Content Accessibility Guidelines (WCAG) 2.2 适用范围: 无障碍、使用指南、避免事项 本页用途: 提供背景,不是正式定义 来源涵盖内容: 无障碍, 使用指南, 避免事项

自行复制

浏览器无法自动复制。请选择下方文字,再自行复制。