Propriedade CSS grid-column-end
Use a propriedade CSS grid-column-end para definir onde um item de grid termina nas colunas, por número de linha ou span. Sintaxe, valores e exemplos.
A propriedade CSS grid-column-end define onde um item de grid termina ao longo do eixo inline (coluna). Você pode especificar uma linha de coluna onde o item deve parar, ou um span que indica quantas colunas o item deve cobrir. Junto com grid-column-start, ela define as bordas inline-start e inline-end da área de grid do item.
Como as linhas de grid são numeradas
Um grid é delimitado por linhas numeradas, não pelas faixas (colunas) em si. Um grid com três colunas possui quatro linhas verticais: a linha 1 corre ao longo da borda esquerda e a linha 4 ao longo da borda direita.
line: 1 2 3 4
| col | col | col |grid-column-end faz referência a uma dessas linhas:
grid-column-end: 3faz o item terminar na linha 3 — ele para antes da terceira coluna.grid-column-end: span 2faz o item terminar 2 colunas após onde ele começa, independentemente do número absoluto da linha.
Você também pode contar a partir do fim com números negativos: -1 é a última linha, -2 é a anterior. Assim, grid-column-end: -1 sempre alcança a borda direita do grid, independentemente de quantas colunas existam — útil para itens de "largura total".
Dica: o valor descreve apenas onde o item para. Onde ele começa vem de
grid-column-start(ou é posicionado automaticamente). O shorthandgrid-columndefine ambos de uma vez, por exemplogrid-column: 1 / 3.
| Valor Inicial | auto |
|---|---|
| Aplica-se a | Itens de grid. |
| Herdado | Não. |
| Animável | Sim. O número de colunas é animável. |
| Versão | CSS Grid Layout Module Level 1 |
| Sintaxe DOM | object.style.gridColumnEnd = "3"; |
Sintaxe
Sintaxe da Propriedade CSS grid-column-end
grid-column-end: auto | span n | column-line | initial | inherit;Exemplo da propriedade grid-column-end:
Exemplo da Propriedade CSS grid-column-end com o valor auto
<!DOCTYPE html>
<html>
<head>
<title>Title of the document</title>
<style>
.grid-container {
display: grid;
grid-template-columns: auto auto auto auto;
grid-gap: 5px;
background-color: #8ebf42;
padding: 10px;
}
.grid-container > div {
background-color: #eee;
text-align: center;
padding: 30px 0;
font-size: 30px;
}
.box1 {
grid-column-end: auto;
}
</style>
</head>
<body>
<h2>Grid-column-end property example</h2>
<div class="grid-container">
<div class="box1">1</div>
<div>2</div>
<div>3</div>
<div>4</div>
<div>5</div>
<div>6</div>
<div>7</div>
</div>
</body>
</html>Resultado
Exemplo da propriedade grid-column-end com números de linha e valores span:
Exemplo da Propriedade CSS grid-column-end com o valor span n
<!DOCTYPE html>
<html>
<head>
<title>Title of the document</title>
<style>
.grid-container {
display: grid;
grid-template-columns: auto auto auto auto;
grid-gap: 10px;
background-color: #ccc;
padding: 10px;
}
.grid-container > div {
background-color: #888;
text-align: center;
padding: 20px 0;
font-size: 30px;
}
.box1 {
grid-column-end: 3;
}
.span-container {
display: grid;
grid-template-columns: auto auto auto auto;
grid-gap: 10px;
background-color: #888;
padding: 10px;
margin-top: 20px;
}
.span-container > div {
background-color: #ccc;
text-align: center;
padding: 20px 0;
font-size: 30px;
}
.span-box1 {
grid-column-end: span 3;
}
</style>
</head>
<body>
<h2>Grid-column-end property example</h2>
<div class="grid-container">
<div class="box1">1</div>
<div>2</div>
<div>3</div>
<div>4</div>
<div>5</div>
<div>6</div>
</div>
<div class="span-container">
<div class="span-box1">1</div>
<div>2</div>
<div>3</div>
<div>4</div>
<div>5</div>
<div>6</div>
</div>
</body>
</html>O grid superior usa grid-column-end: 3 (um número de linha), portanto o primeiro item termina na linha 3 e cobre duas colunas. O grid inferior usa grid-column-end: span 3, fazendo o item abranger três colunas a partir de sua própria posição.
No exemplo a seguir, usamos novamente span para controlar quantas colunas o item cobre.
Exemplo da propriedade grid-column-end com o valor "span n":
Exemplo da propriedade CSS grid-column-end com o valor 'span n'
<!DOCTYPE html>
<html>
<head>
<title>Title of the document</title>
<style>
article {
display: grid;
grid-template-columns: auto auto auto;
grid-gap: 25px;
padding: 20px;
background-color: #7cbf7c;
}
article div {
text-align: center;
font-size: 35px;
background-color: #ffffff;
padding: 30px 0;
}
article div:first-child {
grid-column-end: span 3;
}
</style>
</head>
<body>
<article>
<div>1</div>
<div>2</div>
<div>3</div>
<div>4</div>
<div>5</div>
</article>
</body>
</html>No próximo exemplo, o valor aplicado especifica em qual coluna a exibição do item deve terminar.
Exemplo da propriedade grid-column-end com um valor de número de linha:
Exemplo da propriedade CSS grid-column-end com o valor 'column-line':
<!DOCTYPE html>
<html>
<head>
<title>Title of the document</title>
<style>
.grid-container {
display: grid;
grid-gap: 5px;
background-color: #8ebf42;
grid-template-columns: auto auto auto;
grid-gap: 20px;
padding: 30px;
}
.grid-container > div {
text-align: center;
font-size: 35px;
background-color: white;
padding: 20px 0;
}
.box1 {
grid-column-end: 3;
}
</style>
</head>
<body>
<h2>Grid-column-end property example</h2>
<div class="grid-container">
<div class="box1">1</div>
<div>2</div>
<div>3</div>
<div>4</div>
<div>5</div>
<div>6</div>
<div>7</div>
<div>8</div>
</div>
</body>
</html>Exemplo da propriedade grid-column-end com o valor "auto":
Exemplo de uso da propriedade CSS grid-column-end com o valor auto.
<!DOCTYPE html>
<html>
<head>
<title>Title of the document</title>
<style>
.grid-container {
display: grid;
grid-template-columns: auto auto auto;
grid-gap: 5px;
background-color: #8ebf42;
padding: 10px;
}
.grid-container > div {
background-color: #eee;
text-align: center;
padding: 30px 0;
font-size: 30px;
}
.box1 {
grid-column-end: auto;
}
</style>
</head>
<body>
<h2>Grid-column-end property example</h2>
<div class="grid-container">
<div class="box1">1</div>
<div class="box2">2</div>
<div class="box3">3</div>
<div class="box4">4</div>
<div class="box5">5</div>
<div class="box6">6</div>
<div class="box7">7</div>
</div>
</body>
</html>Valores
| Valor | Descrição | Experimente |
|---|---|---|
| auto | Posiciona o item automaticamente; por padrão abrange uma única coluna. Este é o valor inicial. | Experimente » |
| span n | O item termina n colunas após sua linha de início. | Experimente » |
| column-line | Um número de linha (positivo ou negativo) ou uma linha nomeada onde o item deve terminar. | Experimente » |
| initial | Define a propriedade para seu valor padrão (auto). | |
| inherit | Herda o valor do elemento pai. |
Erros comuns
spané relativo, linhas são absolutas.grid-column-end: 3sempre para na linha 3;grid-column-end: span 3para três colunas após a linha de início. Confundi-los é o erro de grid mais comum.- Terminar antes de começar é válido — o navegador os inverte. Se
grid-column-endresolver para uma linha antes degrid-column-start, os dois valores são trocados para que a área permaneça válida. grid-column-endsozinho não move o início. Definir apenas o fim deixa o início posicionado automaticamente. Para fixar ambos, use o shorthandgrid-column.
Propriedades relacionadas
grid-column-start— a borda inline-start do item.grid-column— shorthand para início e fim juntos.grid-row-end— o mesmo conceito no eixo de bloco (linha).grid-template-columns— define as colunas entre as quais essas linhas correm.