CKTIS / HTML
onbeforematch — gestionar un evento antes de mostrar contenido oculto
El atributo global onbeforematch contiene JavaScript que gestiona el evento beforematch. Permite que el código reaccione antes de que el navegador muestre un elemento con hidden="until-found" durante una búsqueda en la página o una navegación por fragmento.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
onbeforematch="JavaScript statements"onbeforematch es un atributo global de gestión del evento beforematch. Su valor son instrucciones JavaScript, no el nombre de un evento ni un valor booleano. Su equivalente en el DOM es element.onbeforematch; otra opción es element.addEventListener('beforematch', handler).
Cuando una búsqueda en la página o una navegación por fragmento necesita mostrar un elemento con hidden="until-found", el navegador primero dispara beforematch y después elimina hidden. Por tanto, el gestor puede leer el atributo mientras todavía existe. El evento se propaga hacia arriba por el árbol y no se puede cancelar: preventDefault() no impide que se muestre el contenido.
onbeforematch no oculta contenido por sí mismo. El atributo hidden normal no ofrece el mecanismo para mostrar contenido que está disponible con hidden="until-found". Eliminar hidden manualmente tampoco es ese mecanismo y no dispara beforematch por sí solo. La política de seguridad de contenido (Content Security Policy) puede bloquear el código de los atributos de gestión de eventos.
En el ejemplo, haz clic en Reveal target en un navegador que admita este mecanismo. El texto de estado esperado es beforematch: hidden=until-found; después, el contenido se vuelve visible y el atributo hidden desaparece. Recarga la página antes de repetir la prueba, porque el elemento ya se ha mostrado.
Ejemplos
<!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>Resultado
beforematch: hidden=until-found
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.