CKTIS / HTML
onended – zpracování konce přehrávání
Atribut onended obsahuje JavaScript, který se spustí při přijetí události ended. U prvků audio a video reaguje na dosažení konce média, nikoli na pouhé pozastavení přehrávání.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<audio onended="JavaScript statements"></audio>
<video onended="JavaScript statements"></video>onended je obsahový atribut obsluhy události ended. Jeho hodnota je tělo funkce v JavaScriptu, nikoli URL souboru ani pouhý název funkce. K prozkoumání události lze použít event.
U prvků audio a video prohlížeč vyvolá ended, když přehrávání vpřed dosáhne konce média. Samotné zavolání pause() neznamená, že přehrávání skončilo. Je-li nastaveno loop, při dosažení konce během přehrávání vpřed se přehrávání vrátí na začátek místo vyvolání této události.
Rozlišujte atribut HTML onended, vlastnost JavaScriptu media.onended, která obsahuje obslužnou funkci, a logickou stavovou vlastnost media.ended. Alternativou k atributu je media.addEventListener('ended', handler); název události nemá předponu on.
Příklad záměrně vyvolává syntetickou událost, takže nepotřebuje žádný mediální soubor. Ověřuje připojení obsluhy, nikoli skutečné dokončení přehrávání. Bezpečnostní zásady stránky mohou blokovat kód obsluhy události zapsaný přímo v atributu.
Příklady
<!doctype html>
<meta charset="utf-8">
<title>onended test</title>
<audio id="media" onended="document.getElementById('result').textContent = event.type"></audio>
<output id="result">waiting</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('ended'));
</script>Výsledek
ended
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.