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

CKTIS / HTML

onclose — zpracování události close

Atribut onclose obsahuje JavaScriptový kód, který zpracovává událost close. Obvykle se používá k reakci na zavření prvku dialog, například přečtením jeho returnValue. Neslouží k zabránění zavření.

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

Syntaxe

onclose="JavaScript statements"

onclose je globální atribut obsluhy události close. Jeho hodnotou je JavaScriptový kód, nikoli logická hodnota. Lze jej zapsat na libovolný prvek HTML, ale samotné přidání atributu nezpůsobí, že prvek tuto událost začne vysílat.

Typicky se používá u prvku dialog. Volání close() zavře otevřený dialog a zařadí událost close do fronty. V obslužné rutině atributu odkazuje this na prvek a event zpřístupňuje objekt události. Výsledek zavření lze přečíst pomocí this.returnValue.

Událost close prvku dialog se nešíří a nelze ji zrušit. Chcete-li zabránit požadavku na zavření, zpracujte zrušitelnou událost cancel; samotné close() tuto fázi přeskočí. Ruční odebrání atributu open událost close nevyvolá.

Nezaměňujte atribut s JavaScriptovou vlastností element.onclose, které se přiřazuje funkce, ani s addEventListener('close', handler), který umožňuje zaregistrovat více posluchačů. V příkladu obslužná rutina přečte výsledek done a aktualizuje text až po doručení události zařazené do fronty.

Příklady

<!doctype html>
<meta charset="utf-8">
<title>onclose</title>
<dialog id="demo" onclose="document.getElementById('result').textContent = 'closed: ' + this.returnValue">
  <p>Dialog</p>
</dialog>
<output id="result">waiting</output>
<script>
  const dialog = document.getElementById('demo');
  dialog.show();
  dialog.close('done');
</script>

Výsledek

closed: done

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