<audio>

Ajouté dans HTML5

Résumé

L'élément HTML <audio> désigne du contenu sonore présent dans un document. L'élément audio a été ajouté dans HTML5 et 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é.

Vous pouvez utiliser les fonctionnalités avancées de l'API Audio (spécifiques à Gecko), pour générer et manipuler des flux audio avec du code JavaScript. Voir l'introduction à l'API Audio pour plus de détails.

Attributs

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

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ératif 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 :
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
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.
Notes d'utilisation : L'attribut autoplay annulera cet attribut. Si le navigateur a besoin de jouer cet élément, il le téléchargera automatiquement. Renseigner les deux attributs autoplay et preload est autorisé par la spécification. Bien que le navigateur n'a pas, selon la spécification, à suivre la valeur de cet attribut. Il n'est qu'une simple indication.
 
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.

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

Note : La définition de cette valeur de décalage n'a pas encore été finalisée dans la spécification HTML5 et est donc sujette à changements.

 

Exemples

Exemple 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="foo.ogg">
  <track kind="captions" src="foo.en.vtt" srclang="en" label="English">
  <track kind="captions" src="foo.sv.vtt" srclang="sv" label="Svenska">
</audio> 

Élément audio utilisant l'élément <source> :

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

Interface DOM

Cet élément implément l'interface DOM HTMLAudioElement.

Spécifications

Spécification Statut Commentaires
WHATWG HTML Living Standard Living Standard  
HTML5 Candidate Recommendation  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple 3.0 3.5 (1.9.1) 9.0 10.5 3.1
Attribut autoplay 3.0 3.5 (1.9.1) 9.0 10.5 3.1
Attribut buffered ? 4.0 (2.0) ? ? ?

Attribut controls

3.0 3.5 (1.9.1) 9.0 10.5 3.1
Attribut loop 3.0 11.0 (11.0) 9.0 10.5 3.1
Attribut muted ? 11.0 (11.0) ? ? ?
Propriété played ? 15.0 (15.0) ? ? ?
Attribut preload 3.0 4.0 (2.0) 9.0 Supporté sous l'ancien nom autobuffer 3.1
Attribut src 3.0 3.5 (1.9.1) 9.0 10.5 3.1
Fonctionnalité Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple ? 1.0 (1.0) ? ? ?
Attribut autoplay ? 1.0 (1.0) ? ? ?
Attribut buffered ? 4.0 (2.0) ? ? ?
Attribut controls ? 1.0 (1.0) ? ? ?
Attribut loop ? 11.0 (11.0) ? ? ?
Attribut muted ? 11.0 (11.0) ? ? ?
Propriété played ? 15.0 (15.0) ? ? ?
Attribut preload ? 4.0 (2.0) ? ? ?
Attribut src ? 1.0 (1.0) ? ? ?
Note : Actuellement, Gecko ne supporte que Vorbis, dans des conteneurs Ogg, ainsi que le format WAV.  Il faut aussi que le serveur renvoie le type MIME correct pour que Gecko joue le fichier correctement.

Voir également

Pièces jointes

Fichier Taille Date Joint par
AudioTest (1).ogg
42324 octets 2008-10-09 19:50:31 Sheppy
Zapfino.svg
1399728 octets 2009-12-25 15:15:25 andydude

Étiquettes et contributeurs liés au document

Contributeurs ayant participé à cette page : tregagnon, SphinxKnight
Dernière mise à jour par : tregagnon,