WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onbeforematch — Ereignis vor dem Einblenden verborgener Inhalte behandeln

Das globale Attribut onbeforematch enthält JavaScript zur Behandlung des beforematch-Ereignisses. Damit kann Code reagieren, bevor der Browser ein Element mit hidden="until-found" bei einer Seitensuche oder Fragmentnavigation einblendet.

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

Syntax

onbeforematch="JavaScript statements"

onbeforematch ist ein globales Ereignisbehandlungsattribut für beforematch. Sein Wert besteht aus JavaScript-Anweisungen, nicht aus einem Ereignisnamen oder einem booleschen Wert. Das entsprechende DOM-Gegenstück ist element.onbeforematch; alternativ kann element.addEventListener('beforematch', handler) verwendet werden.

Wenn eine Seitensuche oder Fragmentnavigation ein Element mit hidden="until-found" einblenden muss, löst der Browser zuerst beforematch aus und entfernt anschließend hidden. Der Handler kann das Attribut also noch lesen, solange es vorhanden ist. Das Ereignis steigt im DOM-Baum auf und ist nicht abbrechbar: preventDefault() verhindert das Einblenden nicht.

onbeforematch blendet Inhalte nicht selbst aus. Das gewöhnliche hidden bietet nicht den Einblendmechanismus, der für hidden="until-found" verfügbar ist. Auch das manuelle Entfernen von hidden ist nicht dieser Mechanismus und löst selbst kein beforematch aus. Eine Content Security Policy kann Code in Ereignisbehandlungsattributen blockieren.

Klicke im Beispiel in einem Browser, der diesen Mechanismus unterstützt, auf Reveal target. Der erwartete Statustext lautet beforematch: hidden=until-found; danach wird der Inhalt sichtbar und das Attribut hidden ist nicht mehr vorhanden. Lade die Seite vor einem erneuten Test neu, da das Element bereits eingeblendet wurde.

Beispiele

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

Ergebnis

beforematch: hidden=until-found

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen