CKTIS / HTML
onbeforematch — tratar um evento antes de revelar conteúdo oculto
O atributo global onbeforematch contém JavaScript que trata o evento beforematch. Permite que o código reaja antes de o navegador revelar um elemento com hidden="until-found" durante uma pesquisa na página ou uma navegação por fragmento.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onbeforematch="JavaScript statements"onbeforematch é um atributo global de tratamento do evento beforematch. O seu valor é constituído por instruções JavaScript, não pelo nome de um evento nem por um valor booleano. O equivalente no DOM é element.onbeforematch; em alternativa, pode usar-se element.addEventListener('beforematch', handler).
Quando uma pesquisa na página ou uma navegação por fragmento precisa de revelar um elemento com hidden="until-found", o navegador dispara primeiro beforematch e, em seguida, remove hidden. Assim, o gestor pode ler o atributo enquanto este ainda existe. O evento propaga-se pela árvore e não é cancelável: preventDefault() não impede a revelação.
onbeforematch não oculta conteúdo por si só. O atributo hidden normal não fornece o mecanismo de revelação disponível com hidden="until-found". Remover hidden manualmente também não corresponde a esse mecanismo e não dispara, por si só, beforematch. A Content Security Policy pode bloquear código nos atributos de tratamento de eventos.
No exemplo, clique em Reveal target num navegador que suporte este mecanismo. O texto de estado esperado é beforematch: hidden=until-found; depois, o conteúdo fica visível e o atributo hidden desaparece. Volte a carregar a página antes de repetir, porque o elemento já foi revelado.
Exemplos
<!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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.