CKTIS / HTML
onbeforematch — gérer un événement avant l’affichage d’un contenu masqué
L’attribut global onbeforematch contient du JavaScript qui gère l’événement beforematch. Il permet au code de réagir avant que le navigateur n’affiche un élément doté de hidden="until-found" lors d’une recherche dans la page ou d’une navigation par fragment.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onbeforematch="JavaScript statements"onbeforematch est un attribut global de gestion de l’événement beforematch. Sa valeur est constituée d’instructions JavaScript, et non d’un nom d’événement ou d’une valeur booléenne. Son équivalent dans le DOM est element.onbeforematch ; une autre possibilité est element.addEventListener('beforematch', handler).
Lorsqu’une recherche dans la page ou une navigation par fragment doit afficher un élément doté de hidden="until-found", le navigateur déclenche d’abord beforematch, puis supprime hidden. Le gestionnaire peut donc lire l’attribut tant qu’il existe encore. L’événement remonte dans l’arbre et n’est pas annulable : preventDefault() n’empêche pas l’affichage.
onbeforematch ne masque pas lui-même le contenu. L’attribut hidden ordinaire ne fournit pas le mécanisme d’affichage disponible avec hidden="until-found". Supprimer manuellement hidden ne constitue pas non plus ce mécanisme et ne déclenche pas beforematch. La politique de sécurité du contenu (Content Security Policy) peut bloquer le code contenu dans les attributs de gestion d’événements.
Dans l’exemple, cliquez sur Reveal target dans un navigateur prenant en charge ce mécanisme. Le texte d’état attendu est beforematch: hidden=until-found ; ensuite, le contenu devient visible et l’attribut hidden disparaît. Rechargez la page avant de recommencer, car l’élément a déjà été affiché.
Exemples
<!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>Résultat
beforematch: hidden=until-found
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.