CKTIS / HTML
`controlslist` v prvkoch video a audio
`controlslist` je odporúčanie pre vstavaný prehrávač prehliadača. `nodownload` môže skryť možnosť stiahnutia, kým `noplaybackrate` nie je štandardizovaný. Ani jeden nechráni mediálny súbor.
Verzia: Non-standard media-controls extension; browser support varies
Syntax
<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.V prvkoch video a audio prítomnosť boolovského atribútu controls žiada prehliadač o zobrazenie vstavaných ovládacích prvkov. controlslist ich nezapína: odovzdáva prehliadaču tokeny oddelené medzerami, ktoré mu pomáhajú vybrať, čo zobraziť. Ak je funkcia implementovaná, vlastnosť JavaScriptu media.controlsList vracia objekt DOMTokenList, ktorý možno upraviť napríklad pomocou media.controlsList.add("nodownload").
nodownload žiada prehliadač, aby skryl možnosť stiahnutia, ak ju ponúka. noplaybackrate má skryť výber rýchlosti prehrávania tam, kde prehliadač tento token rozpozná. Nie je štandardizovaný a MDN ho neuvádza medzi podporovanými tokenmi. HTML Living Standard definuje controls a media.playbackRate, ale nedefinuje atribút controlslist ani vlastnosť media.controlsList. Podpora tohto rozšírenia v prehliadačoch je obmedzená. Prečítanie textu atribútu ani zistenie prítomnosti vlastnosti nedokazuje, že sa položka ponuky skryla. Otestuj ovládacie prvky v cieľových prehliadačoch a zabezpeč, aby sa prehrávač dal používať, aj keď prehliadač odporúčanie ignoruje.
Skrytie výberu rýchlosti nezablokuje media.playbackRate. Podobne skrytie možnosti stiahnutia nebráni prehliadaču načítať údaje potrebné na prehrávanie ani nebráni ich uloženiu. controlslist nenahrádza riadenie prístupu na serveri a nechráni súbor pred kopírovaním.
Príklady
<!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>Výsledok
video: controls=true; controlslist=nodownload noplaybackrate audio: controls=true; controlslist=nodownload noplaybackrate
Dva riadky zobrazujú `controls` a text atribútu. Príklad neobsahuje zdroje médií a neoveruje, ktoré možnosti sa skryjú.
Súvisiace lekcie
- HTML · Lekcia 11 · Pokročilá · Verzia: 2
Zdroje
- 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