Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

controlslist — výběr nativních ovládacích prvků médií

Atribut controlslist říká prohlížeči, které možnosti má vynechat v nativním ovládání audia a videa. Jeho protějšek v JavaScriptu, HTMLMediaElement.controlsList, zpřístupňuje seznam tokenů. Podpora závisí na prohlížeči.

Verze: WICG Controls List draft; index snapshot date recorded separately

Syntaxe

controlslist="nodownload nofullscreen noremoteplayback"; media.controlsList.add("nodownload")

controlslist je atribut prvků audio a video, který obsahuje tokeny oddělené mezerami. Pomáhá prohlížeči vybrat jeho vlastní ovládací prvky médií. Sám je ale nezapíná; k tomu slouží samostatný atribut controls. Neovládá ani tlačítka přehrávače vytvořeného autorem stránky.

Token nodownload požaduje vynechání možnosti stažení, nofullscreen možnosti zobrazení na celou obrazovku a noremoteplayback možnosti přehrávání na vzdáleném zařízení. Tokeny lze kombinovat. Jde o pokyny pro rozhraní, nikoli o ochranu obsahu: skrytí možnosti stažení nebrání uložení souboru.

HTMLMediaElement.controlsList je protějšek atributu v JavaScriptu a vrací DOMTokenList. Název atributu je controlslist, zatímco název vlastnosti je controlsList. Metody add(), remove() a contains() umožňují spravovat tokeny; změna seznamu aktualizuje atribut. Získaná vlastnost zpřístupňuje objekt, jehož obsah lze měnit.

Podpora je omezená, proto před použitím API ověř přítomnost controlsList a otestuj rozhraní v cílových prohlížečích. Samotné zjištění této vlastnosti nedokazuje, že každý pokyn změní vzhled ovládacích prvků. Následující příklad ověřuje synchronizaci seznamu s atributem bez načítání médií.

Pří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ýsledek

nodownload nofullscreen
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje