Attribut global HTMLAttributs globaux

hidden

Masque l’élément : le navigateur ne l’affiche pas et ne l’expose pas.

S’applique à
Tous les éléments HTML
Sur cette page

Exemple

#
HTML
<p>Ce paragraphe est visible.</p>
<p hidden>Ce paragraphe n’est pas visible, bien qu’il soit dans le code.</p>
<button type="button" onclick="this.nextElementSibling.hidden = !this.nextElementSibling.hidden">
  Afficher ou masquer l’indice
</button>
<p hidden>Indice : commencez par la balise &lt;h1&gt;.</p>
Aperçu

Définition et utilisation

#

L’attribut booléen hidden signifie que l’élément n’est pas pertinent pour le moment. Le navigateur ne l’affiche pas et les lecteurs d’écran l’ignorent. C’est comme si l’élément avait display: none.

On le bascule le plus souvent en JavaScript : element.hidden = true masque, false affiche. C’est plus simple et plus lisible que d’ajouter une classe de masquage.

Attention au CSS : si vous donnez à l’élément son propre display, par exemple display: flex, la règle de l’auteur peut l’emporter sur le style par défaut du navigateur et l’élément devient visible malgré l’attribut hidden.

Syntaxe

#
Syntaxe
<element hidden>…</element>

Valeurs

#
  • hidden

    ou vide

    L’élément est masqué et inaccessible à l’utilisateur.
  • until-found

    L’élément est masqué, mais la recherche dans la page du navigateur peut le trouver et le dévoiler. Valeur plus récente, qui ne fonctionne pas encore partout.

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
[hidden] {
  display: none;
}

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Si vous voulez masquer quelque chose visuellement tout en le laissant aux lecteurs d’écran, n’utilisez pas hidden, mais une classe de type sr-only.
  • Ajoutez [hidden] { display: none !important; } à votre feuille de style pour que vos propres styles ne dévoilent pas les éléments masqués.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.