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

CKTIS / HTML

muted — mise en sourdine par défaut des médias

L’attribut booléen `muted` définit la mise en sourdine par défaut des éléments audio et vidéo. La propriété `defaultMuted` reflète l’attribut, tandis que `muted` lit et modifie la mise en sourdine actuelle.

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

Syntaxe

<audio muted></audio>
<video muted></video>

muted définit la mise en sourdine par défaut des éléments audio et video. Ce n’est pas une commande pour démarrer la lecture.

En tant qu’attribut booléen, il accepte les écritures muted, muted="" et muted="muted". Son omission équivaut à false. L’écriture muted="false" est invalide et signifie tout de même que l’attribut est présent, et non qu’il est désactivé.

En JavaScript, defaultMuted reflète la présence de l’attribut, tandis que muted contrôle la mise en sourdine actuelle. Une fois la propriété muted définie ou une préférence indiquée par l’utilisateur, l’attribut ne contrôle plus l’état actuel. muted = false ne supprime pas l’attribut.

L’exemple définit explicitement l’état actuel, puis réactive le son. Le résultat [true,false] montre la différence entre le réglage par défaut et le réglage actuel.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>muted</title>
<video id="media" muted></video>
<pre id="result"></pre>
<script>
  const media = document.getElementById('media');
  media.muted = true;
  const lines = [JSON.stringify([media.defaultMuted, media.muted])];
  media.muted = false;
  lines.push(JSON.stringify([media.defaultMuted, media.muted]));
  document.getElementById('result').textContent = lines.join('\n');
</script>

Résultat

[true,true]
[true,false]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources