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.