CKTIS / JavaScript
Commandes de formulaire désactivées
L’utilisateur ne peut ni utiliser les commandes de formulaire désactivées ni leur donner le focus, et leurs valeurs ne sont pas envoyées. En JavaScript, la propriété `disabled` modifie l’état de désactivation propre à une commande, tandis qu’un `fieldset` englobant peut également la désactiver.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
control.disabled = true;
control.disabled = false;
control.matches(':disabled');Les commandes de formulaire désactivées sont des commandes de formulaire qui ont été désactivées. Les utilisateurs ne peuvent ni les modifier ni les activer en cliquant dessus ; elles ne peuvent pas recevoir le focus et ne participent pas à la validation des contraintes. Leurs valeurs sont omises lors de l’envoi du formulaire. Il s’agit d’un mécanisme HTML et du DOM du navigateur, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. MDN indique que HTMLInputElement.disabled est largement disponible dans les navigateurs depuis juillet 2015 ; la présence de Node 24 ne prouve pas la prise en charge du DOM.
La propriété input.disabled est une valeur booléenne qui reflète l’attribut disabled propre à l’élément. Lui affecter true ajoute cet attribut, et lui affecter false le supprime. Cet attribut est booléen : même disabled="false" signifie que l’élément est désactivé, car c’est la présence de l’attribut, et non sa valeur textuelle, qui compte.
Un fieldset désactivé désactive également ses commandes descendantes, sauf celles qui se trouvent dans le premier élément legend qui est un enfant direct de ce fieldset. Le simple fait qu’une commande se trouve dans le legend d’un fieldset imbriqué ne la protège pas de la désactivation par le fieldset extérieur. Ainsi, input.disabled peut valoir false alors qu’un élément ancêtre désactive toujours la commande ; utilisez input.matches(':disabled') pour vérifier son état effectif. Affecter uniquement input.disabled = false ne neutralise pas la désactivation imposée par un fieldset.
Ne confondez pas disabled avec readonly : les champs en lecture seule qui prennent en charge cet attribut peuvent toujours recevoir le focus et transmettre leur valeur lors de l’envoi du formulaire. readonly s’applique aux types textuels de input et à textarea, mais pas, par exemple, à select ou button. L’exemple montre comment basculer disabled et comment le champ est alors omis de FormData.
Exemples
const form = document.createElement('form');
const input = document.createElement('input');
input.name = 'topic';
input.value = 'JavaScript';
form.append(input);
input.disabled = true;
console.log(input.disabled);
console.log(new FormData(form).has('topic'));
input.disabled = false;
console.log(new FormData(form).get('topic'));Résultat
true false JavaScript
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.