<audio>

L'élément HTML <audio> est utilisé pour intégrer un contenu sonore dans un document. Il peut contenir une ou plusieurs sources audio représentées avec l'attribut src ou l'élément <source>. S'il y a plusieurs sources le navigateur choisit celle qui lui convient le mieux.

Il est possible d'intégrer un contenu alternatif entre la balise ouvrante <audio> et la balise fermante </audio> pour les navigateurs qui ne supportent pas la balise <audio>.

Les fonctionnalités de lecture basiques sont accessibles avce l'attribut controls (voir plus bas); pour une utilisation plus avancée, les fonctionnalités de lecture peuvent être manipulées à l'aide de la  HTML API, et les fonctions plus spécifiques définies dans l'interface HTMLAudioElement.

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

Contexte d'utilisation

• Contenu autorisé: si l'élément a un attribut src: zéro, un ou plusieurs éléments  <track>, suivis par un contenu transparent qui ne contient pas d'éléments media — c'est-à-dire pas d'éléments <audio> ni <video>.
• Sinon: zéro, un ou plusieurs éléments <source>, suivis par zéro, un ou plusieurs éléments <track>, suivis par un contenu transparent qui ne contient pas d'éléments media — c'est-à-dire pas d'éléments <audio> ni <video>.

• Catégories de contenu Contenu de flux, contenu phrasé, contenu intégré.
  Si l'attribut controls est utilisé : contenu interactif et contenu tangible..
• 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.

autoplay

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 seront chargées.

autobuffer Obsolète depuis Gecko 2.0

Attribut booléen. Si il est renseigné, l'élément audio commencera automatiquement à charger les données (même si l'attribut autoplay n'est pas renseigné). Le chargement se poursuit jusqu'à ce que le cache média soit plein, ou que tout le fichier soit téléchargé. Cela ne devrait être utilisé que s'il est attendu que l'utilisateur pourra joue le son; par exemple quand il s'est rendu sur une page en suivant un lien "Jouer ce son". Cet attribut a été retiré de Gecko 2.0 pour être remplacé par l'attribut preload.

buffered

Attribut qui indique le ou les intervalles de temps du média qui ont été mis en mémoire tampon. Cet attribut contient un objet TimeRanges.

controls

Si l'attribut est présent, le navigateur affichera des contrôles pour que l'utilisateur puisse gérer la lecture, le volume, et le déplacement du curseur de lecture.

loop

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

mozCurrentSampleOffset

Indique le décalage, en nombre d'échantillons, entre le début du flux audio et le fragment en cours de lecture.

muted

Attribut booléen, indiquant si le son de l'élément audio est initialement être coupé. Sa valeur par défaut est false.

played

Un objet TimeRanges indiquant tous les fragments de l'élément audio qui ont déjà été joués.

preload

Cet attribut indique au navigateur ce que l'auteur du code html pense de l'utilisation optimale de cet élément. Il accepte uniquement les valeurs suivantes :
 

• none :  l'élément audio ne devrait pas être mis en cache
• metadata : seules les méta-données (comme la durée) sont préchargées
• auto : tout le fichier peut être téléchargé, même s'il n'est pas certain que l'utilisateur le lira
• "" (chaîne de caractères vide) : synonyme de auto

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 recommandent la valeur metadata.

src

 L'URL du fichier audio à intégrer. Cet attribut suit les spécifications du CORS. Il est optionnel; on peut lui préférer l'élément <source> dans le bloc de l'élément sur lequel il est défini.

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écalage sont définies en nombres flottants, l'unité étant la seconde.

Événements

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

Exemples

Utilisation simple

<!-- Simple lecture audio -->
<audio src="https://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>.
  <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