Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onbeforeinput — obsługa zdarzenia przed edycją

onbeforeinput to atrybut obsługi zdarzenia beforeinput, związanego z edycją danych przez użytkownika. Pozwala uruchomić JavaScript przed zmianą i anulować domyślną operację, jeżeli zdarzenie można anulować.

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

Składnia

onbeforeinput="JavaScript statements"
element.onbeforeinput = function (event) { /* ... */ };

onbeforeinput jest atrybutem HTML zawierającym kod obsługi zdarzenia beforeinput. Jest dostępny na wszystkich elementach HTML; samo jego dodanie nie czyni elementu edytowalnym. Odpowiada mu właściwość JavaScript element.onbeforeinput.

W treści atrybutu event oznacza bieżące zdarzenie. Wywołanie event.preventDefault() pozwala zablokować domyślną operację tylko wtedy, gdy event.cancelable ma wartość true. Nie zakładaj, że każdą zmianę da się w ten sposób zatrzymać.

Wartość atrybutu to kod JavaScript, a nie nazwa zdarzenia. Przykład sprawdza obsługę i anulowanie sztucznie wysłanego beforeinput; nie symuluje rzeczywistego wpisywania tekstu. Niezmieniona wartość ABC nie jest więc dowodem zablokowania natywnej edycji.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>onbeforeinput</title>
<input id="editor" value="ABC" onbeforeinput="if (event.cancelable) event.preventDefault()">
<pre id="result"></pre>
<script>
  const editor = document.getElementById('editor');
  const event = new Event('beforeinput', { bubbles: true, cancelable: true });
  const allowed = editor.dispatchEvent(event);
  document.getElementById('result').textContent =
    `allowed=${allowed}\ndefaultPrevented=${event.defaultPrevented}\nvalue=${editor.value}`;
</script>

Wynik

allowed=false
defaultPrevented=true
value=ABC

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła