Обратите внимание, что

1. данный документ является переводом документа «4.7 Embedded content — HTML5» и на данный момент находится на стадии перевода;
2. данный документ может содержать неточности, опечатки и ошибки перевода;
3. официальным документом по данной тематике является оригинальный документ на английском языке, расположенный на сайте W3C.

4.7 Встроенное содержимое

* * *

4.7.7 Элемент audio

Категории:

Поток содержимого.

Формулировка контента.

Встроенный контент.

Если элемент имеет атрибут controls attribute: Интерактивный контент.

Если элемент имеет атрибут controls attribute: Видимый контент.

Контексты, в которых этот элемент может быть использован:

Где ожидается встроенный контент.

Модель содержимого:

Если элемент имеет src атрибут: может присутствовать от нуля и более track элементов, затем прозрачное содержимое, но без потомков медиа элемента.

Если элемент не имеет src атрибут: может присутствовать от нуля и более source элементов, затем ноль или более track элементов, а затем прозрачное содержимое, но без потомков медиа элемента.

Контент атрибуты:

Глобальные атрибуты

src - Адрес ресурса

crossorigin - Как элемент обрабатывает crossorigin запросы

preload - Подсказка браузеру относительно буферизации медиа ресурса

autoplay - Указывает на то, что медиа ресурс может начать воспроизводиться автоматически после полной загрузки страницы

mediagroup - Группы медиа элементов вместе с неявным MediaController

loop - Зацикливает воспроизведение медиа ресурса

muted - Отключает звук медиа ресурса и устанавливает такое положение в качестве значения по умолчанию

controls - Агент пользователя отображает собственные элементы управления аудио файлом

Опускание тега в text/html

Ни один тег не опускается

Допускается роль ARIA атрибута значениям:

application.

Допускается ARIA состояние и свойство атрибутов:

Глобальные aria-* атрибуты

Любые aria-* атрибуты применимые к разрешённым ролям.

DOM интерфейс:

[NamedConstructor=Audio(дополнительная DOMСтрока src)]
		интерфейс HTMLAudioElement : HTMLMediaElement {};

Элемент audio представляет собой звук или аудио поток.

Внутри элемента audio может находиться содержимое. Агенты пользователей не должны отображать это содержимое пользователю; оно предназначено для старых Веб браузеров, которые не поддерживают audio, так что можно вложить устаревшие аудио плагины или текст для пользователей этих старых браузеров, информируя их о том, как получить доступ к содержимому аудио файла.

В частности, это содержимое не предназначено для решения проблем доступности. Для того, чтобы сделать аудио содержимое доступным для глухих или лиц с другими физическими или когнитивными расстройствами, используйте разнообразные доступные функции. Если доступны субтитры или видео с сурдопереводом, то элемент video может быть использован вместо audio элемента для замещения воспроизведению аудио, что позволит пользователям включить визуальные альтернативы. Для помощи в навигации могут быть предусмотрены главы с названиями, использующие элемент track и WebVTT file. И, естественно, стенограммы или любые другие текстовые альтернативы могут быть предусмотрены в качестве простой связи с ними недалеко от audio элемента. [WEBVTT]

Элемент audio является медиа элементом, чьи медиа данные якобы являются аудиоданными.

Атрибуты src, preload, autoplay, mediagroup, loop, muted, и controls являются общими атрибутами для всех медиа элементов.

audio = new Audio( [ url ] )

Возвращает новый audio элемент, с src атрибутом со значением переданным в аргументе, если это возможно.