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 disabledHTMLInputElement 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
- HTML Living Standard — The input element
- HTML Living Standard — The textarea element
- HTML Living Standard — Enabling and disabling form controls: the disabled attribute
- HTML Living Standard — Constructing the entry list
- HTML Living Standard — Common event behaviors
- MDN — FormData: FormData() constructor
- MDN — disabled HTML attribute