CKTIS / HTML
`controlslist` w elementach wideo i audio
Atrybut `controlslist` to wskazówka dla wbudowanego odtwarzacza przeglądarki. `nodownload` może ukryć opcję pobierania, a `noplaybackrate` jest niestandardowy. Żaden z nich nie chroni pliku.
Wersja: Non-standard media-controls extension; browser support varies
Składnia
<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.Na elementach video i audio obecność logicznego atrybutu controls oznacza prośbę o wbudowane kontrolki. controlslist nie włącza ich samodzielnie: przekazuje listę tokenów oddzielonych spacjami, która pomaga przeglądarce wybrać, co pokazać. W przeglądarkach z obsługą tej funkcji właściwość JavaScript media.controlsList zwraca DOMTokenList, którą można modyfikować, np. przez media.controlsList.add("nodownload").
nodownload prosi o ukrycie opcji pobierania we wbudowanym interfejsie, jeśli taka opcja istnieje. noplaybackrate ma ukrywać opcję zmiany prędkości tam, gdzie przeglądarka go rozpoznaje. Jest niestandardowy i MDN nie wymienia go wśród obsługiwanych tokenów. HTML Living Standard definiuje controls i media.playbackRate, ale nie atrybut controlslist ani właściwość media.controlsList. To rozszerzenie ma ograniczoną obsługę w przeglądarkach. Odczyt tekstu atrybutu lub obecność właściwości nie dowodzą, że dana opcja zniknęła. Sprawdź interfejs w docelowych przeglądarkach i zadbaj, by odtwarzacz był użyteczny również wtedy, gdy wskazówka zostanie zignorowana.
Ukrycie opcji zmiany prędkości nie blokuje właściwości media.playbackRate. Podobnie ukrycie opcji pobierania nie powstrzymuje przeglądarki przed pobraniem danych potrzebnych do odtwarzania ani nie uniemożliwia ich zapisania. controlslist nie zastępuje kontroli dostępu po stronie serwera i nie chroni pliku przed kopiowaniem.
Przykłady
<!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>Wynik
video: controls=true; controlslist=nodownload noplaybackrate audio: controls=true; controlslist=nodownload noplaybackrate
Dwa wiersze pokazują wartość `controls` i tekst atrybutu. Przykład nie ma źródeł multimediów i nie sprawdza, które opcje zostały ukryte.
Powiązane lekcje
- HTML · Lekcja 11 · Zaawansowany · Wersja: 2
Źródła
- 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