Spec-Zone.ru › Web APIs

HTMLAudioElement

Базовая Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Интерфейс HTMLAudioElement предоставляет доступ к свойствам элементов <audio>, а также методы для их управления.

Этот элемент основан на интерфейсе HTMLMediaElement и наследует его свойства и методы.

EventTarget Node Element HTMLElement HTMLMediaElement HTMLAudioElement

Конструктор

Audio()

Создаёт и возвращает новый объект HTMLAudioElement, при необходимости начав процесс загрузки аудиофайла, если указан URL файла.

Свойства экземпляра

Нет специфических свойств; наследует свойства от родительского класса HTMLMediaElement и от HTMLElement.

Методы экземпляра

Наследует методы от родительского класса HTMLMediaElement и от HTMLElement. Собственных методов не имеет.

Примеры

Базовое использование

Вы можете создать HTMLAudioElement полностью с помощью JavaScript, используя конструктор Audio():

const audioElement = new Audio("car_horn.wav");

затем вы можете вызвать метод play() на элементе

audioElement.play();

Примечание: Распространённая ошибка — попытка воспроизвести аудиоэлемент сразу при загрузке страницы. Политика автоматического воспроизведения в современных браузерах будет это блокировать. Обратитесь к документации Firefox и chrome для получения рекомендаций и обходных путей.

Некоторые из наиболее часто используемых свойств элемента аудио включают src, currentTime, duration, paused, muted и volume. Этот фрагмент копирует продолжительность аудиофайла в переменную:

const audioElement = new Audio("car_horn.wav");
audioElement.addEventListener("loadeddata", () => {
  let duration = audioElement.duration;
  // The duration variable now holds the duration (in seconds) of the audio clip
});

События

Наследует методы от родительского класса HTMLMediaElement и от предка HTMLElement. Прислушивайтесь к событиям, используя addEventListener() или назначив обработчик события к свойству oneventname данного интерфейса.

Спецификации

Спецификация
HTML
# htmlaudioelement

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
Audio 4 12 3.5 ≤12.1 3.1 18 4 ≤12.1 3 1.0 ≤37
HTMLAudioElement 3 12 3.5 10.5 3.1 18 4 11 3 1.0 ≤37

См. также

  • Веб-медиа технологии
  • Использование аудио и видео в HTML
  • Элемент HTML, реализующий этот интерфейс: <audio>.

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLAudioElement

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API