База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

controlslist — избор на вградените контроли за медия

Атрибутът controlslist указва на браузъра кои опции да пропусне във вградените контроли за аудио и видео. Неговият JavaScript еквивалент, HTMLMediaElement.controlsList, предоставя списък с токени. Поддръжката зависи от браузъра.

Версия: WICG Controls List draft; index snapshot date recorded separately

Синтаксис

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

controlslist е атрибут на елементите audio и video, който съдържа токени, разделени с интервали. Той помага на браузъра да избере собствените си контроли за медия. Сам по себе си не ги включва — за това служи отделният атрибут controls. Освен това не управлява бутоните на плейър, създаден от автора на страницата.

Токенът nodownload указва да се пропусне опцията за изтегляне, nofullscreen — опцията за цял екран, а noremoteplayback — опцията за възпроизвеждане на отдалечено устройство. Токените могат да се комбинират. Те са указания за интерфейса, а не защита на съдържанието: скриването на опцията за изтегляне не предпазва файла от запазване.

HTMLMediaElement.controlsList е JavaScript еквивалентът на атрибута и връща DOMTokenList. Името на атрибута е controlslist, а името на свойството е controlsList. Методите add(), remove() и contains() позволяват управление на токените; промяната на списъка обновява атрибута. Полученото свойство предоставя обект, чието съдържание може да се променя.

Поддръжката е ограничена, затова провери дали controlsList съществува, преди да използваш API, и тествай интерфейса в целевите браузъри. Самото откриване на свойството не доказва, че всяко указание ще промени изгледа на контролите. Примерът по-долу проверява синхронизацията между списъка и атрибута, без да зарежда медия.

Примери

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

Резултат

nodownload nofullscreen
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници