HTMLMediaElement: controlsList 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

HTMLMediaElement 介面的 controlsList 屬性會返回一個 DOMTokenList,用於幫助使用者代理在使用者代理顯示媒體元素的自身控制元件時,選擇要顯示的控制元件。DOMTokenList 可以包含以下三個值中的一個或多個:nodownloadnofullscreennoremoteplayback

一個 DOMTokenList

可以透過傳遞一個表示 DOMTokenListvalue 屬性的字串來設定 controlsList 的值。

示例

獲取 controlsList 屬性

controlsList 屬性返回一個包含當前設定值的 DOMTokenList 物件。

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

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

設定 controlsList 屬性

您也可以透過直接將其設定為包含新值的字串來修改 controlsList

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

規範

規範
未知規範
# solution-outline

瀏覽器相容性

另見