HTMLAudioElement
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
L'interface HTMLAudioElement donne accès aux propriétés des éléments HTML <audio>, ainsi qu'aux méthodes permettant de les manipuler.
Cet élément est basé sur l'interface HTMLMediaElement, dont il hérite des propriétés et des méthodes.
Constructeur
Audio()-
Crée et retourne un nouvel objet
HTMLAudioElement, en lançant éventuellement le chargement d'un fichier audio si une URL de fichier est fournie.
Propriétés d'instance
Aucune propriété spécifique ; hérite des propriétés de son parent HTMLMediaElement et de HTMLElement.
Méthodes d'instance
Hérite des méthodes de son parent HTMLMediaElement et de HTMLElement. Elle n'offre pas de méthodes propres.
Exemples
Utilisation simple
Vous pouvez créer un HTMLAudioElement entièrement en JavaScript à l'aide du constructeur Audio() :
const audioElement = new Audio("car_horn.wav");
vous pouvez ensuite appeler la méthode play() sur l'élément :
audioElement.play();
Note : Un écueil courant consiste à essayer de lire un élément audio immédiatement au chargement de la page. La politique d'autoplay par défaut des navigateurs modernes bloque ce comportement. Consultez les articles Firefox (angl.) et Chrome pour les bonnes pratiques et les solutions de contournement.
Parmi les propriétés les plus couramment utilisées de l'élément audio, on trouve src, currentTime, duration, paused, muted et volume. Cet extrait copie la durée du fichier audio dans une variable :
const audioElement = new Audio("car_horn.wav");
audioElement.addEventListener("loadeddata", () => {
let duration = audioElement.duration;
// La variable duration contient maintenant la durée (en secondes) du clip audio
});
Évènements
Hérite des méthodes de son parent HTMLMediaElement et de son ancêtre HTMLElement. Écoutez les évènements à l'aide de addEventListener() ou en assignant un gestionnaire à la propriété oneventname de cette interface.
Spécifications
| Specification |
|---|
| HTML # htmlaudioelement |
Compatibilité des navigateurs
Voir aussi
- Technologies des médias web
- Diffusion audio et vidéo
- L'élément HTML implémentant cette interface :
<audio>.