Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

repeat() : répétition des pistes et motifs distincts pour les couleurs des séparateurs

Répétez un motif de pistes, distinguez auto-fill et auto-fit et respectez la grammaire de chaque propriété.

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

Syntaxe

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

Dans une liste de pistes de grille, repeat() répète un motif contenant une ou plusieurs pistes et des noms de lignes facultatifs. Le nombre fixe de répétitions doit être un entier positif : zéro ne désigne pas un motif vide et l’imbrication est interdite. Les formes automatiques exigent la grammaire restreinte fixed-size. Ainsi repeat(auto-fill, 1fr) est invalide, mais repeat(auto-fill, minmax(100px, 1fr)) est permis grâce à la longueur minimale définie. Une liste ne peut contenir qu’une répétition automatique.

auto-fill conserve les pistes qui tiennent dans l’espace disponible. Après placement, auto-fit réduit à zéro les pistes répétées vides et leurs gouttières adjacentes, permettant aux pistes flexibles occupées de grandir. Il ne supprime pas les pistes occupées. Sans contrainte dimensionnelle définie, on ne peut supposer que le compte automatique remplira une largeur arbitraire. Dans une sous-grille, la forme name-repeat répète des listes de noms de lignes, pas de nouvelles tailles de pistes.

L’exemple crée deux éléments dans une grille de 350px de large avec un intervalle de 10px. Un motif fixe de deux pistes est répété trois fois. Les formes automatiques produisent trois pistes de 110px ou deux de 170px plus une piste réduite à 0px. Les formes refusées illustrent les restrictions de syntaxe, pas une panne du navigateur.

CSS Gaps définit aussi repeat() pour les couleurs des séparateurs, notamment repeat(2, red, blue) et une forme automatique utilisant auto plutôt que les mots-clés de grille. C’est une grammaire distincte pour des propriétés comme column-rule-color. Chromium 157 accepte la syntaxe de couleur testée, mais ce dernier test ne vérifie ni le dessin ni les autres moteurs ; la source CSS Gaps reste un projet de spécification.

Exemples

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();

Résultat

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

Les tailles sont mesurées après mise en page, y compris la piste réduite à zéro. Le résultat sur les couleurs des séparateurs prouve seulement l’acceptation syntaxique, pas leur rendu.

Sources