CKTIS / HTML
controlslist — native Mediensteuerelemente auswählen
Das Attribut controlslist weist den Browser an, welche Optionen in den nativen Audio- und Videosteuerungen ausgelassen werden sollen. Das JavaScript-Gegenstück HTMLMediaElement.controlsList stellt eine Tokenliste bereit. Die Unterstützung hängt vom Browser ab.
Version: WICG Controls List draft; index snapshot date recorded separately
Syntax
controlslist="nodownload nofullscreen noremoteplayback"; media.controlsList.add("nodownload")controlslist ist ein Attribut von audio- und video-Elementen und enthält durch Leerzeichen getrennte Tokens. Es hilft dem Browser, seine eigenen Mediensteuerelemente auszuwählen. Es aktiviert diese Steuerelemente nicht selbst; dafür dient das separate Attribut controls. Auch Schaltflächen eines vom Seitenautor entwickelten Players werden damit nicht gesteuert.
Das Token nodownload fordert dazu auf, die Downloadoption auszulassen, nofullscreen die Vollbildoption und noremoteplayback die Option zur Wiedergabe auf einem entfernten Gerät. Die Tokens lassen sich kombinieren. Sie sind Hinweise für die Benutzeroberfläche, kein Schutz für Inhalte: Wird die Downloadoption ausgeblendet, ist die Datei dadurch nicht vor dem Speichern geschützt.
HTMLMediaElement.controlsList ist das JavaScript-Gegenstück des Attributs und gibt eine DOMTokenList zurück. Der Attributname lautet controlslist, der Eigenschaftsname dagegen controlsList. Mit add(), remove() und contains() lassen sich Tokens verwalten; Änderungen an der Liste aktualisieren das Attribut. Die abgerufene Eigenschaft stellt ein Objekt bereit, dessen Inhalt geändert werden kann.
Die Unterstützung ist begrenzt. Prüfe daher vor der Verwendung der API, ob controlsList vorhanden ist, und teste die Benutzeroberfläche in den vorgesehenen Browsern. Allein der Nachweis der Eigenschaft belegt nicht, dass jeder Hinweis das Erscheinungsbild der Steuerelemente verändert. Das Beispiel prüft die Synchronisierung von Liste und Attribut, ohne Medien zu laden.
Beispiele
(() => {
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"));
})();Ergebnis
nodownload nofullscreen true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.