CKTIS / HTML
controlslist — výber natívnych ovládacích prvkov médií
Atribút controlslist hovorí prehliadaču, ktoré možnosti má vynechať v natívnych ovládacích prvkoch audia a videa. Jeho náprotivok v JavaScripte, HTMLMediaElement.controlsList, sprístupňuje zoznam tokenov. Podpora závisí od prehliadača.
Verzia: WICG Controls List draft; index snapshot date recorded separately
Syntax
controlslist="nodownload nofullscreen noremoteplayback"; media.controlsList.add("nodownload")controlslist je atribút prvkov audio a video, ktorý obsahuje tokeny oddelené medzerami. Pomáha prehliadaču vybrať jeho vlastné ovládacie prvky médií. Sám ich však nezapína; na to slúži samostatný atribút controls. Neovláda ani tlačidlá prehrávača vytvoreného autorom stránky.
Token nodownload žiada vynechať možnosť stiahnutia, nofullscreen možnosť zobrazenia na celú obrazovku a noremoteplayback možnosť prehrávania na vzdialenom zariadení. Tokeny možno kombinovať. Sú to pokyny pre rozhranie, nie ochrana obsahu: skrytie možnosti stiahnutia nebráni uloženiu súboru.
HTMLMediaElement.controlsList je náprotivok atribútu v JavaScripte a vracia DOMTokenList. Názov atribútu je controlslist, zatiaľ čo názov vlastnosti je controlsList. Metódy add(), remove() a contains() umožňujú spravovať tokeny; zmenou zoznamu sa aktualizuje atribút. Získaná vlastnosť sprístupňuje objekt, ktorého obsah možno meniť.
Podpora je obmedzená, preto pred použitím API skontroluj prítomnosť controlsList a otestuj rozhranie v cieľových prehliadačoch. Samotné zistenie vlastnosti nedokazuje, že každý pokyn zmení vzhľad ovládacích prvkov. Nasledujúci príklad kontroluje synchronizáciu zoznamu s atribútom bez načítania médií.
Príklady
(() => {
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"));
})();Výsledok
nodownload nofullscreen true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.