CKTIS / HTML
`controlslist` bei Video- und Audioelementen
`controlslist` ist ein Hinweis für den integrierten Player des Browsers. `nodownload` kann die Downloadoption ausblenden, `noplaybackrate` ist nicht standardisiert. Keines der beiden schützt die Mediendatei.
Version: Non-standard media-controls extension; browser support varies
Syntax
<video controls controlslist="nodownload noplaybackrate"></video>
<audio controls controlslist="nodownload noplaybackrate"></audio>
The HTML Living Standard defines `controls` and `HTMLMediaElement.playbackRate`, not the `controlslist` attribute or the `HTMLMediaElement.controlsList` property. Those are a browser extension with limited support.
JavaScript, where supported: media.controlsList (DOMTokenList); media.controlsList.add("nodownload"). The token noplaybackrate is non-standard.Bei video und audio fordert das boolesche Attribut controls durch seine Anwesenheit die integrierten Bedienelemente des Browsers an. controlslist schaltet sie nicht ein, sondern gibt durch Leerzeichen getrennte Tokens vor, die dem Browser bei der Auswahl der Bedienelemente helfen. Wo die Funktion implementiert ist, liefert die JavaScript-Eigenschaft media.controlsList eine DOMTokenList, die sich etwa mit media.controlsList.add("nodownload") ändern lässt.
nodownload bittet den Browser, seine Downloadoption auszublenden, sofern er eine anbietet. noplaybackrate soll die Auswahl der Wiedergabegeschwindigkeit ausblenden, wenn der Browser das Token erkennt. Es ist nicht standardisiert und fehlt in der Liste der unterstützten Tokens bei MDN. Der HTML Living Standard definiert controls und media.playbackRate, aber weder das Attribut controlslist noch die Eigenschaft media.controlsList. Diese Erweiterung wird von Browsern nur eingeschränkt unterstützt. Weder der ausgelesene Attributtext noch das Vorhandensein der Eigenschaft beweist, dass ein Menüpunkt ausgeblendet wurde. Prüfe die tatsächlichen Bedienelemente in den Zielbrowsern und sorge dafür, dass der Player auch ohne diesen Hinweis benutzbar bleibt.
Das Ausblenden der Geschwindigkeitsauswahl sperrt media.playbackRate nicht. Ebenso hindert das Ausblenden der Downloadoption den Browser nicht daran, die zur Wiedergabe nötigen Mediendaten abzurufen, und verhindert auch nicht, dass diese Daten gespeichert werden. controlslist ersetzt keine serverseitige Zugriffskontrolle und schützt die Datei nicht vor dem Kopieren.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Inspect media controls markup</title>
<video id="video" controls controlslist="nodownload noplaybackrate"></video>
<audio id="audio" controls controlslist="nodownload noplaybackrate"></audio>
<pre id="result"></pre>
<script>
const lines = ['video', 'audio'].map((id) => {
const media = document.getElementById(id);
return `${id}: controls=${media.controls}; controlslist=${media.getAttribute('controlslist')}`;
});
document.getElementById('result').textContent = lines.join('\n');
</script>
</html>Ergebnis
video: controls=true; controlslist=nodownload noplaybackrate audio: controls=true; controlslist=nodownload noplaybackrate
Die beiden Zeilen geben `controls` und den Attributtext aus. Das Beispiel enthält keine Medienquellen und prüft nicht, welche Optionen ausgeblendet werden.
Zugehörige Lektionen
- HTML · Lektion 11 · Fortgeschritten · Version: 2
Quellen
- HTML Standard — User interface (standard native controls, not the controlslist extension)
- HTML Standard — Playing the media resource (standard playback behavior, including playbackRate)
- HTMLMediaElement: controlsList property (browser extension)
- <video>: The Video Embed element — controlslist attribute
- <audio>: The Embed Audio element — controlslist attribute
- Element: getAttribute() method