Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła