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
- HTML Standard — User interface (standard native controls, not the controlslist extension)
- HTML Standard — Playing the media resource (standard playback behavior, including playbackRate)
- HTMLMediaElement: controlsList property (browser extension)
- <video>: The Video Embed element — controlslist attribute
- <audio>: The Embed Audio element — controlslist attribute
- Element: getAttribute() method