CKTIS / HTML
`controlslist` negli elementi video e audio
`controlslist` fornisce un’indicazione al lettore integrato del browser. `nodownload` può nascondere l’opzione di download; `noplaybackrate` non è standard. Nessuno dei due protegge il file.
Versione: Non-standard media-controls extension; browser support varies
Sintassi
<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.Su video e audio, la presenza dell’attributo booleano controls richiede i comandi integrati del browser. controlslist non li attiva: fornisce token separati da spazi per orientare il browser nella scelta dei comandi da mostrare. Dove la funzionalità è implementata, la proprietà JavaScript media.controlsList restituisce una DOMTokenList modificabile, per esempio con media.controlsList.add("nodownload").
nodownload chiede al browser di nascondere l’opzione di download, se disponibile. noplaybackrate serve a nascondere il selettore della velocità quando il browser riconosce il token. Non è standard e MDN non lo elenca tra i token supportati. L’HTML Living Standard definisce controls e media.playbackRate, ma non l’attributo controlslist né la proprietà media.controlsList. Il supporto di questa estensione nei browser è limitato. Leggere il testo dell’attributo o rilevare la presenza della proprietà non dimostra che una voce del menu sia stata nascosta. Controlla l’interfaccia nei browser di destinazione e assicurati che il lettore resti utilizzabile se l’indicazione viene ignorata.
Nascondere il selettore della velocità non blocca media.playbackRate. Allo stesso modo, nascondere l’opzione di download non impedisce al browser di recuperare i dati necessari per la riproduzione né impedisce che quei dati vengano salvati. controlslist non sostituisce il controllo degli accessi lato server e non protegge il file dalla copia.
Esempi
<!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>Risultato
video: controls=true; controlslist=nodownload noplaybackrate audio: controls=true; controlslist=nodownload noplaybackrate
Le due righe mostrano `controls` e il testo dell’attributo. L’esempio non include sorgenti multimediali e non verifica quali opzioni vengano nascoste.
Lezioni correlate
- HTML · Lezione 11 · Avanzato · Versione: 2
Fonti
- 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