CKTIS / HTML
`controlslist` op video- en audio-elementen
`controlslist` is een aanwijzing voor de ingebouwde speler van de browser. `nodownload` kan de downloadoptie verbergen; `noplaybackrate` is niet gestandaardiseerd. Geen van beide beschermt het mediabestand.
Versie: 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.Bij video en audio vraagt de aanwezigheid van het booleaanse attribuut controls om de ingebouwde bediening van de browser. controlslist schakelt die bediening niet in, maar geeft met spaties gescheiden tokens mee die de browser helpen kiezen welke opties hij toont. Waar de functie is geïmplementeerd, geeft de JavaScript-eigenschap media.controlsList een DOMTokenList terug die je kunt aanpassen, bijvoorbeeld met media.controlsList.add("nodownload").
nodownload vraagt de browser zijn downloadoptie te verbergen als die er is. noplaybackrate is bedoeld om de snelheidskeuze te verbergen als de browser dit token herkent. Het is niet gestandaardiseerd en staat niet tussen de door MDN vermelde ondersteunde tokens. De HTML Living Standard definieert controls en media.playbackRate, maar niet het attribuut controlslist of de eigenschap media.controlsList. Browsers ondersteunen deze uitbreiding slechts beperkt. De attribuuttekst uitlezen of de eigenschap aantreffen bewijst niet dat een menuoptie is verborgen. Test de bediening in de beoogde browsers en zorg dat de speler bruikbaar blijft als de aanwijzing wordt genegeerd.
De snelheidskeuze verbergen zet media.playbackRate niet vast. Ook verhindert het verbergen van de downloadoptie niet dat de browser de voor het afspelen benodigde mediagegevens ophaalt of dat die gegevens worden opgeslagen. controlslist vervangt geen toegangscontrole op de server en beschermt het bestand niet tegen kopiëren.
Voorbeelden
<!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>Resultaat
video: controls=true; controlslist=nodownload noplaybackrate audio: controls=true; controlslist=nodownload noplaybackrate
De twee regels tonen `controls` en de attribuuttekst. Het voorbeeld bevat geen mediabronnen en controleert niet welke opties worden verborgen.
Gerelateerde lessen
- HTML · Les 11 · Gevorderd · Versie: 2
Bronnen
- 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