Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

`controlslist` u prvků video a audio

`controlslist` je doporučení pro vestavěný přehrávač prohlížeče. `nodownload` může skrýt volbu stažení, zatímco `noplaybackrate` není standardizovaný. Ani jeden nechrání mediální soubor.

Verze: Non-standard media-controls extension; browser support varies

Syntaxe

<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.

U prvků video a audio přítomnost booleovského atributu controls žádá prohlížeč o zobrazení vestavěných ovládacích prvků. controlslist je nezapíná: předává prohlížeči tokeny oddělené mezerami, které mu pomáhají vybrat, co zobrazit. Pokud je funkce implementována, vlastnost JavaScriptu media.controlsList vrací objekt DOMTokenList, který lze upravit například pomocí media.controlsList.add("nodownload").

nodownload žádá prohlížeč, aby skryl volbu stažení, pokud ji nabízí. noplaybackrate má skrýt volbu rychlosti přehrávání tam, kde prohlížeč tento token rozpozná. Není standardizovaný a MDN ho neuvádí mezi podporovanými tokeny. HTML Living Standard definuje controls a media.playbackRate, ale nedefinuje atribut controlslist ani vlastnost media.controlsList. Podpora tohoto rozšíření v prohlížečích je omezená. Přečtení textu atributu ani zjištění existence vlastnosti nedokazuje, že se položka nabídky skryla. Ověř ovládací prvky v cílových prohlížečích a zajisti, aby se přehrávač dal používat, i když prohlížeč doporučení ignoruje.

Skrytí volby rychlosti nezamkne media.playbackRate. Podobně skrytí volby stažení nebrání prohlížeči načíst data potřebná k přehrávání ani nebrání jejich uložení. controlslist nenahrazuje řízení přístupu na serveru a nechrání soubor před kopírováním.

Pří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ýsledek

video: controls=true; controlslist=nodownload noplaybackrate
audio: controls=true; controlslist=nodownload noplaybackrate

Dva řádky zobrazují `controls` a text atributu. Příklad neobsahuje zdroje médií a neověřuje, které volby se skryjí.

Související lekce

  • HTML · Lekce 11 · Pokročilá · Verze: 2

Zdroje