diff options
Diffstat (limited to 'files/fr/web/css/grid-column/index.md')
| -rw-r--r-- | files/fr/web/css/grid-column/index.md | 163 |
1 files changed, 163 insertions, 0 deletions
diff --git a/files/fr/web/css/grid-column/index.md b/files/fr/web/css/grid-column/index.md new file mode 100644 index 0000000000..f66d2c735d --- /dev/null +++ b/files/fr/web/css/grid-column/index.md @@ -0,0 +1,163 @@ +--- +title: grid-column +slug: Web/CSS/grid-column +tags: + - CSS + - Propriété + - Reference +translation_of: Web/CSS/grid-column +--- +<div>{{CSSRef}}</div> + +<p>La propriété <strong><code>grid-column</code></strong> est une <a href="/fr/docs/Web/CSS/Propri%C3%A9t%C3%A9s_raccourcies">propriété raccourcie</a> pour {{cssxref("grid-column-start")}} et {{cssxref("grid-column-end")}}. Elle permet de définir la taille et l'emplacement d'un élément sur la grille en indiquant l'emplacement du début, de la fin et/ou sa taille.</p> + +<div>{{EmbedInteractiveExample("pages/css/grid-column.html")}}</div> + +<p>Si deux valeurs <code><strong><grid-line></strong></code> sont utilisées pour la propriété, la valeur de <strong><code>grid-column-start</code></strong> sera définie avec la première valeur avant la barre oblique et la valeur de <strong><code>grid-column-end</code></strong> sera définie avec celle qui est située après la barre oblique.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="brush: css no-line-numbers">/* Valeurs avec un mot-clé */ +grid-column: auto; +grid-column: auto / auto; + +/* Valeurs <custom-ident> */ +grid-column: unezonedegrille; +grid-column: unezonedegrille / unezonedegrille; + +/* Valeurs <integer> + <custom-ident> */ +grid-column: unezonedegrille 4; +grid-column: 4 unezonedegrille / 6; + +/* Valeurs span + <integer> + <custom-ident> */ +grid-column: span 3; +grid-column: span unezonedegrille; +grid-column: 5 unezonedegrille span; +grid-column: span 3 / 6; +grid-column: span unezonedegrille / span unezonedegrille; +grid-column: 5 unezonedegrille span / 2 span; + +/* Valeurs globales */ +grid-column: inherit; +grid-column: initial; +grid-column: unset; +</pre> + +<p>Cette propriété est définie grâce à une ou deux valeurs <code><grid-line></code>. Si deux valeurs <code><grid-line></code> sont fournies, elles doivent être séparées par une barre oblique (/)</p> + +<p>Une valeur <code><grid-line></code> peut être définie avec :</p> + +<ul> + <li>le mot-clé <code>auto</code></li> + <li>ou une valeur <code><custom-ident></code></li> + <li>ou une valeur <code><integer></code></li> + <li>ou une valeur <code><custom-ident></code> et un <code><integer></code> séparés par un espace</li> + <li>ou le mot-clé <code>span</code> avec une valeur <code><custom-ident></code> ou un <code><integer></code> ou les deux.</li> +</ul> + +<h3 id="Valeurs">Valeurs</h3> + +<dl> + <dt><code>auto</code></dt> + <dd>Un mot-clé qui indique que la propriété ne contribue pas au placement de l'élément sur la grille. Cela indique un placement automatique, une taille de fragment (<em>span</em>) automatique ou une taille par défaut de <code>1</code>.</dd> + <dt><code><custom-ident></code></dt> + <dd>S'il existe une ligne nommée avec '<custom-ident>-start'/'<custom-ident>-end', la première colonne correspondante contribue au placement de l'élément sur la grille. + <div class="note"><p><strong>Note :</strong> Les noms des zones de grille sont générés implicitement. Ainsi, en utilisant <code>grid-column-start: foo;</code> cela sélectionnera le début de la grille nommée correspondante (sauf si une autre colonne <code>foo-start</code>/<code>foo-end</code> a été explicitement déclarée).</p></div> + + <p>Sinon, la valeur est traitée comme si on avait utilisé <code><custom-ident></code> et la valeur <code>1</code>.</p> + </dd> + <dt><code><integer> && <custom-ident>?</code></dt> + <dd>La n-ième ligne de la grille contribue au placement de l'élément sur la grille. Si un entier négatif est utilisé, le comptage sera fait depuis la fin de la grille explicite. + <p>Si un nom est fourni pour <custom-ident>, seules les lignes ayant ce nom seront comptées. S'il n'y a pas suffisamment de lignes existant avec ce nom, toutes les lignes implicites seront comptées afin de trouver la position.</p> + + <p>Si la valeur entière utilisée est <code>0</code>, la règle est invalide.</p> + </dd> + <dt><code>span && [ <integer> || <custom-ident> ]</code></dt> + <dd>Un fragment de grille est utilisé pour le placement de l'élément sur la grille afin que le début de la ligne pour l'élément de la grille soit placé à n lignes du bord de fin. + <p>Si un nom fourni pour <custom-ident>, seules les lignes ayant ce nom seront comptées. S'il n'y a pas suffisamment de lignes existantes avec ce nom, tout les lignes implicites du côté de la grille explicite et qui correspondent à la direction de la recherche seront comptées afin de placer ce fragment.</p> + + <p>Si l'entier n'est pas défini, la valeur par défaut qui sera utilisée sera <code>1</code>. Les entiers négatifs ou nuls sont invalides.</p> + </dd> +</dl> + +<h3 id="Syntaxe_formelle">Syntaxe formelle</h3> + +{{csssyntax}} + +<h2 id="Exemples">Exemples</h2> + +<h3 id="CSS">CSS</h3> + +<pre class="brush: css">#grid { + display: grid; + height: 100px; + grid-template-columns: repeat(6, 1fr); + grid-template-rows: 100px; +} + +#item1 { + background-color: lime; +} + +#item2 { + background-color: yellow; + grid-column: 2 / 4; +} + +#item3 { + background-color: blue; + grid-column: span 2 / 7; +}</pre> + +<h3 id="HTML">HTML</h3> + +<pre class="brush: html"><div id="grid"> + <div id="item1"></div> + <div id="item2"></div> + <div id="item3"></div> +</div></pre> + +<h3 id="Résultat">Résultat</h3> + +<p>{{EmbedLiveSample("Exemples", "100%", "100px")}}</p> + +<h2 id="Prothèse_d'émulation_(polyfill)">Prothèse d'émulation (<em>polyfill</em>)</h2> + +<p>IE11 ne prend pas en charge le placement automatique des objets sur la grille.Tous les objets finiront sur la première colonne / ligne si ceux-ci ne sont pas marqués avec les propriétés <code>-ms-</code>{{cssxref("grid-column")}} et <code>-ms-</code>{{cssxref("grid-row")}}. Pour effectuer cette annotation automatiquement, on peut utiliser du JavaScript (cf. <a href="https://github.com/motine/css_grid_annotator">ce dépôt</a>).</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 Grid", "#propdef-grid-column", "grid-column")}}</td> + <td>{{Spec2("CSS3 Grid")}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<p>{{cssinfo}}</p> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<p>{{Compat("css.properties.grid-column")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{cssxref("grid-row")}}</li> + <li>{{cssxref("grid-row-start")}}</li> + <li>{{cssxref("grid-row-end")}}</li> + <li>{{cssxref("grid-column-start")}}</li> + <li>{{cssxref("grid-column-end")}}</li> + <li><a href="/fr/docs/Web/CSS/CSS_Grid_Layout/Line-based_Placement_with_CSS_Grid">Guide : le placement sur les lignes d'une grille CSS</a></li> + <li>Tutoriel vidéo : <a href="https://gridbyexample.com/video/series-line-based-placement/">le placement sur les lignes (en anglais)</a></li> +</ul> |