Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes