CKTIS / HTML
controlslist — scegliere i controlli multimediali nativi
L’attributo controlslist indica al browser quali opzioni omettere nei controlli nativi di audio e video. La controparte JavaScript, HTMLMediaElement.controlsList, espone un elenco di token. Il supporto dipende dal browser.
Versione: WICG Controls List draft; index snapshot date recorded separately
Sintassi
controlslist="nodownload nofullscreen noremoteplayback"; media.controlsList.add("nodownload")controlslist è un attributo degli elementi audio e video che contiene token separati da spazi. Aiuta il browser a scegliere i propri controlli multimediali. Non attiva da solo questi controlli: a questo serve l’attributo separato controls. Inoltre, non controlla i pulsanti di un lettore realizzato da chi crea la pagina.
Il token nodownload richiede di omettere l’opzione di download, nofullscreen quella a schermo intero e noremoteplayback quella per la riproduzione su un dispositivo remoto. I token possono essere combinati. Sono indicazioni per l’interfaccia, non una protezione dei contenuti: nascondere l’opzione di download non impedisce di salvare il file.
HTMLMediaElement.controlsList è la controparte JavaScript dell’attributo e restituisce una DOMTokenList. Il nome dell’attributo è controlslist, mentre quello della proprietà è controlsList. I metodi add(), remove() e contains() consentono di gestire i token; modificando l’elenco si aggiorna l’attributo. La proprietà restituisce un oggetto di cui è possibile modificare il contenuto.
Il supporto è limitato: verifica quindi la presenza di controlsList prima di usare l’API e prova l’interfaccia nei browser di destinazione. La sola rilevazione della proprietà non dimostra che ogni indicazione modifichi l’aspetto dei controlli. L’esempio seguente verifica la sincronizzazione tra elenco e attributo senza caricare contenuti multimediali.
Esempi
(() => {
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"));
})();Risultato
nodownload nofullscreen true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.