Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

onbeforematch — zpracování události před zobrazením skrytého obsahu

Globální atribut onbeforematch obsahuje JavaScript pro zpracování události beforematch. Umožňuje kódu reagovat dříve, než prohlížeč zobrazí prvek s hidden="until-found" při hledání na stránce nebo navigaci na fragment.

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

Syntaxe

onbeforematch="JavaScript statements"

onbeforematch je globální atribut obsluhy události beforematch. Jeho hodnotou jsou příkazy JavaScriptu, nikoli název události nebo logická hodnota. Odpovídá mu vlastnost DOM element.onbeforematch; alternativou je element.addEventListener('beforematch', handler).

Když je při hledání na stránce nebo navigaci na fragment potřeba zobrazit prvek s hidden="until-found", prohlížeč nejprve vyvolá beforematch a potom odstraní hidden. Obsluha proto může atribut přečíst, dokud ještě existuje. Událost probublává stromem a nelze ji zrušit: preventDefault() zobrazení nezabrání.

onbeforematch samo obsah neskrývá. Běžný atribut hidden neposkytuje mechanismus zobrazení, který je k dispozici pro hidden="until-found". Ani ruční odstranění hidden není tímto mechanismem a samo o sobě událost beforematch nevyvolá. Content Security Policy může blokovat kód v atributech obsluhy událostí.

V příkladu klikněte na Reveal target v prohlížeči, který tento mechanismus podporuje. Očekávaný stavový text je beforematch: hidden=until-found; poté se obsah zobrazí a atribut hidden zmizí. Před opakováním stránku znovu načtěte, protože prvek už byl zobrazen.

Příklady

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

Výsledek

beforematch: hidden=until-found

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje