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.