Тег audio в HTML: что это и какие у него атрибуты

Тег <audio> размещает на странице звук: музыку, голосовую запись или короткий сигнал. Это парный тег, закрывающий </audio> обязателен. Без атрибута controls плеера на странице не видно: у audio нет области показа, в отличие от video. Звук берётся из атрибута src или из вложенных тегов source, а описание тега есть в стандарте языка HTML.

HTML
<audio controls src="song.mp3">
  Звук не воспроизводится.
</audio>

Тег audio в HTML: что это и как вставить звук

Браузер сам рисует панель с кнопкой запуска, полосой времени и регулятором громкости, если прописан controls. Размер этой панели задаёт браузер. Без controls блок получает размер 0 на 0, и звук можно запустить только из скрипта или атрибутом autoplay.

Пример: audio с controls и без них

Результат

Кнопки выбирают запись, она показана над рамкой. Под рамкой записаны размер блока и, для последней кнопки, видимость запасного текста.

Без controls блока нет: размер 0 на 0. С controls панель появляется даже без файла, поэтому по её виду нельзя понять, загружен ли звук. Запасной текст между тегами нужен только старым браузерам: современные его не выводят.

Чем audio отличается от video

Теги audio и video устроены почти одинаково: у них общие src, controls, autoplay, loop, muted и preload, а управляются они одними и теми же методами. Разница в области показа: у audio её нет, поэтому часть атрибутов и свойств видео для звука не действует.

ВозможностьaudiovideoПример записи
Область показанетесть<video controls src="clip.webm">
Атрибуты width и heightне действуютдействуют<video width="400" height="120">
Атрибут posterнетесть<video poster="cover.jpg">
Свойство videoWidthнетестьvideo.videoWidth

Пример: один и тот же набор атрибутов у audio и video

Результат

Кнопки выбирают тег, запись показана над рамкой. Под рамкой записаны высота блока, наличие свойств и действие атрибута height.

У audio высота остаётся высотой панели, свойств poster и videoWidth нет. У video высота берётся из атрибута. Подробности про видео есть на странице тега video.

Атрибуты тега audio: полный список

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

АтрибутЧто делаетПример записиСтатус
srcЗадаёт адрес звукового файла<audio src="song.mp3">работает
controlsВключает панель управления<audio controls>работает
autoplayЗапускает звук после загрузки<audio autoplay muted>работает
loopПовторяет дорожку после конца<audio loop>работает
mutedВыключает звук<audio muted>работает
preloadПодсказывает, сколько загружать заранее<audio preload="none">работает
crossoriginРазрешает читать данные звука с другого сайта<audio crossorigin="anonymous">работает
width, heightРазмер блока, как у видео<audio width="400">не действует

Атрибут controls: панель управления и скрытый плеер

Атрибут controls логический: достаточно написать его имя. Панель можно скрыть атрибутом hidden или свойством display: none. Блок при этом пропадает, а звук остаётся доступным для скрипта.

Пример: скрытый плеер и запуск звука

Результат

Кнопки выбирают запись и запускают звук, запись показана над рамкой. Под рамкой записаны высота блока и результат запуска.

В обоих скрытых вариантах высота блока 0, а звук всё равно запускается. Такой плеер подходит для сигналов, которые включает скрипт.

Форматы звука для audio: что умеет браузер

Какие форматы читает браузер, зависит от самого браузера: MP3, WAV, Ogg и FLAC читаются не везде одинаково. Проверяет формат метод canPlayType(): он возвращает пустую строку, maybe или probably. Ответ зависит от браузера читателя, поэтому у вас он может отличаться.

Пример: какие форматы умеет ваш браузер

Результат

Кнопки выбирают формат, запись для source показана над рамкой. Под рамкой записаны тип, ответ canPlayType и итог.

Пустая строка значит, что формат не читается. Чтобы не зависеть от одного формата, прописывают несколько тегов source: браузер возьмёт первый подходящий. Порядок перебора разобран на странице source.

HTML
<audio controls>
  <source src="song.ogg" type="audio/ogg">
  <source src="song.mp3" type="audio/mpeg">
</audio>

Атрибуты autoplay, loop и preload

Три атрибута управляют тем, когда звук загружается, запускается и начинается заново. Их удобно разбирать по отдельности.

Автозапуск: autoplay и muted

Атрибут autoplay запускает звук сразу после загрузки. По описанию в справочниках браузеры часто блокируют автозапуск со звуком, пока читатель не нажмёт на странице что-нибудь, поэтому autoplay почти всегда прописывают вместе с muted.

Результат

Кнопки выбирают запись, она показана над рамкой. Под рамкой записаны результат запуска или значения свойств.

Атрибут autoplay, добавленный после загрузки, звук не запускает. Атрибут muted действует, если прописан в разметке: добавленный позже через setAttribute() оставляет свойство muted равным false, хотя defaultMuted становится true.

Повтор: loop

Атрибут loop возвращает дорожку к началу, когда она дошла до конца. Без него звук останавливается, свойство ended становится true, а currentTime равно длине дорожки.

Результат

Кнопки выбирают значение loop, дорожка запускается у самого конца. Под рамкой записаны свойство, конец дорожки и остановка.

С loop воспроизведение не останавливается: ended остаётся false, а дорожка идёт заново.

Загрузка: preload

