CKTIS / JavaScript
Désactiver les contrôles de formulaire HTML avec `disabled`
`disabled` désactive un contrôle de formulaire HTML et l’exclut de la validation et des données du formulaire. La propriété `.disabled` et le sélecteur `:disabled` ne vérifient pas la même chose.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
<input name="city" disabled>
<script>
const input = document.querySelector('input[name="city"]');
input.disabled = true;
input.disabled = false;
input.matches(":disabled");
</script>disabled est un attribut booléen HTML : seule sa présence compte, donc même disabled="false" désactive l’élément. Cela concerne notamment input, button, select, textarea et les éléments personnalisés associés à un formulaire. option et optgroup ont leurs propres règles : un optgroup désactivé empêche de sélectionner ses options sans désactiver le select lui-même.
Un fieldset désactivé désactive ses contrôles descendants, sauf ceux qui se trouvent dans le premier élément legend qui est son enfant direct, s’il existe. Sur un input, .disabled reflète uniquement son propre attribut : true l’ajoute et false le retire. Utilisez input.matches(":disabled") pour vérifier l’état effectif, y compris l’effet d’un fieldset.
L’utilisateur ne peut ni donner le focus à un contrôle désactivé ni l’utiliser normalement, mais un script peut toujours modifier, par exemple, input.value. Le navigateur ignore ce contrôle lors de la validation des contraintes et de la construction des données du formulaire, y compris avec new FormData(form). Sur les champs de saisie qui le prennent en charge, readonly empêche la modification par l’utilisateur et exclut le champ de la validation des contraintes, mais n’empêche à lui seul ni le focus ni l’inclusion dans les données du formulaire.
Ces fonctionnalités relèvent de la plateforme web, pas d’ECMAScript. La désactivation n’est pas une mesure de sécurité : validez les données et contrôlez les autorisations côté serveur.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Disabled form control</title>
</head>
<body>
<script>
const form = document.createElement("form");
const group = document.createElement("fieldset");
const input = document.createElement("input");
input.name = "city";
input.value = "Oslo";
group.append(input);
form.append(group);
const report = () => console.log(JSON.stringify([
input.disabled,
input.matches(":disabled"),
input.willValidate,
new FormData(form).has("city")
]));
group.disabled = true;
report();
group.disabled = false;
report();
</script>
</body>
</html>Résultat
[false,true,false,false] [false,false,true,true]
Chaque ligne indique, dans l’ordre, `.disabled`, la correspondance avec `:disabled`, `.willValidate` et la présence de l’entrée `city`. La réactivation du `fieldset` change les trois derniers résultats ; le champ n’a jamais son propre attribut `disabled`.
Leçons associées
- JavaScript · Leçon 20 · Intermédiaire · Version : 3
- JavaScript · Leçon 21 · Intermédiaire · Version : 3