CKTIS / CSS
:disabled — pseudo-classe des éléments désactivés
La pseudo-classe :disabled sélectionne les éléments réellement désactivés selon les règles HTML, et pas seulement ceux qui portent un attribut disabled. Elle permet de styliser l’état d’un contrôle, mais ne le désactive pas elle-même.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
:disabledLa pseudo-classe :disabled correspond aux éléments d’interface dans l’état désactivé défini par le langage du document. En HTML, elle concerne les éléments button, input, select, textarea, optgroup, option et fieldset réellement désactivés, ainsi que les éléments personnalisés associés à un formulaire. button:disabled limite la sélection aux boutons.
Ne confondez pas :disabled et [disabled] : ce dernier sélecteur vérifie uniquement la présence de l’attribut. Un contrôle placé dans un fieldset désactivé peut correspondre à :disabled sans avoir son propre attribut disabled. La désactivation par ce fieldset ne concerne pas les descendants de son premier enfant legend ; ceux-ci peuvent toutefois être désactivés pour une autre raison. L’exemple illustre cette différence.
Le sélecteur détecte uniquement l’état : une règle CSS ne désactive pas un contrôle. Des propriétés telles que display et visibility ne modifient pas la correspondance avec :disabled. De même, readonly seul ne signifie pas qu’un élément est désactivé. :enabled n’équivaut pas à :not(:disabled) pour tous les éléments : un paragraphe ordinaire ne correspond ni à :enabled ni à :disabled, mais il correspond à :not(:disabled).
Dans l’exemple, les boutons inherited et direct reçoivent un contour rouge, et le résultat textuel est inherited, direct. Le bouton exception bénéficie de l’exception concernant le premier legend, tandis que available reste activé. Le résultat textuel a été vérifié dans un environnement de navigation isolé.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:disabled example</title>
<style>
button:disabled { outline: 3px solid #b00020; }
</style>
<fieldset disabled>
<legend><button id="exception" type="button">Exception</button></legend>
<button id="inherited" type="button">Inherited</button>
</fieldset>
<button id="direct" type="button" disabled>Direct</button>
<button id="available" type="button">Available</button>
<pre id="result"></pre>
<script>
const ids = Array.from(document.querySelectorAll('button:disabled'),
button => button.id);
document.getElementById('result').textContent = ids.join(', ');
</script>
</html>Résultat
inherited, direct
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.