Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

`controlslist` sur les éléments vidéo et audio

`controlslist` fournit une indication au lecteur intégré du navigateur. `nodownload` peut masquer l’option de téléchargement, tandis que `noplaybackrate` n’est pas standardisé. Aucun des deux ne protège le fichier.

Version : Non-standard media-controls extension; browser support varies

Syntaxe

<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.

Sur video et audio, la présence de l’attribut booléen controls demande au navigateur d’afficher ses commandes intégrées. controlslist ne les active pas : il fournit des jetons séparés par des espaces pour aider le navigateur à choisir les commandes à afficher. Lorsque cette fonctionnalité est implémentée, la propriété JavaScript media.controlsList renvoie une DOMTokenList modifiable, par exemple avec media.controlsList.add("nodownload").

nodownload demande au navigateur de masquer son option de téléchargement s’il en propose une. noplaybackrate vise à masquer le sélecteur de vitesse lorsque le navigateur reconnaît ce jeton. Celui-ci n’est pas standardisé et ne figure pas parmi les jetons pris en charge répertoriés par MDN. Le HTML Living Standard définit controls et media.playbackRate, mais ni l’attribut controlslist ni la propriété media.controlsList. La prise en charge de cette extension par les navigateurs est limitée. Lire le texte de l’attribut ou détecter la propriété ne prouve pas qu’une option a été masquée. Vérifiez les commandes dans les navigateurs ciblés et veillez à ce que le lecteur reste utilisable si l’indication est ignorée.

Masquer le sélecteur de vitesse ne verrouille pas media.playbackRate. De même, masquer l’option de téléchargement n’empêche ni le navigateur de récupérer les données nécessaires à la lecture ni l’enregistrement de ces données. controlslist ne remplace pas le contrôle d’accès côté serveur et ne protège pas le fichier contre la copie.

Exemples

<!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>

Résultat

video: controls=true; controlslist=nodownload noplaybackrate
audio: controls=true; controlslist=nodownload noplaybackrate

Les deux lignes affichent `controls` et le texte de l’attribut. L’exemple n’a pas de source multimédia et ne vérifie pas quelles options sont masquées.

Leçons associées

  • HTML · Leçon 11 · Avancé · Version : 2

Sources