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

CKTIS / HTML

`controlslist` em elementos de vídeo e áudio

`controlslist` dá uma indicação ao leitor integrado do navegador. `nodownload` pode ocultar a opção de transferência, enquanto `noplaybackrate` não é normalizado. Nenhum protege o ficheiro multimédia.

Versão: Non-standard media-controls extension; browser support varies

Sintaxe

<video controls controlslist="nodownload noplaybackrate"></video>
<audio controls controlslist="nodownload noplaybackrate"></audio>
The HTML Living Standard defines `controls` and `HTMLMediaElement.playbackRate`, not the `controlslist` attribute or the `HTMLMediaElement.controlsList` property. Those are a browser extension with limited support.
JavaScript, where supported: media.controlsList (DOMTokenList); media.controlsList.add("nodownload"). The token noplaybackrate is non-standard.

Em video e audio, a presença do atributo booleano controls pede ao navegador que mostre os seus controlos integrados. controlslist não os ativa: fornece tokens separados por espaços para orientar o navegador na escolha dos controlos a apresentar. Quando esta funcionalidade está implementada, a propriedade JavaScript media.controlsList devolve uma DOMTokenList que pode ser alterada, por exemplo com media.controlsList.add("nodownload").

nodownload pede ao navegador que oculte a opção de transferência, se existir. noplaybackrate destina-se a ocultar o seletor de velocidade quando o navegador reconhece esse token. Não é normalizado e não consta da lista de tokens suportados indicada pela MDN. O HTML Living Standard define controls e media.playbackRate, mas não o atributo controlslist nem a propriedade media.controlsList. O suporte desta extensão nos navegadores é limitado. Ler o texto do atributo ou detetar a propriedade não prova que uma opção do menu tenha sido ocultada. Testa os controlos nos navegadores de destino e garante que o leitor continua utilizável se a indicação for ignorada.

Ocultar o seletor de velocidade não bloqueia media.playbackRate. Da mesma forma, ocultar a opção de transferência não impede que o navegador obtenha os dados necessários à reprodução nem que esses dados sejam guardados. controlslist não substitui o controlo de acesso no servidor e não protege o ficheiro contra cópias.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Inspect media controls markup</title>
<video id="video" controls controlslist="nodownload noplaybackrate"></video>
<audio id="audio" controls controlslist="nodownload noplaybackrate"></audio>
<pre id="result"></pre>
<script>
  const lines = ['video', 'audio'].map((id) => {
    const media = document.getElementById(id);
    return `${id}: controls=${media.controls}; controlslist=${media.getAttribute('controlslist')}`;
  });
  document.getElementById('result').textContent = lines.join('\n');
</script>
</html>

Resultado

video: controls=true; controlslist=nodownload noplaybackrate
audio: controls=true; controlslist=nodownload noplaybackrate

As duas linhas apresentam `controls` e o texto do atributo. O exemplo não inclui fontes multimédia e não verifica quais as opções que ficam ocultas.

Lições relacionadas

  • HTML · Lição 11 · Avançado · Versão: 2

Fontes