CKTIS / HTML
onbeforematch — obsługa zdarzenia przed ujawnieniem treści
Globalny atrybut onbeforematch zawiera kod JavaScript obsługujący zdarzenie beforematch. Pozwala zareagować, zanim przeglądarka ujawni element z hidden="until-found" podczas wyszukiwania na stronie lub nawigacji do fragmentu.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
onbeforematch="JavaScript statements"onbeforematch jest globalnym atrybutem obsługi zdarzenia beforematch. Jego wartość to instrukcje JavaScript, a nie nazwa zdarzenia ani wartość logiczna. Odpowiada mu właściwość DOM element.onbeforematch; alternatywą jest element.addEventListener('beforematch', handler).
Gdy wyszukiwanie na stronie lub nawigacja do fragmentu wymaga ujawnienia elementu z hidden="until-found", przeglądarka najpierw emituje beforematch, a następnie usuwa hidden. Procedura obsługi może więc odczytać jeszcze istniejący atrybut. Zdarzenie propaguje się w górę drzewa i nie jest anulowalne: preventDefault() nie blokuje ujawnienia.
Samo onbeforematch nie ukrywa treści. Zwykłe hidden nie zapewnia mechanizmu ujawniania dostępnego dla hidden="until-found". Ręczne usunięcie hidden również nie jest tym mechanizmem i samo nie wywołuje beforematch. Polityka Content Security Policy może blokować kod w atrybutach obsługi zdarzeń.
W przykładzie kliknij Reveal target w przeglądarce obsługującej ten mechanizm. Oczekiwany tekst statusu to beforematch: hidden=until-found; później treść staje się widoczna, a atrybut hidden znika. Przeładuj stronę przed powtórzeniem, ponieważ element został już ujawniony.
Przykłady
<!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>Wynik
beforematch: hidden=until-found
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.