Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onbeforematch — gestire un evento prima di mostrare contenuti nascosti

L’attributo globale onbeforematch contiene JavaScript per gestire l’evento beforematch. Consente al codice di reagire prima che il browser mostri un elemento con hidden="until-found" durante una ricerca nella pagina o una navigazione tramite frammento.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

onbeforematch="JavaScript statements"

onbeforematch è un attributo globale per la gestione dell’evento beforematch. Il suo valore è costituito da istruzioni JavaScript, non dal nome di un evento né da un valore booleano. Il corrispondente nel DOM è element.onbeforematch; in alternativa si può usare element.addEventListener('beforematch', handler).

Quando una ricerca nella pagina o una navigazione tramite frammento deve mostrare un elemento con hidden="until-found", il browser attiva prima beforematch e poi rimuove hidden. Il gestore può quindi leggere l’attributo mentre è ancora presente. L’evento risale l’albero e non è annullabile: preventDefault() non impedisce che il contenuto venga mostrato.

onbeforematch non nasconde i contenuti. Il normale attributo hidden non offre il meccanismo di visualizzazione disponibile con hidden="until-found". Anche rimuovere manualmente hidden non equivale a quel meccanismo e non attiva di per sé beforematch. La Content Security Policy può bloccare il codice negli attributi di gestione degli eventi.

Nell’esempio, fai clic su Reveal target in un browser che supporta questo meccanismo. Il testo di stato previsto è beforematch: hidden=until-found; in seguito, il contenuto diventa visibile e l’attributo hidden scompare. Ricarica la pagina prima di ripetere la prova, perché l’elemento è già stato mostrato.

Esempi

<!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>

Risultato

beforematch: hidden=until-found

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti