CKTIS / HTML
controlslist — elegir los controles multimedia nativos
El atributo controlslist indica al navegador qué opciones debe omitir en los controles nativos de audio y vídeo. Su equivalente en JavaScript, HTMLMediaElement.controlsList, expone una lista de tokens. La compatibilidad depende del navegador.
Versión: WICG Controls List draft; index snapshot date recorded separately
Sintaxis
controlslist="nodownload nofullscreen noremoteplayback"; media.controlsList.add("nodownload")controlslist es un atributo de los elementos audio y video que contiene tokens separados por espacios. Ayuda al navegador a elegir sus propios controles multimedia. No activa esos controles por sí solo: para eso está el atributo independiente controls. Tampoco controla los botones de un reproductor implementado por quien crea la página.
El token nodownload solicita omitir la opción de descarga, nofullscreen la opción de pantalla completa y noremoteplayback la opción de reproducción en un dispositivo remoto. Se pueden combinar. Son indicaciones para la interfaz, no una protección del contenido: ocultar la opción de descarga no impide que se guarde el archivo.
HTMLMediaElement.controlsList es el equivalente en JavaScript del atributo y devuelve una DOMTokenList. El nombre del atributo es controlslist, mientras que el nombre de la propiedad es controlsList. Los métodos add(), remove() y contains() permiten gestionar los tokens; al cambiar la lista, se actualiza el atributo. La propiedad devuelve un objeto cuyo contenido se puede modificar.
La compatibilidad es limitada, así que comprueba que exista controlsList antes de usar la API y prueba la interfaz en los navegadores de destino. Detectar la propiedad por sí solo no demuestra que todas las indicaciones cambien el aspecto de los controles. El ejemplo siguiente comprueba la sincronización entre la lista y el atributo sin cargar contenido multimedia.
Ejemplos
(() => {
const video = document.createElement("video");
video.controls = true;
video.setAttribute("controlslist", "nodownload");
if (!("controlsList" in video)) {
console.log("controlsList: unsupported");
return;
}
video.controlsList.add("nofullscreen");
console.log(video.getAttribute("controlslist"));
console.log(video.controlsList.contains("nodownload"));
})();Resultado
nodownload nofullscreen true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.