Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti