Propriété CSSGrid

grid-area

Assigne un élément à une zone nommée de la grille, ou règle en une fois ses lignes et ses colonnes.

Valeur initiale
auto
Héritée
Non
Animable
non
S’applique à
éléments grid et éléments en position absolue dans un conteneur grid
JavaScript
element.style.gridArea = "sidebar"
Sur cette page

Exemple

#
CSS
.profile {
  display: grid;
  grid-template-areas:
    "avatar name"
    "avatar level";
  grid-template-columns: 56px 1fr;
  column-gap: 12px;
}

.avatar { grid-area: avatar; }
.name { grid-area: name; }
.level { grid-area: level; }
Aperçu

Définition et utilisation

#

La propriété grid-area a deux usages. Le plus souvent, on lui donne le nom d’une zone définie dans grid-template-areas du parent, par exemple grid-area: sidebar, et l’élément se place à cet endroit.

Elle peut aussi servir de raccourci pour quatre lignes : grid-area: 1 / 1 / 3 / 3 représente dans l’ordre le début de ligne, le début de colonne, la fin de ligne et la fin de colonne.

Les zones nommées rendent le code lisible : on voit tout de suite où va l’élément, sans compter les lignes.

Syntaxe

#
Syntaxe
grid-area: <nom> | <ligne-début> / <colonne-début> / <ligne-fin> / <colonne-fin>;

Valeurs

#
  • auto

    Emplacement automatique dans la grille.
  • a

    <nom>

    L’élément va dans la zone « a » (2 × 2 cellules).
  • 1 / 2 / 3 / 4

    quatre lignes

    Lignes 1-2 et colonnes 2-3.

Valeurs en pratique

#

auto

Emplacement automatique dans la grille.
.target { grid-area: auto; }

a

L’élément va dans la zone « a » (2 × 2 cellules).
.target { grid-area: a; }

1 / 2 / 3 / 4

Lignes 1-2 et colonnes 2-3.
.target { grid-area: 1 / 2 / 3 / 4; }

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

#
  • Vous écrivez les noms de zones dans grid-area sans guillemets, et dans grid-template-areas avec des guillemets.
  • L’ordre des quatre valeurs est : début de ligne, début de colonne, fin de ligne, fin de colonne. On le confond facilement avec l’ordre des marges.

Entrées associées

#

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