repeat()

Répète un motif de colonnes ou de lignes de grille. Avec auto-fill ou auto-fit et minmax(), elle crée une grille responsive sans media queries.

Sur cette page

Exemple

#
CSS
.courses {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(min(140px, 100%), 1fr));
  gap: 10px;
}
Aperçu

La grille décide elle-même du nombre de colonnes : il y en a plus sur ordinateur, moins sur téléphone. Il n’y a ici pas une seule media query.

Définition et utilisation

#

La fonction repeat() raccourcit l’écriture des pistes d’une grille CSS Grid. Au lieu de 1fr 1fr 1fr 1fr, vous écrivez repeat(4, 1fr), et au lieu de 100px 1fr 100px 1fr, simplement repeat(2, 100px 1fr). Elle fonctionne dans grid-template-columns et grid-template-rows, et peut se combiner avec des valeurs ordinaires, par exemple 200px repeat(3, 1fr).

À la place d’un nombre, vous pouvez écrire auto-fill ou auto-fit. Le navigateur calcule alors lui-même combien de colonnes tiennent dans le conteneur. Associé à minmax(), cela donne une grille responsive sans media queries : repeat(auto-fill, minmax(160px, 1fr)) crée autant de colonnes d’au moins 160px qu’il en tient, et répartit l’espace excédentaire équitablement entre elles.

La fonction minmax(MIN, MAX) définit la plage de taille d’une piste : la colonne ne sera ni plus étroite que MIN ni plus large que MAX. On donne souvent 1fr comme maximum, c’est-à-dire une part égale de l’espace libre. Sur un écran très étroit, le minimum peut dépasser la largeur du conteneur : il est donc plus sûr d’écrire minmax(min(160px, 100%), 1fr).

La différence entre auto-fill et auto-fit apparaît quand il y a peu d’éléments. auto-fill crée des colonnes de réserve, même vides, de sorte que les éléments gardent leur taille. auto-fit réduit les colonnes vides à zéro et laisse les éléments existants s’étirer sur toute la largeur. Avec beaucoup d’éléments, les deux versions donnent le même rendu.

Syntaxe

#
Syntaxe
repeat(<nombre> | auto-fill | auto-fit, <taille de piste>+)
minmax(<minimum>, <maximum>)

Motifs courants

#
  • repeat(3, 1fr)

    trois colonnes égales

    Trois colonnes, chacune d’une part égale de la largeur. Six tuiles s’organisent en deux rangées.
  • repeat(2, 60px 1fr)

    motif répété

    On peut répéter un motif entier. Ici, deux fois une paire : une colonne étroite de 60 px et une large de 1fr, soit quatre colonnes au total.
  • repeat(3, minmax(50px, 90px))

    colonnes de 50 à 90 px

    Chaque colonne fait entre 50 et 90 px. Dans un cadre large, elles s’arrêtent à 90 px, et quand on le rétrécit (faites glisser le coin inférieur droit) elles diminuent, mais pas en dessous de 50 px.
  • repeat(auto-fill, minmax(70px, 1fr))

    colonnes de réserve

    Le navigateur crée autant de colonnes qu’il en tient, même vides. Deux tuiles n’occupent qu’une partie de la largeur et le reste demeure libre. Rétrécissez le cadre pour voir les colonnes disparaître une à une.
  • repeat(auto-fit, minmax(70px, 1fr))

    les colonnes vides disparaissent

    Les colonnes vides se réduisent à zéro : les deux mêmes tuiles s’étirent donc sur toute la largeur. Comparez avec auto-fill à côté.

Motifs courants en pratique

#

repeat(3, 1fr)

Trois colonnes, chacune d’une part égale de la largeur. Six tuiles s’organisent en deux rangées.
.demo {
  grid-template-columns: repeat(3, 1fr);
}

repeat(2, 60px 1fr)

On peut répéter un motif entier. Ici, deux fois une paire : une colonne étroite de 60 px et une large de 1fr, soit quatre colonnes au total.
.demo {
  grid-template-columns: repeat(2, 60px 1fr);
}

repeat(3, minmax(50px, 90px))

Chaque colonne fait entre 50 et 90 px. Dans un cadre large, elles s’arrêtent à 90 px, et quand on le rétrécit (faites glisser le coin inférieur droit) elles diminuent, mais pas en dessous de 50 px.
.demo {
  grid-template-columns:
    repeat(3, minmax(50px, 90px));
}

repeat(auto-fill, minmax(70px, 1fr))

Le navigateur crée autant de colonnes qu’il en tient, même vides. Deux tuiles n’occupent qu’une partie de la largeur et le reste demeure libre. Rétrécissez le cadre pour voir les colonnes disparaître une à une.
.demo {
  grid-template-columns:
    repeat(auto-fill, minmax(70px, 1fr));
}

repeat(auto-fit, minmax(70px, 1fr))

Les colonnes vides se réduisent à zéro : les deux mêmes tuiles s’étirent donc sur toute la largeur. Comparez avec auto-fill à côté.
.demo {
  grid-template-columns:
    repeat(auto-fit, minmax(70px, 1fr));
}

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Avec auto-fill et auto-fit, le minimum dans minmax() doit être fixe, par exemple 160px, et non auto ou 1fr. Sinon, le navigateur ne peut pas calculer combien de colonnes tiennent.
  • Quand il y a peu d’éléments et qu’ils doivent s’étirer sur toute la largeur, choisissez auto-fit. Quand ils doivent garder leur taille, choisissez auto-fill.
  • L’écriture minmax(min(160px, 100%), 1fr) protège du défilement horizontal sur des écrans plus étroits que 160 px.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.