Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori