CKTIS / HTML
`controlslist` при елементи за видео и аудио
`controlslist` е указание към вградения плейър на браузъра. `nodownload` може да скрие опцията за изтегляне, а `noplaybackrate` не е стандартизиран. Нито един от двата токена не защитава файла.
Версия: Non-standard media-controls extension; browser support varies
Синтаксис
<video controls controlslist="nodownload noplaybackrate"></video>
<audio controls controlslist="nodownload noplaybackrate"></audio>
The HTML Living Standard defines `controls` and `HTMLMediaElement.playbackRate`, not the `controlslist` attribute or the `HTMLMediaElement.controlsList` property. Those are a browser extension with limited support.
JavaScript, where supported: media.controlsList (DOMTokenList); media.controlsList.add("nodownload"). The token noplaybackrate is non-standard.При video и audio наличието на булевия атрибут controls указва на браузъра да покаже вградените си контроли. controlslist не ги включва: той подава токени, разделени с интервали, за да насочи браузъра кои контроли да покаже. Когато функцията е реализирана, свойството media.controlsList в JavaScript връща DOMTokenList, който може да се променя, например чрез media.controlsList.add("nodownload").
nodownload указва на браузъра да скрие опцията си за изтегляне, ако предлага такава. noplaybackrate е предназначен да скрива избора на скорост на възпроизвеждане, ако браузърът разпознава токена. Той не е стандартизиран и MDN не го посочва сред поддържаните токени. HTML Living Standard определя controls и media.playbackRate, но не и атрибута controlslist или свойството media.controlsList. Поддръжката на това разширение в браузърите е ограничена. Прочитането на текста на атрибута или откриването на свойството не доказва, че дадена опция е скрита. Провери действителните контроли в целевите браузъри и се погрижи плейърът да остане използваем, ако указанието бъде пренебрегнато.
Скриването на избора на скорост не заключва media.playbackRate. По същия начин скриването на опцията за изтегляне не пречи на браузъра да получи данните, нужни за възпроизвеждане, нито възпрепятства запазването им. controlslist не замества контрола на достъпа на сървъра и не защитава файла от копиране.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Inspect media controls markup</title>
<video id="video" controls controlslist="nodownload noplaybackrate"></video>
<audio id="audio" controls controlslist="nodownload noplaybackrate"></audio>
<pre id="result"></pre>
<script>
const lines = ['video', 'audio'].map((id) => {
const media = document.getElementById(id);
return `${id}: controls=${media.controls}; controlslist=${media.getAttribute('controlslist')}`;
});
document.getElementById('result').textContent = lines.join('\n');
</script>
</html>Резултат
video: controls=true; controlslist=nodownload noplaybackrate audio: controls=true; controlslist=nodownload noplaybackrate
Двата реда показват `controls` и текста на атрибута. Примерът няма медийни източници и не проверява кои опции са скрити.
Свързани уроци
- HTML · Урок 11 · Напреднало · Версия: 2
Източници
- HTML Standard — User interface (standard native controls, not the controlslist extension)
- HTML Standard — Playing the media resource (standard playback behavior, including playbackRate)
- HTMLMediaElement: controlsList property (browser extension)
- <video>: The Video Embed element — controlslist attribute
- <audio>: The Embed Audio element — controlslist attribute
- Element: getAttribute() method