Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

controlslist — wybór natywnych kontrolek multimediów

Atrybut controlslist wskazuje przeglądarce, które opcje pominąć w natywnych kontrolkach audio i video. Powiązana właściwość HTMLMediaElement.controlsList udostępnia listę tokenów w JavaScript. Obsługa zależy od przeglądarki.

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

Składnia

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

controlslist to atrybut elementów audio i video zawierający tokeny rozdzielone spacjami. Pomaga przeglądarce dobrać jej własne kontrolki multimediów. Nie włącza ich samodzielnie: do tego służy osobny atrybut controls. Nie steruje też przyciskami odtwarzacza napisanymi przez autora strony.

Token nodownload wskazuje pominięcie opcji pobierania, nofullscreen — opcji pełnego ekranu, a noremoteplayback — opcji odtwarzania na urządzeniu zdalnym. Można łączyć te tokeny. Są to wskazówki dotyczące interfejsu, nie zabezpieczenia treści: ukrycie opcji pobierania nie chroni pliku przed zapisaniem.

HTMLMediaElement.controlsList jest odpowiednikiem atrybutu w JavaScript i zwraca DOMTokenList. Nazwa atrybutu to controlslist, a nazwa właściwości to controlsList. Metody add(), remove() i contains() pozwalają zarządzać tokenami; zmiana listy aktualizuje atrybut. Odczytywana właściwość udostępnia obiekt, którego zawartość można modyfikować.

Obsługa jest ograniczona, więc sprawdzaj obecność controlsList przed użyciem API i testuj interfejs w docelowych przeglądarkach. Samo wykrycie właściwości nie dowodzi, że każda wskazówka zmieni wygląd kontrolek. Poniższy przykład sprawdza synchronizację listy z atrybutem bez ładowania multimediów.

Przykłady

(() => {
  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"));
})();

Wynik

nodownload nofullscreen
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła