CKTIS / HTML
controls: comandos fornecidos pelo navegador
Disponibilize comandos úteis sem prometer a mesma interface em todos os dispositivos.
Versão: HTML Living Standard
Sintaxe
<video controls muted></video>Em áudio e vídeo, o booleano controls pede comandos de reprodução ao navegador. Conta a presença, mesmo com o valor textual false. Reprodução, pausa, volume, deslocação temporal e legendas dependem do recurso e da plataforma. Remover o atributo não impede menus do navegador nem teclas multimédia.
A norma atual também permite comandos opcionais em img, apenas com alt presente e não vazio. Esta novidade depende da plataforma e não é verificada aqui. Os comandos não autorizam reprodução automática nem impedem transferências ou capturas. Uma interface própria deve manter alternativas acessíveis.
O exemplo reproduz um fluxo local de canvas sem som e com comandos nativos. O Chromium 145 expõe um verdadeiro botão de pausa na árvore de acessibilidade. O teste verifica reprodução e botão, não comandos de imagens, todas as disposições ou a voz de um leitor de ecrã.
Exemplos
<!doctype html><meta charset="utf-8">
<canvas id="canvas" width="40" height="30"></canvas><video id="video" controls muted width="320" height="180"></video>
<output id="result"></output><script>
const canvas = document.querySelector('#canvas'), video = document.querySelector('#video');
canvas.getContext('2d').fillRect(0, 0, 40, 30);
video.srcObject = canvas.captureStream(1);
video.addEventListener('playing', () => {
document.querySelector('#result').textContent = 'controls=' + video.controls + '; playing=' + !video.paused;
}, { once: true });
video.play(); // Also usable through the browser's native media controls.
</script>Resultado
controls=true; playing=true
O fluxo contém apenas um desenho local; não utiliza câmara, microfone nem conteúdos externos.