CKTIS / JavaScript
HTMLInputElement: tipo, stato e vincoli del campo
Scopri sei proprietà di HTMLInputElement per scegliere il tipo di campo, leggere lo stato di selezione, impostare vincoli e disabilitare un controllo. Distingui lo stato corrente dagli attributi iniziali e il messaggio di convalida dal risultato della convalida stessa.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
input.validationMessage; input.minLength = 3; input.type = "text"; input.checked = true; input.max = "10"; input.disabled = true;HTMLInputElement è l’interfaccia DOM del browser per i campi di input e non fa parte di ECMAScript. type è una stringa che seleziona il tipo di controllo, come text, number o checkbox; il tipo determina quali altri vincoli si applicano. Queste proprietà sono ampiamente disponibili nei browser moderni, ma il supporto dell’interfaccia per i singoli tipi di input può variare. Node 24 da solo non dimostra il supporto di questa API.
minLength è la rappresentazione numerica dell’attributo minlength: imposta la lunghezza minima del testo in unità di codice UTF-16, che non corrispondono necessariamente ai caratteri percepiti dall’utente. -1 significa che non è impostata una lunghezza minima. Si applica ai tipi testuali, senza required non impone un valore non vuoto, e la convalida di un testo troppo corto riguarda le modifiche dell’utente, non una semplice assegnazione tramite script. max è una stringa, ad esempio "10", che imposta il limite superiore per numeri, date o orari nei tipi pertinenti; a differenza di maxLength, non limita la lunghezza del testo. Con type="time", gli orari seguono un ciclo di 24 ore: se min indica un orario successivo a max, l’intervallo consentito va da min a max passando per la mezzanotte. Ad esempio, con min="22:00" e max="02:00", 23:00 rientra nell’intervallo anche se è un orario successivo a max.
checked è un valore booleano che descrive lo stato selezionato corrente di un campo checkbox o radio, non il suo value testuale. L’attributo checked specifica lo stato predefinito, riflesso da defaultChecked; modificare lo stato selezionato corrente non aggiorna quell’attributo. disabled riflette un attributo booleano: impostandolo a true si impedisce l’interazione, si esclude il controllo dai dati del modulo inviati e dalla convalida dei vincoli. Non equivale a readOnly.
validationMessage è una stringa di sola lettura che contiene un messaggio di errore localizzato oppure "" quando il controllo rispetta i vincoli o è escluso dalla convalida. Un messaggio vuoto, quindi, non dimostra che un controllo disabilitato abbia un valore valido. Imposta un messaggio personalizzato con setCustomValidity() e cancellalo con setCustomValidity(""). L’esempio verifica se il messaggio è vuoto invece di confrontare un testo dipendente dalla lingua e non tenta di dimostrare un errore minLength con un’assegnazione tramite script.
Identificatori di riferimento trattati in questa voce: HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.
Esempi
(() => {
const text = document.createElement("input");
text.type = "text";
text.minLength = 3;
console.log(text.type, text.minLength);
const box = document.createElement("input");
box.type = "checkbox";
box.checked = true;
console.log(box.checked, box.defaultChecked);
const number = document.createElement("input");
number.type = "number";
number.max = "10";
number.value = "11";
console.log(number.max, number.validity.rangeOverflow);
console.log(number.validationMessage !== "");
number.disabled = true;
console.log(number.disabled, number.willValidate);
console.log(number.validationMessage === "");
})();Risultato
text 3 true false 10 true true true false true
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
- HTMLInputElement - Web APIs | MDN
- HTMLInputElement: validationMessage property - Web APIs | MDN
- HTMLInputElement: minLength property - Web APIs | MDN
- HTMLInputElement: type property - Web APIs | MDN
- HTMLInputElement: checked property - Web APIs | MDN
- HTMLInputElement: max property - Web APIs | MDN
- HTMLInputElement: disabled property - Web APIs | MDN
- minlength HTML attribute - HTML | MDN