CKTIS / HTML
ondurationchange — wijzigingen in de mediaduur afhandelen
Het attribuut ondurationchange bevat JavaScript dat wordt uitgevoerd bij de gebeurtenis durationchange. Het wordt meestal gebruikt om duurinformatie van audio- en video-elementen bij te werken; het meldt geen voortgang van de huidige weergave.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
ondurationchange="JavaScript statements"ondurationchange is een eventhandler-contentattribuut voor durationchange, dat meestal wordt gebruikt met audio- en video-elementen. De waarde is JavaScript-code, geen Boolean en geen duurwaarde. In de handler die in het attribuut staat, verwijst this naar het element en geeft event het eventobject.
De browser activeert deze gebeurtenis wanneer de vastgestelde duur van de resource verandert, bijvoorbeeld wanneer die bekend wordt of wordt aangepast. Lees this.duration uit: het resultaat is in seconden, NaN betekent dat er geen gegevens beschikbaar zijn en Infinity geeft een onbeperkte duur aan. Dit is geen gebeurtenis voor afspeelvoortgang; gebruik daarvoor timeupdate.
In JavaScript kun je in plaats daarvan een functie toewijzen aan media.ondurationchange of media.addEventListener('durationchange', handler) gebruiken. De eventnaam heeft geen on-prefix. Een toewijzing aan de eigenschap vervangt de bestaande handler op die plek; met addEventListener kun je onafhankelijke listeners toevoegen. Een CSP-beleid kan code blokkeren die rechtstreeks in het attribuut staat.
Het voorbeeld verstuurt een synthetische gebeurtenis zonder media op te halen. Het controleert de koppeling tussen attribuut en handler, niet het detecteren van een daadwerkelijke wijziging van de duur. Het wijzigt duration niet, dus de verwachte tekst is durationchange: NaN.
Voorbeelden
<!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>Resultaat
durationchange: NaN
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.