diff options
Diffstat (limited to 'files/fr/web/css/gap')
| -rw-r--r-- | files/fr/web/css/gap/index.html | 228 |
1 files changed, 228 insertions, 0 deletions
diff --git a/files/fr/web/css/gap/index.html b/files/fr/web/css/gap/index.html new file mode 100644 index 0000000000..8ce73e5e32 --- /dev/null +++ b/files/fr/web/css/gap/index.html @@ -0,0 +1,228 @@ +--- +title: gap (grid-gap) +slug: Web/CSS/gap +tags: + - CSS + - Propriété + - Propriété raccourcie + - Reference +translation_of: Web/CSS/gap +--- +<div>{{CSSRef}}</div> + +<p>La propriété <strong><code>gap</code></strong> est <a href="/fr/docs/Web/CSS/Propriétés_raccourcies">une propriété raccourcie</a> pour {{cssxref("row-gap")}} et {{cssxref("column-gap")}} qui permet de définir les espaces entre les lignes et entre les colonnes d'une grille.</p> + +<div>{{EmbedInteractiveExample("pages/css/gap.html")}}</div> + +<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> + +<div class="note"> +<p><strong>Note :</strong> La propriété {{cssxref("grid-gap")}} a initialement été définie dans le module de spécification <a href="/fr/docs/Web/CSS/CSS_Grid_Layout">CSS Grid Layout</a>. Cette version préfixée a été remplacée par <code>gap</code>. Toutefois, à des fins de compatibilité envers les navigateurs qui n'implémentent pas encore la version non-préfixée, mieux vaut utiliser les deux versions.</p> +</div> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="brush: css no-line-numbers notranslate">/* Une valeur de longueur */ +/* Type <length> */ +gap: 20px; +gap: 1em; +gap: 3vmin; +gap: 0.5cm; + +/* Une valeur proportionnelle */ +/* Type <percentage> */ +gap: 16%; +gap: 100%; + +/* Deux valeurs de longueur */ +gap: 20px 10px; +gap: 1em 0.5em; +gap: 3vmin 2vmax; +gap: 0.5cm 2mm; + +/* Une ou deux valeurs proportionnelles */ +/* Type <percentage> */ +gap: 16% 100%; +gap: 21px 82%; + +/* Valeurs calc() */ +gap: calc(10% + 20px); +gap: calc(20px + 10%) calc(10% - 5px); + +/* Valeurs globales */ +gap: inherit; +gap: initial; +gap: unset; +</pre> + +<p>Cette propriété est définie avec une valeur <code><'row-gap'></code>, éventuellement suivi d'une valeur <code><'column-gap'></code>. Si <code><'column-gap'></code> n'est pas utilisée, la valeur utilisée sera la même que <code><'row-gap'></code>.</p> + +<p><code><'row-gap'></code> et <code><'column-gap'></code> sont des valeurs de type <code><length></code> ou <code><percentage></code>.</p> + +<h3 id="Valeurs">Valeurs</h3> + +<dl> + <dt><code><length></code></dt> + <dd>La largeur de l'espace entre les lignes et/ou entre les colonnes (cf. {{cssxref("<length>")}} pour les valeurs utilisables).</dd> + <dt><code><percentage></code></dt> + <dd>La largeur de l'espace entre les lignes et/ou entre les colonnes en fonction de la taille de l'élément englobant (cf. {{cssxref("<percentage>")}} pour les valeurs utilisables).</dd> +</dl> + +<h3 id="Syntaxe_formelle">Syntaxe formelle</h3> + +<pre class="syntaxbox notranslate">{{csssyntax}}</pre> + +<h2 id="Exemples">Exemples</h2> + +<h3 id="Disposition_flexible">Disposition flexible</h3> + +<p>{{SeeCompatTable}}</p> + +<h4 id="HTML">HTML</h4> + +<pre class="brush: html; notranslate"><div id="flexbox"> + <div></div> + <div></div> + <div></div> + <div></div> + <div></div> + <div></div> +</div> +</pre> + +<h4 id="CSS">CSS</h4> + +<pre class="brush: css; highlight[5] notranslate">#flexbox { + display: flex; + flex-wrap: wrap; + width: 300px; + gap: 20px 5px; +} + +#flexbox > div { + border: 1px solid green; + background-color: lime; + flex: 1 1 auto; + width: 100px; + height: 50px; + +} +</pre> + +<h4 id="Résultat">Résultat</h4> + +<p>{{EmbedLiveSample("Disposition_flexible", "auto", "120px")}}</p> + +<h3 id="Grilles_CSS">Grilles CSS</h3> + +<h4 id="HTML_2">HTML</h4> + +<pre class="brush: html; notranslate"><div id="grid"> + <div></div> + <div></div> + <div></div> + <div></div> + <div></div> + <div></div> + <div></div> + <div></div> + <div></div> +</div></pre> + +<h4 id="CSS_2">CSS</h4> + +<div class="hidden"> +<pre class="brush: css notranslate">#grid { + grid-gap: 20px 5px; +} +</pre> +</div> + +<pre class="brush: css; highlight[5] notranslate">#grid { + display: grid; + height: 200px; + grid-template: repeat(3, 1fr) / repeat(3, 1fr); + gap: 20px 5px; +} + +#grid > div { + border: 1px solid green; + background-color: lime; +} +</pre> + +<h4 id="Résultat_2">Résultat</h4> + +<p>{{EmbedLiveSample("Grilles_CSS", "auto", "120px")}}</p> + +<h3 id="Multi-colonnes">Multi-colonnes</h3> + +<h4 id="HTML_3">HTML</h4> + +<pre class="brush: html; notranslate"><p class="content-box"> + voici un texte en multi-colonne sur des colonnes avec + une gouttière de 40 pixels créée grâce à la propriété + CSS <code>gap</code>. Est-ce que c'est pas trop génial ? +</p> +</pre> + +<h4 id="CSS_3">CSS</h4> + +<pre class="brush: css; highlight[3] notranslate">.content-box { + column-count: 3; + gap: 40px; +} +</pre> + +<h4 id="Résultat_3">Résultat</h4> + +<p>{{EmbedLiveSample("Multi-column_layout", "auto", "120px")}}</p> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">État</th> + <th scope="col">Commentaires</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName("CSS3 Box Alignment", "#propdef-gap", "gap")}}</td> + <td>{{Spec2("CSS3 Box Alignment")}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<p>{{cssinfo}}</p> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div> + +<h3 id="Prise_en_charge_pour_les_dispositions_flexibles">Prise en charge pour les dispositions flexibles</h3> + +<p>{{Compat("css.properties.gap.flex_context")}}</p> + +<h3 id="Prise_en_charge_pour_les_grilles_CSS">Prise en charge pour les grilles CSS</h3> + +<p>{{Compat("css.properties.gap.grid_context")}}</p> + +<h3 id="Prise_en_charge_pour_les_dispositions_multi-colonnes">Prise en charge pour les dispositions multi-colonnes</h3> + +<p>{{Compat("css.properties.gap.multicol_context")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>Les versions standards, sans préfixe, des propriétés associées : + <ul> + <li>{{cssxref("row-gap")}},</li> + <li>{{cssxref("column-gap")}},</li> + </ul> + </li> + <li><a href="/fr/docs/Web/CSS/CSS_Grid_Layout/Les_concepts_de_base#Les_gouttières">Guide : les concepts de base : les gouttières</a></li> +</ul> |