Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

`value` e `disabled` negli elementi `input` e `textarea`

Leggi e modifica il valore di un controllo anche quando l’utente non può usarlo. Distingui l’attributo `disabled` dell’elemento dal suo stato effettivo e verifica quali valori entrano nei dati del modulo.

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

Sintassi

control.value          // read a string
control.value = text   // write a string; input.type determines the rules
control.disabled       // read the element's own disabled attribute as a boolean
control.disabled = true
control.disabled = false
control.matches(':disabled') // test whether the control is actually disabled

HTMLInputElement e HTMLTextAreaElement sono interfacce DOM definite dallo standard HTML, non da ECMAScript 2024. Nei campi di testo e in textarea, value legge e imposta la stringa corrente. Per textarea, value normalizza le interruzioni di riga in LF (\n). Il valore predefinito (defaultValue) deriva dall’attributo value di input o dal contenuto testuale di textarea. Dopo una modifica dell’utente o un’assegnazione a value, modificare il valore predefinito non sovrascrive più quello corrente. Quando si ripristina il modulo, il valore corrente viene impostato a partire da quello predefinito. Per input, il browser applica anche l’algoritmo di sanificazione del valore, se il tipo ne definisce uno. Ad esempio, per type="text", il ripristino rimuove da value le interruzioni di riga, anche se sono presenti in defaultValue.

Per input, type determina il comportamento di value. Nella modalità valore, come per text e number, il browser può trasformare o svuotare la stringa assegnata secondo le regole del tipo; anche number restituisce una stringa. Per hidden, value riflette l’attributo value e restituisce '' se manca. Per checkbox e radio riflette lo stesso attributo, ma se manca restituisce 'on'; usa checked per lo stato di selezione. Per file, value non rivela il percorso reale: usa files. Assegnare '' cancella la selezione; una stringa non vuota genera InvalidStateError.

La proprietà booleana disabled riflette soltanto l’attributo dell’elemento stesso: true lo aggiunge, false lo rimuove. In HTML anche disabled="false" disabilita il controllo, perché conta la presenza dell’attributo. Un controllo con disabled === false può comunque essere disabilitato da un fieldset antenato disabilitato, a meno che si trovi dentro il primo figlio legend di quel gruppo. Verifica lo stato effettivo con control.matches(':disabled').

Un controllo disabilitato non può ricevere il focus né essere modificato dall’utente. È escluso dalla validazione dei vincoli e viene omesso sia nell’invio del modulo sia in new FormData(form). Gli script possono comunque leggere e scrivere value; l’assegnazione da sola non genera né input né change. Dove è supportato, usa readOnly per mantenere il campo raggiungibile con il focus senza consentirne la modifica: da solo non lo esclude dall’invio. Nessuno dei due stati sostituisce la validazione o l’autorizzazione lato server.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Form control value and disabled state</title>
</head>
<body>
<script>
(() => {
  const form = document.createElement('form');
  const group = document.createElement('fieldset');
  const input = document.createElement('input');
  const textarea = document.createElement('textarea');
  input.type = 'text';
  input.name = 'title';
  textarea.name = 'note';
  group.append(input);
  form.append(group, textarea);

  group.disabled = true;
  input.value = 'Draft';
  textarea.value = 'Line 1\r\nLine 2';
  console.log(JSON.stringify([input.value, input.disabled, input.matches(':disabled')]));
  console.log(JSON.stringify([...new FormData(form)]));

  group.disabled = false;
  textarea.disabled = true;
  console.log(JSON.stringify([...new FormData(form)]));
})();
</script>
</body>
</html>

Risultato

["Draft",false,true]
[["note","Line 1\nLine 2"]]
[["title","Draft"]]

Salva l’esempio come file HTML, aprilo in un browser e controlla la console del browser. La prima riga mostra che si può assegnare `Draft` anche se il campo è effettivamente disabilitato e la sua proprietà `disabled` vale `false`. Le due righe successive mostrano i dati prima e dopo il cambio di stato; in JSON, `\n` rappresenta l’interruzione di riga LF.

Lezioni correlate

  • JavaScript · Lezione 4 · Avanzato · Versione: 4

Fonti