HTMLAudioElement
Базовая Широко доступна
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Интерфейс HTMLAudioElement предоставляет доступ к свойствам элементов <audio>, а также методы для их управления.
Этот элемент основан на интерфейсе HTMLMediaElement и наследует его свойства и методы.
Конструктор
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