Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje