Media Player
A media player is a set of controls for audio or video. It includes play, progress, volume, captions, and other playback choices.
A clear control set keeps playback predictable.
A real example
A lesson player has play, a progress scrubber, speed, captions, a transcript, fullscreen, and keyboard shortcuts.
Main parts
- 01Visible label
- 02Interaction target
- 03Current state
- 04Keyboard behavior
Use it when
Start with the browser's native features. Build custom controls only when the product need is worth the accessibility cost.
Do not use it when
Never autoplay with sound, build custom controls people can't access, or hide duration and loading state.
Name used in code
<video> / <audio> Before you ship
Give assistive tools the control’s name (accessible name), purpose (role), value, and state. Check keyboard use, visible focus, target size, disabled and busy states, feedback, and recovery.
Outcome: Use Media Player to solve this user need without losing the current context. User context: A lesson player has play, a progress scrubber, speed, captions, a transcript, fullscreen, and keyboard shortcuts. Recommended pattern: Media Player. Why it fits: Start with the browser's native features. Build custom controls only when the product need is worth the accessibility cost. Do not use it when: Never autoplay with sound, build custom controls people can't access, or hide duration and loading state. Product requirements: Define the default, loading, empty, error, success, and recovery states. Keep user input. Give clear feedback after every action. Accessibility and resilience: Use semantic HTML, full keyboard access, and visible focus. Make the layout work when zoomed and support reduced motion. Follow the project’s current rules. Do not add a new UI library unless the project already uses it. Acceptance criteria: The main task works with keyboard only and at 320px width. Focus and status changes are announced. Check loading, failure, retry, cancel, and reduced-motion paths. Evidence and limits (evidence boundary): No single official standard controls the whole term. Its meaning may change across teams, platforms, or frameworks. Unknowns to confirm: Product wording, data source, analytics events, supported devices and languages, and platform limits.
Check this request
Review the current use of Media Player. Definition: A media player is a set of controls for audio or video. It includes play, progress, volume, captions, and other playback choices. Release checks: Give assistive tools the control’s name (accessible name), purpose (role), value, and state. Check keyboard use, visible focus, target size, disabled and busy states, feedback, and recovery. Before changing code, report the evidence you found, gaps, severity, and the smallest safe fix.