Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

muted — silenciamento predefinido de conteúdos multimédia

O atributo booleano `muted` define o silenciamento predefinido dos elementos de áudio e vídeo. A propriedade `defaultMuted` reflete o atributo, enquanto `muted` lê e altera o silenciamento atual.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

muted define o silenciamento predefinido dos elementos audio e video. Não é uma instrução para iniciar a reprodução.

Enquanto atributo booleano, aceita as formas muted, muted="" e muted="muted". A sua omissão equivale a false. Escrever muted="false" é inválido e continua a significar que o atributo está presente, não que está desativado.

Em JavaScript, defaultMuted reflete a presença do atributo, enquanto muted controla o silenciamento atual. Depois de definir a propriedade muted ou de o utilizador indicar uma preferência, o atributo deixa de controlar o estado atual. muted = false não remove o atributo.

O exemplo define explicitamente o estado atual e, em seguida, retira o silenciamento. O resultado [true,false] demonstra a diferença entre a definição predefinida e a atual.

Exemplos

<!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>

Resultado

[true,true]
[true,false]

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes