HTMLMediaElement: Eigenschaft `controlsList`

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die controlsList-Eigenschaft der HTMLMediaElement-Schnittstelle gibt ein DOMTokenList-Objekt zurück, das dem Benutzeragenten hilft, auszuwählen, welche Steuerelemente auf dem Medienelement angezeigt werden sollen, wann immer der Benutzeragent seine eigenen Steuerelemente zeigt. Die DOMTokenList nimmt einen oder mehrere der drei möglichen Werte an: nodownload, nofullscreen und noremoteplayback.

Wert

Eine DOMTokenList.

Der Wert von controlsList kann gesetzt werden, indem ein String übergeben wird, der die value-Eigenschaft der DOMTokenList repräsentiert.

Beispiele

Abrufen der controlsList-Eigenschaft

Die controlsList-Eigenschaft gibt ein DOMTokenList-Objekt zurück, das den aktuell gesetzten Wert enthält.

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

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

Setzen der controlsList-Eigenschaft

Sie können controlsList auch ändern, indem Sie es direkt auf einen String mit dem neuen Wert setzen.

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

Spezifikationen

Specification
Unknown specification
# solution-outline

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch