CKTIS / HTML
controlslist — odabir izvornih medijskih kontrola
Atribut controlslist govori pregledniku koje mogućnosti treba izostaviti iz izvornih audio i video kontrola. Njegov JavaScriptov ekvivalent, HTMLMediaElement.controlsList, izlaže popis tokena. Podrška ovisi o pregledniku.
Verzija: WICG Controls List draft; index snapshot date recorded separately
Sintaksa
controlslist="nodownload nofullscreen noremoteplayback"; media.controlsList.add("nodownload")controlslist je atribut elemenata audio i video koji sadrži tokene odvojene razmacima. Pomaže pregledniku odabrati vlastite medijske kontrole. Sam ih ne uključuje; za to služi zaseban atribut controls. Također ne upravlja gumbima reproduktora koji je izradio autor stranice.
Token nodownload traži izostavljanje mogućnosti preuzimanja, nofullscreen mogućnosti prikaza preko cijelog zaslona, a noremoteplayback mogućnosti reprodukcije na udaljenom uređaju. Tokeni se mogu kombinirati. To su upute za sučelje, a ne zaštita sadržaja: skrivanje mogućnosti preuzimanja ne sprječava spremanje datoteke.
HTMLMediaElement.controlsList JavaScriptov je ekvivalent atributa i vraća DOMTokenList. Naziv atributa je controlslist, a naziv svojstva controlsList. Metode add(), remove() i contains() omogućuju upravljanje tokenima; promjena popisa ažurira atribut. Dohvaćeno svojstvo izlaže objekt čiji se sadržaj može mijenjati.
Podrška je ograničena, pa prije uporabe API-ja provjeri postoji li controlsList i testiraj sučelje u ciljanim preglednicima. Samo otkrivanje svojstva ne dokazuje da će svaka uputa promijeniti izgled kontrola. Primjer u nastavku provjerava sinkronizaciju popisa i atributa bez učitavanja medija.
Primjeri
(() => {
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.