Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Propriété CSS row-rule-style

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

Vous voulez une meilleure prise en charge pour cette fonctionnalité ? Dites-nous pourquoi.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

La propriété CSS row-rule-style définit le style des lignes tracées entre les rangées dans les mises en page en grille multi-rangées, flexibles et multi-colonnes.

Exemple interactif

row-rule-style: solid;
row-rule-style: inset, outset;
row-rule-style: repeat(2, dashed, dotted), solid;
row-rule-style: solid, repeat(auto, dashed, dotted), solid;
row-rule-style: hidden;
<section id="default-example">
  <ul id="example-element">
    <li>Un poisson</li>
    <li>Deux poissons</li>
    <li>Trois poissons</li>
    <li>Quatre poissons</li>
  </ul>
</section>
#example-element {
  display: flex;
  flex-flow: column;
  row-rule-width: thick;
  row-rule-color: magenta;
  gap: 7px;
  text-align: left;
}

Syntaxe

css
/* Une seule valeur */
row-rule-style: none;
row-rule-style: hidden;
row-rule-style: dotted;

/* Plusieurs valeurs */
row-rule-style: groove, dashed, solid;
row-rule-style: double, repeat(5, ridge), double;
row-rule-style: solid, repeat(auto, inset, outset), solid;

/* Valeurs globales */
row-rule-style: inherit;
row-rule-style: initial;
row-rule-style: revert;
row-rule-style: revert-layer;
row-rule-style: unset;

Valeurs

La propriété row-rule-style accepte une liste de valeurs séparées par des virgules, y compris :

<line-style>

Un style de ligne (<line-style>) : l'une des valeurs none, hidden, dotted, dashed, solid, double, groove, ridge, inset ou outset. La valeur par défaut est none.

<repeat-line-style>

Une fonction repeat(), avec le premier argument étant un entier (<integer>) de 1 ou plus, et les arguments suivants étant des valeurs <line-style>. L'entier définit combien de fois les valeurs <line-style> doivent être répétées.

<auto-repeat-line-style>

Une fonction repeat(), avec auto comme premier argument et une ou plusieurs valeurs <line-style> comme arguments suivants. Les valeurs <line-style> fournies sont répétées autant de fois que nécessaire pour remplir les valeurs de toutes les règles de rangées qui ne sont pas définies explicitement par d'autres composants de la valeur de la propriété.

Description

La propriété row-rule-style définit le style des lignes tracées entre les rangées dans les conteneurs multi-colonnes, flexibles et grilles comportant plus d'une rangée.

La valeur est une liste de composants séparés par des virgules, qui peut inclure des types <line-style>, <repeat-line-style> et <auto-repeat-line-style>.

La propriété row-rule-style, ainsi que les propriétés row-rule-color et row-rule-width, peut être définie à l'aide du raccourci row-rule. La propriété row-rule-style, ainsi que la propriété column-rule-style, peut également être définie à l'aide du raccourci rule-style.

Si la valeur de la propriété ne contient qu'un seul <line-style>, toutes les règles de rangées ont ce style. Si nous déclarons ce qui suit, toutes les règles de rangées sont dashed :

css
row-rule-style: dashed;

Lorsque plus d'un <line-style> est déclaré, ils sont appliqués aux règle de rangées dans l'ordre défini. Si le nombre de règle de rangées est supérieur au nombre de valeurs <line-style>, la liste des styles de ligne est répétée jusqu'à ce que chaque règle de rangée ait un style. Si nous déclarons ce qui suit, par exemple, toutes les règles de rangées impaires sont dashed et toutes les règles de rangées paires sont dotted.

css
row-rule-style: dashed, dotted;

Styles de ligne répétés

La fonction repeat(), avec un entier de 1 ou plus comme premier argument, peut être utilisée pour répéter une liste valide de valeurs CSS <line-style> passées comme arguments suivants le nombre de fois défini. Cela permet de répéter le même style un nombre défini de fois sans répéter la même valeur. Vous pouvez inclure des valeurs de mot-clé <line-style> ou des propriétés personnalisées qui se résolvent en un <line-style> valide. L'utilisation de repeat() peut rendre les valeurs plus faciles à écrire, permettant d'écrire des motifs récurrents en utilisant une seule fonction, quel que soit le nombre de rangées. Les déclarations suivantes sont équivalentes :

css
row-rule-style: solid, outset, inset, outset, inset;
row-rule-style: solid, repeat(2, outset, inset);

Cela crée une liste de cinq styles. Si le nombre de styles dans la liste de styles de la valeur row-rule-style dépasse le nombre de règle de rangées, les styles excédentaires sont ignorés. Si le conteneur a trois rangées, la règle dans la première gouttière est solid et la deuxième outset.

