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

CKTIS / HTML

onreset — zpracování resetování formuláře

Atribut onreset obsahuje JavaScript pro zpracování události reset formuláře. Obsluha se spustí před obnovením výchozích hodnot a může resetování zrušit.

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

Syntaxe

onreset="JavaScript code"

onreset je atribut HTML pro obsluhu události reset. Jeho hodnota je kód JavaScriptu, nikoli název události nebo logická hodnota. Obvykle se umisťuje na formulář; událost probublává, takže ji může obsloužit také nadřazený prvek.

Resetování pomocí tlačítka type="reset" nebo volání form.reset() nejprve odešle formuláři zrušitelnou událost reset. Teprve potom se ovládací prvky vrátí do výchozího stavu — ten nemusí znamenat prázdné hodnoty. Během obsluhy lze stále číst hodnoty z doby před resetováním.

V kódu atributu odkazuje event na událost a this na obsluhující prvek. event.preventDefault() nebo return false resetování zruší. Samotné return false nezastaví šíření události.

Atribut onreset a vlastnost JavaScriptu form.onreset nastavují stejnou jedinou obsluhu. Alternativně form.addEventListener('reset', handler) umožňuje nezávisle registrovat více obsluh. Zásady CSP mohou kód atributu blokovat; příklad vyžaduje povolení jeho spuštění.

Příklady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onreset example</title>
<form id="demo" onreset="document.getElementById('log').textContent += 'during reset: ' + this.elements.namedItem('nickname').value + '\n';">
  <label>Nickname <input name="nickname" value="Ada"></label>
  <button type="reset">Reset</button>
</form>
<pre id="log"></pre>
<script>
  const form = document.getElementById('demo');
  const field = form.elements.namedItem('nickname');
  field.value = 'Grace';
  form.reset();
  document.getElementById('log').textContent += 'after reset: ' + field.value;
</script>
</html>

Výsledek

during reset: Grace
after reset: Ada

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