Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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