HTMLMediaElement: controlsList property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The controlsList property of the
HTMLMediaElement interface returns a DOMTokenList that helps the user
agent select what controls to show on the media element whenever the user agent shows
its own set of controls. The DOMTokenList takes one or more of three possible values:
nodownload, nofullscreen, and noremoteplayback.
Value
A DOMTokenList.
The value of controlsList can be set by passing a string representing the DOMTokenList's value property.
Examples
Getting the controlsList property
The controlsList property returns a DOMTokenList object containing the current set value.
const video = document.createElement("video");
console.log(video.controlsList.value); // ""
video.controlsList.add("noremoteplayback");
console.log(video.controlsList.value); // "noremoteplayback"
Setting the controlsList property
You can also modify controlsList by directly setting it to a string containing the new value.
const audio = document.createElement("audio");
audio.controlsList = "nodownload";
Specifications
| Specification |
|---|
| Unknown specification # solution-outline |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
controlsList
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support