Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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