Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

oninput — gestire l’evento input

L’attributo oninput contiene codice JavaScript eseguito quando si verifica l’evento input. In un campo di testo permette di reagire alle modifiche dell’utente senza aspettare che esca dal campo.

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

Sintassi

oninput="JavaScript statements"

oninput è un attributo di contenuto per la gestione dell’evento input, disponibile su tutti gli elementi HTML. Il suo valore è il corpo di una funzione JavaScript, non semplicemente il nome di un evento o una dichiarazione di funzione. La disponibilità dell’attributo non significa che ogni elemento generi autonomamente questi eventi.

In un campo di testo, input segnala le modifiche del valore apportate dall’utente, ad esempio digitando, incollando o eliminando testo. A differenza di change, non aspetta che la modifica venga confermata, cosa che per un campo di testo avviene di solito quando il campo perde il focus. Assegnare un valore a value in JavaScript non attiva automaticamente input.

Nel codice dell’attributo, this si riferisce all’elemento che gestisce l’evento, mentre event fornisce l’oggetto evento. Esiste anche la proprietà JavaScript element.oninput: assegnarle una funzione sostituisce quella già presente per il gestore; assegnarle null lo disattiva.

L’esempio copia il valore corrente di this.value in textContent dell’elemento del risultato. La Content Security Policy (CSP) può bloccare il codice inline; per eseguire l’esempio è necessario consentire i gestori di eventi inline.

Esempi

<!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>

Risultato

Value: abc

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti