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.