CKTIS / JavaScript
`value` et `disabled` sur les éléments `input` et `textarea`
Lisez et modifiez la valeur d’un champ indépendamment de son état. Distinguez son propre attribut `disabled` de sa désactivation effective pour comprendre quelles valeurs sont incluses dans les données du formulaire.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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 et HTMLTextAreaElement sont des interfaces du DOM définies par le standard HTML, et non par ECMAScript 2024. Dans un champ de saisie textuelle ou un textarea, value lit et modifie la chaîne courante. Pour textarea, value normalise les fins de ligne en LF (\n). La valeur par défaut (defaultValue) vient de l’attribut value de input ou du contenu textuel de textarea. Après une modification par l’utilisateur ou une affectation à value, changer la valeur par défaut n’écrase plus la valeur courante. La réinitialisation du formulaire rétablit la valeur courante à partir de la valeur par défaut. Pour input, le navigateur applique aussi l’algorithme d’assainissement de la valeur si le type en définit un. Par exemple, pour type="text", la réinitialisation supprime les sauts de ligne de value, même s’ils figurent dans defaultValue.
Pour input, le comportement de value dépend de type. En mode valeur, notamment pour text et number, le navigateur peut transformer ou vider la chaîne affectée selon les règles du type. Même pour number, value renvoie une chaîne. Pour hidden, elle reflète l’attribut value et renvoie '' s’il est absent. Pour checkbox et radio, elle le reflète aussi, mais renvoie 'on' en son absence ; utilisez checked pour connaître l’état de sélection. Pour file, value ne révèle pas le chemin réel : utilisez files. L’affectation de '' efface la sélection ; une chaîne non vide déclenche InvalidStateError.
La propriété booléenne disabled ne reflète que l’attribut propre à l’élément : true l’ajoute, false le retire. En HTML, même disabled="false" désactive le champ, car seule la présence de l’attribut compte. Un champ avec disabled === false peut tout de même être désactivé par un fieldset ancêtre désactivé, sauf s’il se trouve dans le premier enfant legend de ce groupe. Testez l’état effectif avec control.matches(':disabled').
Un champ désactivé ne peut ni recevoir le focus ni être modifié par l’utilisateur. Il est exclu de la validation des contraintes et omis à l’envoi du formulaire ainsi que dans new FormData(form). Un script peut toujours lire et modifier value ; l’affectation seule ne déclenche ni input ni change. Si le champ le permet, utilisez readOnly pour conserver le focus sans permettre la modification ; cette propriété ne l’exclut pas à elle seule de l’envoi. Aucun de ces états ne remplace la validation ni l’autorisation côté serveur.
Exemples
<!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>Résultat
["Draft",false,true] [["note","Line 1\nLine 2"]] [["title","Draft"]]
Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console du navigateur. La première ligne montre que l’on peut affecter `Draft` même si le champ est effectivement désactivé et que sa propriété `disabled` vaut `false`. Les lignes suivantes montrent les données avant et après le changement d’état ; en JSON, `\n` représente la fin de ligne LF.
Leçons associées
- JavaScript · Leçon 4 · Avancé · Version : 4
Sources
- 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