Тег <audio> размещает на странице звук: музыку, голосовую запись или короткий сигнал. Это парный тег, закрывающий </audio> обязателен. Без атрибута controls плеера на странице не видно: у audio нет области показа, в отличие от video. Звук берётся из атрибута src или из вложенных тегов source, а описание тега есть в стандарте языка HTML.
<audio controls src="song.mp3">
Звук не воспроизводится.
</audio>
В этой статье
- Тег audio в HTML: что это и как вставить звук
- Чем audio отличается от video
- Атрибуты тега audio: полный список
- Атрибут controls: панель управления и скрытый плеер
- Форматы звука для audio: что умеет браузер
- Атрибуты autoplay, loop и preload
- Громкость звука: volume и muted в JavaScript
- Управление audio из JavaScript: play, pause, currentTime
- Плейлист на audio: переход к следующей дорожке
- Размеры и оформление audio в CSS
- Почему audio не играет
- Частые ошибки с тегом 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 её нет, поэтому часть атрибутов и свойств видео для звука не действует.
| Возможность | audio | video | Пример записи |
|---|---|---|---|
| Область показа | нет | есть | <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.
<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.
const a = new Audio("song.mp3");
a.play();
a.currentTime = 0;
Пример: конец дорожки, повторный play и сброс времени
Кнопки запускают проверку, звук включается. Под рамкой записан итог, посчитанный по свойствам дорожки.
Запуск play() возвращает Promise: если браузер не разрешил запуск, он завершается ошибкой, и её надо обработать.
Плейлист на audio: переход к следующей дорожке
Под плейлистом понимают список дорожек, которые играют одна за другой. Для него хватает одного audio и события ended: когда дорожка кончилась, меняем src и вызываем play(). В конце списка либо останавливаемся, либо возвращаемся к первой дорожке.
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 |