Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

repeat(): faixas repetidas e padrões próprios para cores dos separadores

Repita um padrão de faixas, distinga auto-fill de auto-fit e respeite a gramática de cada propriedade.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

grid-template-columns: repeat(auto-fit, minmax(100px, 1fr));

Numa lista de faixas de grelha, repeat() repete um padrão com uma ou mais faixas e nomes de linha opcionais. O número fixo de repetições tem de ser um inteiro positivo: zero não significa um padrão vazio e a função não pode ser aninhada. As formas automáticas exigem a gramática restrita fixed-size. Assim, repeat(auto-fill, 1fr) é inválido, mas repeat(auto-fill, minmax(100px, 1fr)) é permitido porque o mínimo fornece um comprimento definido. Uma lista só pode conter uma repetição automática.

auto-fill conserva as faixas que cabem no espaço disponível. Após a colocação, auto-fit reduz a zero as faixas repetidas vazias e os intervalos adjacentes, permitindo crescer às faixas flexíveis ocupadas. Não elimina as ocupadas. Sem uma restrição dimensional definida, não se deve assumir que a contagem automática preenche qualquer largura. Numa subgrelha, a forma name-repeat repete listas de nomes de linha, não novas dimensões de faixas.

O exemplo cria dois elementos numa grelha com 350px de largura e intervalos de 10px. Um padrão fixo de duas faixas repete-se três vezes. As formas automáticas produzem três faixas de 110px ou duas de 170px e uma reduzida a 0px. As formas rejeitadas mostram restrições da gramática, não uma falha do navegador.

CSS Gaps também define repeat() para cores de separadores, incluindo repeat(2, red, blue), e uma forma automática com auto, em vez das palavras-chave da grelha. É uma gramática distinta para propriedades como column-rule-color. O Chromium 157 aceita a sintaxe de cor testada, mas essa última prova não verifica a pintura nem outros motores; a fonte CSS Gaps continua a ser um rascunho de especificação.

Exemplos

const grid = document.createElement('div');
grid.style.cssText = 'display:grid;width:350px;gap:10px';
grid.append(document.createElement('div'), document.createElement('div'));
document.body.append(grid);
for (const value of ['repeat(3,40px 20px)',
  'repeat(auto-fill,minmax(100px,1fr))',
  'repeat(auto-fit,minmax(100px,1fr))']) {
  grid.style.gridTemplateColumns = value;
  console.log(value + ':', getComputedStyle(grid).gridTemplateColumns);
}
for (const value of ['repeat(0,10px)', 'repeat(2,repeat(2,10px))',
  'repeat(auto-fill,1fr)', 'repeat(auto-fill,minmax(100px,1fr))']) {
  console.log('accepts ' + value + ':', CSS.supports('grid-template-columns', value));
}
console.log('gap color syntax:', CSS.supports('column-rule-color', 'repeat(2,red,blue)'));
grid.remove();

Resultado

repeat(3,40px 20px): 40px 20px 40px 20px 40px 20px
repeat(auto-fill,minmax(100px,1fr)): 110px 110px 110px
repeat(auto-fit,minmax(100px,1fr)): 170px 170px 0px
accepts repeat(0,10px): false
accepts repeat(2,repeat(2,10px)): false
accepts repeat(auto-fill,1fr): false
accepts repeat(auto-fill,minmax(100px,1fr)): true
gap color syntax: true

As dimensões da grelha são medidas após o layout, incluindo a faixa reduzida a zero. O resultado das cores dos separadores comprova apenas aceitação sintática, não que tenham sido desenhados.

Fontes