controlslist
controlsList は HTMLMediaElement インターフェイスのプロパティで、ユーザーエージェントが自分自身で一連のコントロールを表示するときに、メディア要素上に表示するコントロールを選択することを支援する DOMTokenList を返します。 DOMTokenList は、3 つの使用可能な値 nodownload, nofullscreen, noremoteplayback のうちの 1 つ以上を取ります。
対応ブラウザ
| 機能 | デスクトップ | モバイル | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 58 | 79 | | | 58 | | |
| HTML 属性 | ||||||
controlslist | 58 | 79 | | | 58 | |
controlslist | 58 | 79 | | | 58 | |
基本構文
HTML
<video controls controlslist="nodownload nofullscreen noremoteplayback"
src="video.mp4">
</video> ライブデモ
Hide download control
Use controlslist tokens to hint which built-in controls should be suppressed.
プレビュー全画面表示
Multiple control hints
Combine tokens such as nodownload, noplaybackrate, and nofullscreen.
プレビュー全画面表示
Player policy card
Document why a product might limit built-in controls for a focused viewing flow.
プレビュー全画面表示
実務での使いどころ
-
controlslist の活用
controlsList は HTMLMediaElement インターフェイスのプロパティで、ユーザーエージェントが自分自身で一連のコントロールを表示するときに、メディア要素上に表示するコントロールを選択することを支援する DOMTokenList を返します。
注意点
- 一部のブラウザでのみ対応。使用前にブラウザサポートを確認すること。
アクセシビリティ
- スクリーンリーダーでの読み上げを確認すること。