grid-row-end

La propriété grid-row-end définit la position de la fin d'un élément de la grille dans une zone donnée ou sur un fragment de ligne donné.

/* Valeurs avec un mot-clé */
grid-row-end: auto;

/* Valeurs <custom-ident> */
grid-row-end: somegridarea;

/* Valeurs <integer> + <custom-ident> */
grid-row-end: 2;
grid-row-end: somegridarea 4;

/* Valeurs span + <integer> + <custom-ident> */
grid-row-end: span 3;
grid-row-end: span somegridarea;
grid-row-end: 5 somegridarea span;

/* Valeurs globales */
grid-row-end: inherit;
grid-row-end: initial;
grid-row-end: unset;

Syntaxe

Valeurs

auto

Un mot-clé qui indique que la propriété ne contribue pas au placement de l'objet sur la grille. Par défaut, la taille du fragment allouée vaut 1 s'il n'y a pas d'autres contraintes.

<custom-ident>

S'il existe une ligne nommée '<custom-ident>-end', cela placera l'élément sur la première ligne correspondante..

Note : Les noms de zones génèrent automatiquement les noms de lignes sous cette forme. Ainsi, grid-row-end: foo; permettra de désigner l'extrêmité (à la fin) de la zone nommée (sauf si une autre ligne a explicitement été nommée avec foo-end).

Si aucune zone ne correspond, la valeur est traitée comme la combinaison de l'entier 1 et de <custom-ident> (cf. définition suivante).

<custom-ident> ne peut pas prendre la valeur span.

<integer> && <custom-ident>?

Contribue au placement de l'élément sur la n-ième ligne. Si une valeur négative est fournie, les lignes correspondantes sont comptées depuis la dernière. Si un nom est fourni pour <custom-ident>, seules les lignes avec ce nom sont comptées. S'il n'y a pas suffisamment de lignes avec ce nom, on considère que toutes les lignes sont intitulées avec ce nom afin de trouver une position.

Un entier nul ne peut pas être utilisé (la règle est invalide).

span && [ <integer> || <custom-ident> ]

Un fragment de grille est utilisé pour le placement de l'élément sur la grille afin que le début de la ligne pour l'élément de la grille soit placé à n lignes du bord situé au début.

Si un nom fourni pour <custom-ident>, seules les lignes ayant ce nom seront comptées. S'il n'y a pas suffisamment de lignes existantes avec ce nom, tout les lignes implicites du côté de la grille explicite et qui correspondent à la direction de la recherche seront comptées afin de placer ce fragment.

Si <integer> est absent, la valeur par défaut sera 1. Les entiers négatifs ou nuls ne sont pas autorisés.

Syntaxe formelle

<grid-line>
où 
<grid-line> = auto | <custom-ident> | [ <integer> && <custom-ident>? ] | [ span && [ <integer> || <custom-ident> ] ]

Exemples

CSS

#grid {
  display: grid;
  height: 200px;
  grid-template: 200px / repeat(4, 1fr);
}

#item1 {
  background-color: lime;
  grid-row-end: span 2;
}

#item2 {
  background-color: yellow;
}

#item3 {
  background-color: blue;
}

HTML

<div id="grid">
  <div id="item1"></div>
  <div id="item2"></div>
  <div id="item3"></div>
</div>

Résultat

Spécifications

Compatibilité des navigateurs

[1] Cette fonctionnalité pouvait être activée à partir de Chrome 29.0 via le marqueur fonctionnalités expérimentales de la Web Platform sous chrome://flags.

[2] Cette fonctionnalité est implémentée via la préférence layout.css.grid.enabled depuis Gecko 40 (Firefox 40.0 / Thunderbird 40.0 / SeaMonkey 2.37) où elle était désactivée par défaut. Depuis Gecko 52.0 (Firefox 52.0 / Thunderbird 52.0 / SeaMonkey 2.49), elle est activée par défaut.

[3] Internet Explorer implémente une ancienne version de la spécification qui utilise le préfixe -ms et qui ne définit que grid-cell et grid-row-span. Cette propriété est donc implémentée par IE avec -ms-grid-cell et -ms-grid-row-span.

[4] Cette fonctionnalité est disponible via la préférence Activer les fonctionnalités expérimentales de la plateforme web sous chrome://flags depuis Opera 28.0.

[5] Implémentation expérimentale disponible via Safari Technological Preview.

Voir aussi

• grid-row-start
• grid-row
• grid-column-start
• grid-column-end
• grid-column
• Guide : Placer les éléments d'une grille sur les lignes
• Tutoriel vidéo : le placement des éléments d'une grille sur les lignes (en anglais)