<audio>

Résumé

L'élément HTML <audio> est utilisé pour ajouter un contenu sonore dans un document. Il peut contenir plusieurs sources audio introduites avec l'attribut src ou l'élément <source>. Le navigateur décidera lequel utiliser. Du contenu alternatif peut aussi être ajouté pour les navigateurs ne supportant pas cette fonctionnalité.

L'API Web Audio peut être utilisée pour manipuler des flux audio avec du code JavaScript. Voir les pages sur l'API Web Audio pour plus d'informations sur ce sujet.

• Catégories de contenu Contenu de flux, contenu phrasé, contenu intégré. Si l'attribut controls est utilisé : contenu interactif.
• Contenu autorisé Si l'élément possède un attribut src : zéro ou plusieurs éléments <track>, suivis par du contenu transparent ne contenant pas d'éléments média, c'est-à-dire des éléments qui ne soient pas <audio> ou <video>
  Sinon : zéro ou plusieurs éléments <source> suivis par un élément <track>, suivi par du contenu transparent ne contenant pas d'éléments média (ni <audio> ni <video>).
• Omission de balises Aucune, la balise d'ouverture et la balise de fermeture sont obligatoires
• Éléments parents autorisés Tout élément acceptant du contenu intégré.
• Interface DOM HTMLAudioElement

Attributs

Comme tous les autres éléments HTML, cet élément possède les attributs globaux.

• none : cela indique que soit l'auteur pense que l'utilisateur n'aura pas besoin de cet élément soit que le serveur souhaite minimiser son traffic. En d'autres termes, cela indique que l'élément audio ne devrait pas être mis en cache.
• metadata : cela indique que, malgré que l'auteur pense que l'utilisateur n'aura pas besoin de l'élément audio, il est préférable de préparer les méta-données (comme la durée)
• auto : cela indique que l'utilisateur a besoin de cet élément en priorité. Cela signifie que, si nécessaire, l'élément audio en entier sera téléchargé même si l'utilisateur pourra ne pas le lire.
• "" (chaîne de caractères vide) : synonyme de auto

autoplay

Un attribut booléen. Si celui-ci est renseigné (même avec une valeur "false"), l'élément audio sera joué automatiquement dès qu'assez de données auront été chargées pour que la lecture ne soit pas interrompue.

autobuffer Obsolète depuis Gecko 2.0

Un attribut booléen. Si il est renseigné, l'élément audio sera automatiquement téléchargé (il n'est pas nécessaire qu'il soit joué automatiquement). Cela se poursuit jusqu'au remplissage du cache média ou si tout le fichier a été téléchargé. Cela ne devrait être utilisé que dans le cas où l'utilisateur pourra choisir de jouer ou non le son. Cet attribut a été retiré de Gecko 2.0 pour être remplacé par l'attribut preload.

buffered

Un attribut qui peut être lu pour connaître le nombre d'intervalles de temps du média qui ont été mis en tampon. Cet attribut contient un objet TimeRanges.

controls

Si l'attribut est présent, le navigateur offrira à l'utilisateur des contrôles pour qu'il puisse gérer la lecture, le volume, la navigation, et la pause ou la reprise de la lecture.

loop

Un attribut booléen. S'il est renseigné, la lecture du fichier se fera en boucle..

mozCurrentSampleOffset

Le décalage, en nombre d'échantillons, à partir du début du flux audio jusqu'au fragment lu actuellement.

muted

Un attribut booléen, indiquant si le son de l'élément audio doit être coupé. Sa valeur par défaut est false, indiquant que l'élément audio doit être joué.

played

Un objet TimeRanges indiquant tous les fragments de l'élément audio ayant été joués.

preload

Cet attribut énuméré permet de fournir au navigateur une indication lui permettant de savoir ce que l'auteur de la page pense de l'utilisation optimale de cet élément. Il peut prendre les valeurs suivantes :

Si cet attribut n'est pas renseigné, la valeur par défaut sera celle du navigateur (chaque navigateur pouvant définir sa propre valeur). Les spécifications conseillent la valeur metadata comme valeur par défaut.

src

 L'URL du fichier audio à inclure. Cet attribut est sujet aux spécifications du CORS. Il est optionnel et il est possible d'utiliser l'élément <source> dans le bloc de cet élément pour définir les fichiers audio à intégrer.

volume

Le volume de la partie audio, fournie comme une valeur flottante comprise entre 0.0 (silencieux) et 1.0 (le volume le plus élevé).

Les valeurs de décalages sont définies en nombres flottants, indiquant le nombres de secondes pour le décalage.

Événements

Un élément audio peut déclencher plusieurs événements.

Exemples

Utilisation simple

<!-- Simple lecture audio -->
<audio src="http://developer.mozilla.org/@api/deki/files/2926/=AudioTest_(1).ogg" autoplay>
  Votre navigateur ne supporte pas l'élément <code>audio</code>.
</audio>

<!-- Lecture Audio avec sous-titres -->
<audio src="toto.ogg">
  <track kind="captions" src="toto.fr.vtt" srclang="fr" label="Français">
  <track kind="captions" src="toto.sv.vtt" srclang="sv" label="Svenska">
</audio> 

Utilisation de l'élément source

<audio controls="controls">
  Votre navigateur ne supporte pas l'élément <code>audio</code> element.
  <source src="toto.wav" type="audio/wav">
</audio>

Spécifications

Compatibilité des navigateurs

Voir aussi

• Formats de média supportés par les éléments audio et video
• Web Audio API
• HTMLAudioElement
• nsIDOMHTMLMediaElement
• <source>
• <video>
• Utiliser les éléments HTML5 audio et video
• L'élément audio selon la spécification HTML5