Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

oninput — obsługa zdarzenia input

Atrybut oninput zawiera kod JavaScript uruchamiany przy zdarzeniu input. W polu tekstowym pozwala reagować na edycję wartości przez użytkownika bez czekania na opuszczenie pola.

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

Składnia

oninput="JavaScript statements"

oninput to atrybut obsługi zdarzenia input, dostępny na wszystkich elementach HTML. Jego wartością jest treść funkcji w JavaScript, a nie sama nazwa zdarzenia ani deklaracja funkcji. Dostępność atrybutu nie oznacza, że każdy element sam generuje takie zdarzenia.

W polu tekstowym input sygnalizuje edycję wartości przez użytkownika, na przykład wpisywanie, wklejanie lub usuwanie tekstu. W odróżnieniu od change nie czeka na zatwierdzenie edycji, którym dla pola tekstowego jest zwykle opuszczenie pola. Samo przypisanie do value w JavaScript nie wywołuje automatycznie input.

W kodzie atrybutu this oznacza element obsługujący zdarzenie, a event udostępnia obiekt zdarzenia. Istnieje też właściwość JavaScript element.oninput: przypisanie jej funkcji zastępuje dotychczasową funkcję tego handlera; przypisanie null go wyłącza.

Przykład kopiuje bieżące this.value do textContent elementu wyniku. Kod inline może być blokowany przez Content Security Policy (CSP); uruchomienie przykładu wymaga zezwolenia na takie handlery.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oninput example</title>
<label>Text: <input type="text" oninput="document.getElementById('result').textContent = this.value"></label>
<p>Value: <output id="result"></output></p>
</html>

Wynik

Value: abc

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

Źródła