Атрибут preload подсказывает браузеру, сколько загружать заранее: none значит ничего, metadata только длину и служебные данные, auto разрешает грузить файл целиком. Значение по умолчанию у обычного тега metadata, а у элемента, созданного через new Audio(), значение auto.

Результат

Кнопки выбирают способ создания, запись показана над рамкой. Под рамкой записаны свойство preload и наличие элемента в документе.

Элемент new Audio() в документ не попадает: его не видно и он не занимает места, но звук проигрывает.

Громкость звука: volume и muted в JavaScript

Громкость задаёт свойство volume: число от 0 до 1. Значение вне этого промежутка вызывает ошибку IndexSizeError, не число вызывает TypeError, а строка с числом превращается в число. Свойство muted выключает звук отдельно, не меняя volume.

Пример: что принимает volume

Результат

Кнопки выбирают присваиваемое значение, запись показана над рамкой. Под рамкой записаны присвоенное, ошибка, громкость и признак выключенного звука.

Ноль в volume звук не выключает: muted остаётся false. А muted = true оставляет громкость прежней.

Управление audio из JavaScript: play, pause, currentTime

Из JavaScript звуком управляют методы play() и pause() и свойство currentTime в секундах. Дойдя до конца, дорожка останавливается, а currentTime равно длине. Повторный play() во время звучания дорожку не перезапускает, для этого нужно currentTime = 0.

JS
const a = new Audio("song.mp3");
a.play();
a.currentTime = 0;

Пример: конец дорожки, повторный play и сброс времени

Результат

Кнопки запускают проверку, звук включается. Под рамкой записан итог, посчитанный по свойствам дорожки.

Запуск play() возвращает Promise: если браузер не разрешил запуск, он завершается ошибкой, и её надо обработать.

Плейлист на audio: переход к следующей дорожке

Под плейлистом понимают список дорожек, которые играют одна за другой. Для него хватает одного audio и события ended: когда дорожка кончилась, меняем src и вызываем play(). В конце списка либо останавливаемся, либо возвращаемся к первой дорожке.

JS
const tracks = ["1.mp3", "2.mp3", "3.mp3"];
let i = 0;
a.onended = () => {
  i = (i + 1) % tracks.length;
  a.src = tracks[i];
  a.play();
};

Пример: плейлист из трёх дорожек

Результат

Кнопки запускают плейлист, звук включается. Под рамкой записана играющая дорожка, а в конце итог.

Остаток от деления на длину списка возвращает счётчик к первой дорожке, поэтому режим «по кругу» не требует отдельной проверки.

Размеры и оформление audio в CSS

Размер блока audio задают свойства width, height, padding и border. Внешний вид самой панели определяет браузер. Если плеер находится в строке текста, под ним остаётся лишнее место: display: block его убирает.

Пример: размеры и отступы плеера

Результат

Кнопки выбирают правило, запись показана над рамкой. Под рамкой записаны размеры блока и обёртки.

Отступы и рамка добавляются к размеру панели снаружи. У строчного плеера высота обёртки больше высоты плеера, у блочного они равны.

Почему audio не играет

Если звук не играет, у элемента появляется ошибка в свойстве error. Код ошибки и состояние сети networkState помогают отличить пропавший файл от неподходящего формата.

Пример: как выглядит ошибка загрузки

Результат

Кнопки выбирают запись, она показана над рамкой. Под рамкой записаны код ошибки, состояние сети и итог.

ПричинаЧто видноЧто делать
Файла по адресу нетОшибка с кодом 4Проверить адрес в src
Вместо звука приходит текстОшибка с кодом 4Проверить, что сервер отдаёт звуковой файл
Формат не поддерживаетсяcanPlayType возвращает пустую строкуДобавить source с другим форматом
Автозапуск со звукомplay() завершается ошибкой, по описанию в справочникахПрописать muted или запускать по нажатию

Частые ошибки с тегом audio

В таблице собраны ошибки, из-за которых звук не слышен или ведёт себя не так, как ждут. В каждой строке есть запись и способ её исправить.

ОшибкаЧто происходитКак исправить
<audio src="a.mp3"></audio>Плеера на странице нет, размер блока 0 на 0Добавить controls
<audio controls width="400">Размер не меняется, атрибут не действуетЗадать ширину в CSS: audio { width: 400px }
<audio autoplay src="a.mp3">Браузер может не запустить звук без действия читателяДобавить muted или запускать по кнопке
a.setAttribute('muted', '')Звук не выключается, muted остаётся falseПрописать a.muted = true
a.volume = 1.5Ошибка IndexSizeErrorБрать значение от 0 до 1
<audio src="song.aac">В части браузеров формат не читаетсяДобавить source с другим форматом
<audio controls> в строке текстаПод плеером лишнее местоПрописать display: block
Категория
Поделиться в социальных сетях
Основные HTML-теги
Семантические теги HTML
Заголовки и абзацы
Теги для форматирования текста
Тег гиперссылки HTML
HTML-теги таблицы
Списки в HTML
Теги для форм
Мультимедиа и изображения
Интерактивные и служебные теги
Устаревшие HTML-теги

Отправить комментарий

0 Комментарии

Отправить комментарий (0)

#buttons=(Хорошо) #days=(20)

Мы используем файлы cookie для улучшения работы сайта. Подробнее
Хорошо
×