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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.