Struct Audio 

pub struct Audio;

The <audio> element - embeds sound content into documents.

Purpose

The <audio> element is used to embed audio content in documents. It may contain one or more audio sources using nested <source> elements or the src attribute. The browser will choose the most suitable source. It provides built-in playback controls and APIs for programmatic control.

Content Categories

• Flow Content
• Phrasing Content
• Embedded Content
• If with controls attribute: Interactive Content
• Palpable Content

Permitted Content Model

• Zero or more <source> elements
• Zero or more <track> elements
• Transparent content (fallback for browsers without audio support)
• No media elements among descendants

Common Use Cases

• Music players and playlists
• Podcast players and audio articles
• Sound effects for interactive elements
• Audio feedback for user actions
• Background music or ambient sound

Key Attributes

• src: URL of the audio file
• controls: Show playback controls
• autoplay: Automatically start playback (use with caution)
• loop: Loop the audio
• muted: Mute audio by default
• preload: Hint for loading strategy (“none”, “metadata”, “auto”)
• crossorigin: CORS settings for audio fetching
• volume: Initial volume (0.0 to 1.0, set via JavaScript)

Example

<!-- Basic audio player -->
<audio src="/audio/music.mp3" controls>
  Your browser doesn't support the audio element.
</audio>

<!-- Multiple format sources -->
<audio controls>
  <source src="/audio/podcast.opus" type="audio/opus">
  <source src="/audio/podcast.ogg" type="audio/ogg; codecs=vorbis">
  <source src="/audio/podcast.mp3" type="audio/mpeg">
  <p>Your browser doesn't support HTML5 audio. <a href="/audio/podcast.mp3">Download</a></p>
</audio>

<!-- Looping background audio -->
<audio src="/audio/ambient.mp3" loop muted autoplay>
</audio>

<!-- Audio with preloading control -->
<audio src="/audio/effect.mp3" preload="none" id="sound-effect">
</audio>

Accessibility

• Provide transcripts for audio-only content
• Use captions/transcripts for important information conveyed via audio
• Don’t use autoplay with sound, as it can be disruptive
• Ensure playback controls are keyboard accessible
• Consider users with hearing impairments

WHATWG Specification

• 4.8.9 The audio element

Trait Implementations

impl HtmlElement for Audio

const TAG: &'static str = "audio"

The HTML tag name (e.g., “div”, “span”, “img”).

const VOID: bool = false

Whether this is a void element (self-closing, no children allowed).

impl CanContain<Source> for Audio

impl CanContain<Track> for Audio

impl EmbeddedContent for Audio

impl FlowContent for Audio

impl PalpableContent for Audio

impl PhrasingContent for Audio