CKTIS / HTML
`controlslist` en elementos de vídeo y audio
`controlslist` orienta al reproductor integrado del navegador. `nodownload` puede ocultar la opción de descarga, mientras que `noplaybackrate` no es estándar. Ninguno protege el archivo multimedia.
Versión: Non-standard media-controls extension; browser support varies
Sintaxis
<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.En video y audio, la presencia del atributo booleano controls solicita los controles integrados del navegador. controlslist no los activa: proporciona tokens separados por espacios para orientar al navegador sobre qué controles mostrar. Si la función está implementada, la propiedad de JavaScript media.controlsList devuelve una DOMTokenList que se puede modificar, por ejemplo con media.controlsList.add("nodownload").
nodownload pide al navegador que oculte su opción de descarga si la ofrece. noplaybackrate pretende ocultar el selector de velocidad cuando el navegador reconoce ese token. No es estándar y no figura entre los tokens admitidos que enumera MDN. El HTML Living Standard define controls y media.playbackRate, pero no el atributo controlslist ni la propiedad media.controlsList. La compatibilidad de esta extensión con los navegadores es limitada. Leer el texto del atributo o detectar la propiedad no demuestra que se haya ocultado una opción del menú. Comprueba los controles en los navegadores de destino y asegúrate de que el reproductor siga siendo usable si se ignora la indicación.
Ocultar el selector de velocidad no bloquea media.playbackRate. Del mismo modo, ocultar la opción de descarga no impide que el navegador obtenga los datos necesarios para reproducir el contenido ni que esos datos se guarden. controlslist no sustituye el control de acceso en el servidor ni protege el archivo contra copias.
Ejemplos
<!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
Las dos líneas muestran `controls` y el texto del atributo. El ejemplo no tiene fuentes multimedia y no comprueba qué opciones se ocultan.
Lecciones relacionadas
- HTML · Lección 11 · Avanzado · Versión: 2
Fuentes
- 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