Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLInputElement.max e disabled: limite del valore e disattivazione del campo

`max` riflette il limite superiore come stringa, mentre `disabled` indica se il campo ha il proprio attributo di disattivazione. Superare il limite non disattiva il campo.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

input.max;                 // string: the max attribute, or "" if absent
input.max = "10";          // set the max attribute
input.removeAttribute("max");
input.disabled;            // boolean: whether the input's own disabled attribute is present
input.disabled = true;     // add the disabled attribute
input.disabled = false;    // remove the disabled attribute
input.matches(":disabled"); // test whether the input is effectively disabled

input.max è una proprietà di tipo stringa, modificabile, che riflette l’attributo HTML max. Restituisce il testo dell’attributo, o "" se è assente, non il limite calcolato. input.max = "10" imposta l’attributo e input.removeAttribute("max") lo rimuove.

max si applica ai tipi number, range, date, month, week, time e datetime-local, con un formato che dipende dal tipo. Non limita la lunghezza del testo. Se l’attributo manca o non è interpretabile, si usa il limite predefinito del tipo, se esiste: 100 per range, nessuno per number. In un campo number, un numero oltre il limite rimane in value e fa sì che validity.rangeOverflow === true. Un cursore range invece adatta il valore all’intervallo. Un intervallo time con min maggiore di max può attraversare la mezzanotte.

La proprietà booleana modificabile input.disabled riflette la presenza dell’attributo disabled sul campo stesso. true lo aggiunge e false lo rimuove. Anche disabled="false" disattiva il campo. Un fieldset disattivato disattiva anche i campi discendenti, tranne quelli contenuti nel suo primo figlio diretto legend. Perciò input.disabled può valere false anche se input.matches(":disabled") restituisce true.

L’utente non può portare il focus su un campo disattivato né modificarlo, ma JavaScript può ancora cambiarne il valore. Il campo è escluso dalla convalida dei vincoli (willValidate vale false) ed è omesso sia all’invio del modulo sia nella creazione di new FormData(form). Queste proprietà appartengono al DOM del browser, non a ECMAScript; un ambiente senza DOM non le fornisce. Convalida sempre i dati ricevuti sul server, a prescindere dalle impostazioni del campo.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Input max and disabled</title>
</head>
<body>
  <script>
    const form = document.createElement('form');
    const input = document.createElement('input');
    input.type = 'number';
    input.name = 'quantity';
    input.max = '10';
    input.value = '12';
    form.append(input);

    console.log(JSON.stringify([
      input.max, input.value, input.validity.rangeOverflow,
      input.checkValidity(), new FormData(form).has('quantity'),
    ]));

    input.disabled = true;
    console.log(JSON.stringify([
      input.disabled, input.value, input.willValidate,
      new FormData(form).has('quantity'),
    ]));
  </script>
</body>
</html>

Risultato

["10","12",true,false,true]
[true,"12",false,false]

Salva l’esempio come file `.html`, aprilo in un browser e controlla il risultato nella console del browser. `"12"` supera `"10"` e non supera la convalida, ma è comunque incluso in `FormData`. Dopo la disattivazione, il campo conserva il valore ma viene escluso dalla convalida e dai dati del modulo.

Lezioni correlate

  • JavaScript · Lezione 28 · Intermedio · Versione: 3

Fonti