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.