CSS-свойство `grid-row`

Сокращённое CSS-свойство grid-row CSS сокращённое задаёт размер и расположение элемента сетки в строке сетки, добавляя в его размещение в сетке линию, интервал или ничего (автоматическое размещение), тем самым задавая начальную и конечную границы его области сетки.

Попробуйте

grid-row: 1;

grid-row: 1 / 3;

grid-row: 2 / -1;

grid-row: 1 / span 2;

<section class="default-example" id="default-example">
  <div class="example-container">
    <div class="transition-all" id="example-element">One</div>
    <div>Two</div>
    <div>Three</div>
  </div>
</section>

.example-container {
  border: 1px solid #c5c5c5;
  display: grid;
  grid-template-columns: 1fr 1.5fr 1fr;
  grid-template-rows: repeat(3, minmax(40px, auto));
  grid-gap: 10px;
  width: 200px;
}

.example-container > div {
  background-color: rgb(0 0 255 / 0.2);
  border: 3px solid blue;
}

#example-element {
  background-color: rgb(255 0 200 / 0.2);
  border: 3px solid rebeccapurple;
}

Составные свойства

Это свойство является сокращённой записью следующих CSS-свойств:

• grid-row-end
• grid-row-start

Синтаксис

/* Keyword values */
grid-row: auto;
grid-row: auto / auto;

/* <custom-ident> values */
grid-row: some-grid-area;
grid-row: some-grid-area / some-other-grid-area;

/* <integer> + <custom-ident> values */
grid-row: some-grid-area 4;
grid-row: 4 some-grid-area / 6;

/* span + <integer> + <custom-ident> values */
grid-row: span 3;
grid-row: span some-grid-area;
grid-row: 5 some-grid-area span;
grid-row: span 3 / 6;
grid-row: span some-grid-area / span some-other-grid-area;
grid-row: 5 some-grid-area span / 2 span;

/* Global values */
grid-row: inherit;
grid-row: initial;
grid-row: revert;
grid-row: revert-layer;
grid-row: unset;

Это свойство задаётся одним или двумя значениями <grid-line>.

Если указаны два значения <grid-line>, они разделяются символом /. Для длинного свойства grid-row-start задаётся значение перед косой чертой, а для длинного свойства grid-row-end — значение после неё.

Каждое значение <grid-line> можно задать как:

• ключевое слово auto
• значение <custom-ident>
• значение <integer>
• значения <custom-ident> и <integer>, разделённые пробелом
• ключевое слово span вместе со значением <custom-ident> или <integer>, либо с обоими.

Значения

auto

Ключевое слово, указывающее, что свойство ничего не добавляет к размещению элемента сетки: применяется автоматическое размещение, автоматический интервал или интервал по умолчанию, равный 1.

<custom-ident>

Если существует именованная линия с именем <custom-ident>-start/<custom-ident>-end, она добавляет первую такую линию к размещению элемента сетки.

Примечание: Именованные области сетки автоматически создают неявные именованные линии этого вида, поэтому указание grid-row: foo; выберет начальную/конечную границу этой именованной области сетки (если перед ней явно не была задана другая линия с именем foo-start/foo-end).

В противном случае это обрабатывается так, как если бы вместе с <custom-ident> было указано целое число 1.

<integer> && <custom-ident>?

Добавляет n-ю линию сетки к размещению элемента сетки. Если указано отрицательное целое число, отсчёт ведётся в обратном направлении, начиная с конечной границы явной сетки.

Если в качестве <custom-ident> указано имя, учитываются только линии с этим именем. Если таких линий недостаточно, считается, что все неявные линии сетки имеют это имя, чтобы определить эту позицию.

Значение <integer> 0 недопустимо.

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

Добавляет интервал сетки к размещению элемента сетки так, чтобы соответствующая граница области сетки элемента находилась на n линий от противоположной границы.

Если в качестве <custom-ident> указано имя, учитываются только линии с этим именем. Если таких линий недостаточно, считается, что все неявные линии сетки на стороне явной сетки, соответствующей направлению поиска, имеют это имя для подсчёта интервала.

Если <integer> не указано, по умолчанию используется 1. Отрицательные целые числа и 0 недопустимы.

Формальное определение

Формальный синтаксис

grid-row = 
  <grid-line> [ / <grid-line> ]?

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

<integer> = 
  <number-token>

Примеры

Задание размера и расположения строки сетки

HTML

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

CSS

#grid {
  display: grid;
  height: 200px;
  grid-template-columns: 200px;
  grid-template-rows: repeat(6, 1fr);
}

#item1 {
  background-color: lime;
}

#item2 {
  background-color: yellow;
  grid-row: 2 / 4;
}

#item3 {
  background-color: blue;
  grid-row: span 2 / 7;
}

Результат

Спецификации

Совместимость с браузерами

См. также

• grid-row-start
• grid-row-end
• grid-column
• grid-column-start
• grid-column-end
• Размещение по линиям с помощью CSS Grid
• Видео: Размещение по линиям