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

浏览器兼容性

另见