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

CKTIS / HTML

ondurationchange — zpracování změn délky médií

Atribut ondurationchange obsahuje JavaScript, který se spustí při události durationchange. Obvykle slouží k aktualizaci informací o délce v prvcích audio a video; neoznamuje průběh přehrávání.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

ondurationchange="JavaScript statements"

ondurationchange je obsahový atribut obsluhy události durationchange, který se obvykle používá s prvky audio a video. Jeho hodnotou je kód JavaScriptu, nikoli logická hodnota ani hodnota délky. V obsluze uvedené v atributu odkazuje this na prvek a event zpřístupňuje objekt události.

Prohlížeč tuto událost vyvolá, když se změní zjištěná délka zdroje, například když se délka stane známou nebo je upravena. Přečtěte this.duration: výsledek je v sekundách, NaN znamená, že nejsou dostupná žádná data, a Infinity označuje neomezenou délku. Nejde o událost průběhu přehrávání; k tomu použijte timeupdate.

V JavaScriptu můžete místo toho přiřadit funkci k media.ondurationchange nebo použít media.addEventListener('durationchange', handler). Název události nemá předponu on. Přiřazení vlastnosti nahradí dosavadní obsluhu v daném slotu; addEventListener umožňuje přidávat nezávislé posluchače. Zásady CSP mohou blokovat kód zapsaný přímo v atributu.

Příklad vyvolá syntetickou událost, aniž by načítal média. Ověřuje propojení atributu s obsluhou, nikoli rozpoznání skutečné změny délky. Hodnotu duration nemění, takže očekávaný text je durationchange: NaN.

Příklady

<!doctype html>
<meta charset="utf-8">
<title>ondurationchange</title>
<audio id="media" ondurationchange="document.getElementById('result').textContent = event.type + ': ' + String(this.duration)"></audio>
<output id="result"></output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('durationchange'));
</script>

Výsledek

durationchange: NaN

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje