CKTIS / HTML
controlslist — izbira izvornih kontrolnikov za predstavnostne vsebine
Atribut controlslist brskalniku pove, katere možnosti naj izpusti v izvornih kontrolnikih za zvok in video. Njegov JavaScriptov ustreznik, HTMLMediaElement.controlsList, izpostavi seznam žetonov. Podpora je odvisna od brskalnika.
Različica: WICG Controls List draft; index snapshot date recorded separately
Sintaksa
controlslist="nodownload nofullscreen noremoteplayback"; media.controlsList.add("nodownload")controlslist je atribut elementov audio in video. Njegova vrednost je seznam žetonov, ločenih s presledki. Brskalniku pomaga določiti, katere kontrolnike naj prikaže v svojem predvajalniku. Sam jih ne vklopi; temu je namenjen ločen atribut controls. Prav tako ne vpliva na gumbe predvajalnika, ki jih je ustvaril avtor strani.
Žeton nodownload brskalniku nakaže, naj izpusti možnost prenosa, nofullscreen možnost celozaslonskega prikaza, noremoteplayback pa možnost predvajanja na oddaljeni napravi. Žetone je mogoče kombinirati. To so namigi za uporabniški vmesnik, ne pa zaščita vsebine: skrivanje možnosti prenosa ne prepreči shranjevanja datoteke.
HTMLMediaElement.controlsList je ustreznik atributa v JavaScriptu in vrne objekt DOMTokenList. Atribut se imenuje controlslist, lastnost pa controlsList. Žetone lahko dodaš z metodo add(), odstraniš z metodo remove() in njihovo prisotnost preveriš z metodo contains(). Ko spremeniš seznam, se posodobi tudi atribut. Ko prebereš vrednost lastnosti, dobiš objekt, katerega vsebino lahko spreminjaš.
Podpora je omejena, zato pred uporabo API-ja preveri, ali je lastnost controlsList na voljo, in preizkusi vmesnik v ciljnih brskalnikih. Sam obstoj lastnosti še ne pomeni, da bo vsak namig vplival na videz kontrolnikov. Spodnji primer preveri, ali se seznam in atribut sinhronizirata, ne da bi naložil predstavnostno vsebino.
Primeri
(() => {
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"));
})();Rezultat
nodownload nofullscreen true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.