Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLMediaElement : propriété controlsList

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

La propriété controlsList de l'interface HTMLMediaElement retourne un objet DOMTokenList qui aide l'agent utilisateur à sélectionner les contrôles à afficher sur l'élément multimédia chaque fois que cet agent affiche son propre ensemble de contrôles. L'objet DOMTokenList prend une ou plusieurs des trois valeurs possibles suivantes : nodownload, nofullscreen et noremoteplayback.

Valeur

Un objet DOMTokenList.

La valeur de controlsList peut être définie en passant une chaîne de caractères représentant la propriété value de DOMTokenList.

Exemples

Récupérer la propriété controlsList

La propriété controlsList retourne un objet DOMTokenList contenant la valeur actuelle.

js
const video = document.createElement("video");
console.log(video.controlsList.value); // ""

video.controlsList.add("noremoteplayback");
console.log(video.controlsList.value); // "noremoteplayback"

Définir la propriété controlsList

Vous pouvez également modifier controlsList en le définissant directement sur une chaîne de caractères contenant la nouvelle valeur.

js
const audio = document.createElement("audio");
audio.controlsList = "nodownload";

Spécifications

Spécification
Unknown specification
# solution-outline

Compatibilité des navigateurs

Voir aussi