Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

élément HTML: audio

L’élément audio incorpore une ressource sonore et expose le modèle du navigateur pour sélection de source, tampon, temps et lecture.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<audio controls preload="metadata" src="sound.wav"></audio>

audio peut employer un src ou contenir des candidats source ordonnés ; le type, facultatif, aide lorsqu’il est fourni à ignorer les formats non pris en charge. Le texte enfant ne sert de repli qu’aux navigateurs sans cet élément, non d’alternative accessible ou de transcription pour ceux qui le prennent en charge.

controls affiche les commandes natives, preload n’est qu’une indication et autoplay peut être bloqué ; muted et loop modifient silence initial et répétition.

play() renvoie une Promise que la politique ou une erreur de ressource peut rejeter ; pause() arrête la lecture et currentTime déplace la position lorsque le média est prêt.

L’exemple attend loadedmetadata sur un WAV incorporé et lit duration, paused et le currentSrc résolu sans démarrer le son.

Exemples

<!doctype html>
<meta charset="utf-8">
<audio id="clip" controls preload="metadata" src="data:audio/wav;base64,UklGRiwAAABXQVZFZm10IBAAAAABAAEAQB8AAEAfAAABAAgAZGF0YQgAAACAgICAgICAgA=="></audio>
<output id="result"></output>
<script>
const clip = document.querySelector("#clip");
clip.addEventListener("loadedmetadata", () => {
  document.querySelector("#result").textContent = `duration=${clip.duration.toFixed(3)}; paused=${clip.paused}; controls=${clip.controls}; source=${clip.currentSrc.startsWith("data:audio/wav")}`;
}, { once: true });
</script>

Résultat

duration=0.001; paused=true; controls=true; source=true

Le résultat confirme métadonnées chargées, commandes natives et source choisie ; il ne prouve ni lecture audible ni autorisation autoplay.

Sources