Si le nombre de gouttières est supérieur au nombre de styles, la liste des styles est répétée. Si le conteneur a 6, 11, 16 ou 21 rangées, cette séquence de styles est répétée une, deux, trois ou quatre fois, respectivement, la dernière règle de ligne étant inset.

Répétition automatique des styles de ligne

La fonction repeat() accepte également auto comme premier argument au lieu d'un entier positif. Avec auto comme premier argument, les valeurs <line-style> passées comme paramètres suivants sont répétées autant de fois que nécessaire pour remplir les valeurs de toutes les règles de rangées qui ne sont pas définies explicitement par d'autres composants de la valeur de la propriété.

css
row-rule-style: solid, repeat(auto, dotted), solid;

Dans ce cas, peu importe si le conteneur a 3, 6, 11, 16 ou 21 rangées ; la première et la dernière règle de rangée sont toujours solid, et toutes les autres règle de rangées sont dotted. S'il n'y a que 2 ou 3 rangées, il n'y a pas de règle de rangées dotted.

Le mot-clé auto dans la fonction repeat() crée un répétiteur automatique qui remplit les valeurs pour les règles de rangées qui ne reçoivent pas autrement de valeurs provenant d'autres parties de la liste, empêchant la liste d'être répétée. Au maximum, une seule occurrence de repeat(auto, <line-style>) peut être présente dans une valeur row-rule-style.

Définition formelle

Valeur introuvable dans la base de données

Syntaxe formelle

row-rule-style = 
<line-style-list> |
<auto-line-style-list>

<line-style-list> =
<line-style-or-repeat>#

<auto-line-style-list> =
<line-style-or-repeat>#? , <auto-repeat-line-style> , <line-style-or-repeat>#?

<line-style-or-repeat> =
<line-style> |
<repeat-line-style>

<auto-repeat-line-style> =
repeat( auto , [ <line-style> ]# )

<line-style> =
none |
hidden |
dotted |
dashed |
solid |
double |
groove |
ridge |
inset |
outset

<repeat-line-style> =
repeat( [ <integer [1,∞]> ] , [ <line-style> ]# )

<integer> =
<number-token>

Exemples

Exemple simple

Dans cet exemple, nous définissons un style unique pour les lignes tracées entre les éléments flexibles.

HTML

Nous incluons une liste de duos sportifs dynamiques :

html
<ul>
  <li>Simone Biles + Jonathan Owens</li>
  <li>Serena Williams + Venus Williams</li>
  <li>Aaron Judge + Giancarlo Stanton</li>
  <li>LeBron James + Dwyane Wade</li>
  <li>Xavi Hernandez + Andres Iniesta</li>
  <li>Kerri Walsh + Misty May Treanor</li>
</ul>

CSS

Nous définissons la liste comme un conteneur flexible, créant des rangées en définissant la flex-direction sur column à l'aide du raccourci flex-flow. Nous incluons un gap de 5px pour fournir suffisamment d'espace entre les rangées pour accueillir notre règle rouge en pointillés de 3px :

css
ul {
  display: flex;
  flex-flow: column;
  gap: 5px;
  row-rule-width: 3px;
  row-rule-color: red;

  row-rule-style: dashed;
}

Résultat

Valeurs répétées

Cet exemple montre comment, lorsque le nombre de valeurs dans la liste des styles est inférieur au nombre de règles de rangées, les valeurs sont répétées.

CSS

En utilisant le même HTML et CSS que dans l'exemple précédent, nous incluons trois styles séparés par des virgules comme valeur de row-rule-style :

css
ul {
  row-rule-style: solid, dotted, dashed;
}

Résultat

Utiliser la fonction repeat()

Cet exemple montre comment utiliser la fonction repeat() dans la valeur de la propriété row-rule-style.

CSS

Nous utilisons le même HTML et CSS que dans les exemples précédents. Nous incluons une fonction repeat(), définissant la liste de deux valeurs <line-style> à répéter 3 fois.

css
ul {
  row-rule-style: double, repeat(3, inset, dashed), double;
}

Résultat

Le conteneur flexible a six rangées, donc cinq gouttières. La fonction repeat() répète deux valeurs de style trois fois, créant une liste de huit valeurs de style, donc les trois dernières valeurs de la liste sont ignorées.

Utiliser auto dans repeat()

Cet exemple montre comment utiliser auto au lieu d'un entier dans la fonction repeat().

CSS

En utilisant repeat(auto, <line-style>), nous définissons toutes les règles de rangées sur dotted, sauf la première et la dernière, que nous définissons sur solid.

css
ul {
  row-rule-style: solid, repeat(auto, dotted), solid;
}

Résultat

Spécifications

Spécification
CSS Gaps Module Level 1
# propdef-row-rule-style

Compatibilité des navigateurs

Voir aussi