CKTIS / HTML
onbeforematch — een gebeurtenis afhandelen voordat verborgen inhoud wordt getoond
Het globale attribuut onbeforematch bevat JavaScript voor het afhandelen van de gebeurtenis beforematch. Hiermee kan code reageren voordat de browser een element met hidden="until-found" toont bij zoeken op de pagina of navigatie naar een fragment.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onbeforematch="JavaScript statements"onbeforematch is een globaal attribuut voor het afhandelen van de gebeurtenis beforematch. De waarde bestaat uit JavaScript-instructies, niet uit een gebeurtenisnaam of een booleaanse waarde. De DOM-tegenhanger is element.onbeforematch; een alternatief is element.addEventListener('beforematch', handler).
Wanneer zoeken op de pagina of navigatie naar een fragment een element met hidden="until-found" moet tonen, activeert de browser eerst beforematch en verwijdert daarna hidden. De handler kan het attribuut dus lezen zolang het nog bestaat. De gebeurtenis bubbelt omhoog in de boom en kan niet worden geannuleerd: preventDefault() voorkomt het tonen niet.
onbeforematch verbergt zelf geen inhoud. Het gewone attribuut hidden biedt niet het mechanisme om inhoud te tonen dat beschikbaar is met hidden="until-found". hidden handmatig verwijderen is dat mechanisme ook niet en activeert zelf geen beforematch. Content Security Policy kan code in attributen voor gebeurtenisafhandeling blokkeren.
Klik in het voorbeeld op Reveal target in een browser die dit mechanisme ondersteunt. De verwachte statustekst is beforematch: hidden=until-found; daarna wordt de inhoud zichtbaar en is het attribuut hidden verdwenen. Laad de pagina opnieuw voordat je de test herhaalt, omdat het element al is getoond.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>beforematch example</title>
<a href="#target">Reveal target</a>
<p id="status">Waiting</p>
<section hidden="until-found"
onbeforematch="document.getElementById('status').textContent = 'beforematch: hidden=' + this.getAttribute('hidden')">
<p id="target">The hidden target.</p>
</section>
</html>Resultaat
beforematch: hidden=until-found
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.