<audio>

Un lecteur audio : podcast, voix off, effet sonore.

Affichage
inline (invisible sans `controls`)
Balise fermante
Obligatoire
Contenu autorisé
Des éléments <source> et <track>, suivis d’un contenu de remplacement
Sur cette page

Exemple

#
HTML
<p>Épisode 12 : comment ne pas rester coincé dans les tutoriels</p>
<audio controls preload="none">
  <source src="/podcast/odcinek-12.mp3" type="audio/mpeg">
  <a href="/podcast/odcinek-12.mp3">Télécharger l’épisode en MP3</a>
</audio>
Aperçu

Le fichier audio est omis de l’aperçu, c’est pourquoi le lecteur n’affiche que les commandes.

Définition et utilisation

#

L’élément <audio> intègre un fichier audio dans la page. Vous indiquez l’adresse dans l’attribut src, ou dans plusieurs éléments <source> si vous voulez proposer différents formats. Le choix le plus sûr est le MP3, que tout navigateur moderne sait lire.

Sans l’attribut controls, le lecteur est invisible et le son ne peut être lancé que par un script. Avec controls, le navigateur affiche sa propre barre avec un bouton de lecture, une ligne de temps et un réglage du volume.

Les navigateurs bloquent généralement la lecture automatique du son tant que l’utilisateur n’a pas cliqué sur quelque chose dans la page, si bien que autoplay ne fonctionne souvent pas. C’est une bonne chose : un son inattendu est l’un des comportements les plus agaçants d’un site. Le contenu entre les balises n’est affiché que par les navigateurs qui ne prennent pas du tout en charge <audio>.

Syntaxe

#
Syntaxe
<audio src="enregistrement.mp3" controls></audio>

Attributs

#
  • src

    URL

    L’adresse du fichier audio. À la place, vous pouvez placer à l’intérieur plusieurs éléments <source> avec des formats différents.
  • controls

    attribut booléen

    Affiche les commandes intégrées du lecteur. Sans lui, l’élément est complètement invisible, comme on le voit dans la seconde partie de l’exemple.
  • autoplay

    attribut booléen

    Tente de lire le son dès le chargement. Les navigateurs le bloquent généralement tant que l’utilisateur n’a pas interagi avec la page : ne comptez donc pas sur cet attribut.
  • loop

    attribut booléen

    Une fois arrivé à la fin, l’enregistrement recommence. Utile, par exemple, pour la musique de fond d’un jeu.
  • muted

    attribut booléen

    Démarre le lecteur avec le son coupé. L’utilisateur peut le réactiver dans les commandes.
  • preload

    none | metadata | auto

    Une indication sur la quantité de données à télécharger avant la lecture. none ne télécharge rien, metadata uniquement les informations sur le fichier (par exemple sa durée), et auto autorise le téléchargement du fichier entier. Le navigateur peut ignorer cette indication.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

src

URL

L’adresse du fichier audio. À la place, vous pouvez placer à l’intérieur plusieurs éléments <source> avec des formats différents.

HTML
<audio src="/lekcje/wymowa-terminow.mp3" controls preload="none"></audio>
Aperçu

Le fichier audio est omis de l’aperçu.

controls

attribut booléen

Affiche les commandes intégrées du lecteur. Sans lui, l’élément est complètement invisible, comme on le voit dans la seconde partie de l’exemple.

HTML
<p>Avec commandes :</p>
<audio src="/lekcje/intro.mp3" controls preload="none"></audio>
<p>Sans commandes (le lecteur est là, mais on ne le voit pas) :</p>
<audio src="/lekcje/intro.mp3" preload="none"></audio>
Aperçu

Le fichier audio est omis de l’aperçu.

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
audio:not([controls]) {
  display: none !important;
}

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Joignez une transcription de l’enregistrement, par exemple sous le lecteur ou dans un <details>. Elle aide les personnes sourdes ou malentendantes et tous ceux qui préfèrent lire.
  • Définissez preload="none" ou preload="metadata" pour les enregistrements que l’utilisateur ne lira peut-être pas. La page ne téléchargera alors pas tout le fichier à l’avance.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.