Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

disabled : exclure une commande de l’interaction et de l’envoi

Distinguez désactivation, lecture seule et autorisation de sécurité.

Version : HTML Living Standard

Syntaxe

<fieldset disabled><legend>...</legend>...</fieldset>

Le booléen disabled désactive les contrôles de formulaire concernés. Ils sont normalement exclus de l’envoi et de la validation. Un fieldset désactivé touche ses descendants sauf ceux de sa première légende. Options et groupes d’options ont leurs propres règles. Un lien de feuille de style utilise ce nom pour un mécanisme distinct de chargement et d’application.

La présence active l’état désactivé, même avec le texte false. Ce n’est pas équivalent à readonly : un champ textuel en lecture seule peut être transmis. JavaScript peut modifier les contrôles désactivés et cette protection côté client ne remplace jamais l’autorisation serveur. Ajouter l’attribut à un lien ordinaire ne le désactive pas.

L’exemple transmet le champ de la première légende et celui en lecture seule, mais omet le champ obligatoire désactivé. La validation réussit parce que ce dernier est exclu. Le test vérifie cette exception et les noms réellement transmis.

Exemples

<!doctype html><meta charset="utf-8">
<form id="form"><fieldset disabled><legend><label>Kept <input name="kept" value="A"></label></legend><label>Omitted <input id="omitted" name="omitted" required></label></fieldset>
<label>Read only <input name="readOnly" value="B" readonly></label></form><output id="result"></output><script>
const form = document.querySelector('#form');
document.querySelector('#result').textContent = 'fields=' + [...new FormData(form).keys()].join(',') + '; valid=' + form.checkValidity() + '; disabledWillValidate=' + document.querySelector('#omitted').willValidate;
</script>

Résultat

fields=kept,readOnly; valid=true; disabledWillValidate=false

Le champ obligatoire désactivé est vide ; son exclusion de la validation est vérifiée explicitement.

Sources