diff options
Diffstat (limited to 'files/fr/web/html/element/tr/index.html')
| -rw-r--r-- | files/fr/web/html/element/tr/index.html | 422 |
1 files changed, 422 insertions, 0 deletions
diff --git a/files/fr/web/html/element/tr/index.html b/files/fr/web/html/element/tr/index.html new file mode 100644 index 0000000000..792b419746 --- /dev/null +++ b/files/fr/web/html/element/tr/index.html @@ -0,0 +1,422 @@ +--- +title: '<tr> : l''élément de ligne d''un tableau' +slug: Web/HTML/Element/tr +tags: + - Element + - HTML + - Reference + - Tableaux + - Web +translation_of: Web/HTML/Element/tr +--- +<div>{{HTMLRef}}</div> + +<p>L'élément HTML <strong><code><tr></code></strong> définit une ligne de cellules dans un tableau. Une ligne peut être constituée d'éléments {{HTMLElement("td")}} (les données des cellules) et {{HTMLElement("th")}} (les cellules d'en-têtes).</p> + +<div>{{EmbedInteractiveExample("pages/tabbed/tr.html","tabbed-taller")}}</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> + +<p>Si on veut qu'une cellule s'étende sur plusieurs lignes/colonnes, on pourra utiliser l'attribut {{htmlattrxref("colspan", "td")}} ou {{htmlattrxref("rowspan", "td")}} qui indiquent respectivement le nombre de colonnes / lignes sur lequel s'étendre (la valeur par défaut étant 1).</p> + +<p>La construction de tableau peut parfois demander un peu de pratique. Au-delà des exemples présentés ci-après, vous pouvez consulter <a href="/fr/docs/Apprendre/HTML/Tableaux">les tutoriels sur les tableaux HTML</a> afin d'apprendre comment utiliser ces éléments et attributs HTML afin d'organiser vos données tabulaires.</p> + +<h2 id="Attributs">Attributs</h2> + +<p>À l'instar de tous les éléments HTML, cet élément inclut <a href="/fr/docs/Web/HTML/Attributs_universels">les attributs universels</a>.</p> + +<h3 id="Attributs_dépréciés_ou_obsolètes">Attributs dépréciés ou obsolètes</h3> + +<dl> + <dt>{{htmlattrdef("align")}}{{Obsolete_Inline("HTML5")}}</dt> + <dd>Cet attribut à valeurs définit l'alignement horizontal pour le contenu de chaque cellule. Les valeurs possibles sont : + <ul> + <li><code>left </code>: le contenu de la cellule est aligné à gauche de la cellule</li> + <li><code>center</code> : le contenu de la cellule est centré horizontalement</li> + <li><code>right</code> : le contenu de la cellule est aligné à droite de la cellule</li> + <li><code>justify</code> : insert des espaces dans le contenu textuel afin que le contenu de la cellule soit justifié</li> + <li><code>char</code> : aligne le contenu textuel de la cellule selon un caractère spécial avec un décalage minimum défini par les attributs {{htmlattrxref("char", "tr")}} et {{htmlattrxref("charoff", "tr")}} {{unimplemented_inline(2212)}}.</li> + </ul> + + <p>Si cet attribut n'est pas renseigné, la valeur est héritée du nœud parent.</p> + + <div class="note"><strong>Notes : </strong>Cet attribut est devenu obsolète dans le dernier standard et ne doit donc plus être utilisé. + + <ul> + <li>Pour réaliser les mêmes effets que les valeurs <code>left</code>, <code>center</code>, <code>right</code> ou <code>justify</code>, il faut utiliser la propriété CSS {{cssxref("text-align")}} sur l'élément</li> + <li>Pour réaliser le même effet qu'avec la valeur <code>char</code>. Il est possible, en CSS3, d'utiliser la valeur de l'attribut {{htmlattrxref("char", "tr")}} comme valeur de la propriété {{cssxref("text-align")}}. {{unimplemented_inline}}.</li> + </ul> + </div> + </dd> +</dl> + +<dl> + <dt>{{htmlattrdef("bgcolor")}} {{Obsolete_Inline("HTML5")}}</dt> + <dd>Cet attribut définit la couleur d'arrière-plan de toutes les cellules de la colonne. C'est un code à 6 chiffres hexadécimaux comme défini par le <a class="external" href="https://www.w3.org/Graphics/Color/sRGB">sRGB</a>. Il est précédé d'un '#'. Un de ces seize mot-clé peut également être utilisé. + <table style="width: 80%;"> + <tbody> + <tr> + <td style="background-color: black; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>black</code> = "#000000"</td> + <td style="background-color: green; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>green</code> = "#008000"</td> + </tr> + <tr> + <td style="background-color: silver; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>silver</code> = "#C0C0C0"</td> + <td style="background-color: lime; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>lime</code> = "#00FF00"</td> + </tr> + <tr> + <td style="background-color: gray; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>gray</code> = "#808080"</td> + <td style="background-color: olive; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>olive</code> = "#808000"</td> + </tr> + <tr> + <td style="background-color: white; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>white</code> = "#FFFFFF"</td> + <td style="background-color: yellow; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>yellow</code> = "#FFFF00"</td> + </tr> + <tr> + <td style="background-color: maroon; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>maroon</code> = "#800000"</td> + <td style="background-color: navy; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>navy</code> = "#000080"</td> + </tr> + <tr> + <td style="background-color: red; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>red</code> = "#FF0000"</td> + <td style="background-color: blue; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>blue</code> = "#0000FF"</td> + </tr> + <tr> + <td style="background-color: purple; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>purple</code> = "#800080"</td> + <td style="background-color: teal; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>teal</code> = "#008080"</td> + </tr> + <tr> + <td style="background-color: fuchsia; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td><code>fuchsia</code> = "#FF00FF"</td> + <td style="background-color: aqua; width: 24px; height: 24px; border-width: 1px; border-color: black; border-style: solid;"></td> + <td> + <p><code>aqua</code> = "#00FFFF"</p> + </td> + </tr> + </tbody> + </table> + + <div class="note"><strong>Note d'utilisation : </strong>Il est fortement conseillé de ne pas utiliser cet attribut car celui-ci n'est pas un attribut standard et n'a été implémentée que sous certaines versions d'Internet Explorer. L'élément {{HTMLElement("tr")}} doit être mis en forme grâce au <a href="/fr/docs/CSS">CSS</a>. Pour fournir un effet semblable à celui achevé par l'attribut <code><strong>bgcolor</strong></code>, il est possible d'utiliser la propriété CSS {{cssxref("background-color")}}.</div> + </dd> +</dl> + +<dl> + <dt>{{htmlattrdef("char")}}{{Obsolete_Inline("HTML5")}}</dt> + <dd>Cet attribut est utilisé pour définir le caractère sur lequel aligner les cellules d'une colonne. Les valeurs de cet attribut contiennent généralement un point (.) pour aligner des nombres ou des valeurs monétaires. Si l'attribut {{htmlattrxref("align", "tr")}} ne vaut pas <code>char</code>, l'attribut est ignoré.</dd> + <dd> + <div class="note"><strong>Note d'utilisation : </strong>Cet attribut est obsolète et il est donc fortement déconseillé de l'utiliser. De fait, il n'est pas supporté par le dernier standard. Pour réaliser le même effet qu'avec {{htmlattrxref("char", "tr")}}, il faut utiliser CSS3 en attribuant la même valeur à la propriété {{cssxref("text-align")}}.{{unimplemented_inline}}.</div> + </dd> +</dl> + +<dl> + <dt>{{htmlattrdef("charoff")}} {{Obsolete_Inline("HTML5")}}</dt> + <dd>Cet attribut est utilisé pour indiquer le décalage, en nombre de caractères, depuis le caractère défini par l'attribut<strong> char</strong> à appliquer au contenu des cellules. + <div class="note"><strong>Note d'utilisation: </strong>Cet attribut ne doit plus être utilisé car il est maintenant obsolète et n'est plus supporté dans le dernier standard.</div> + </dd> +</dl> + +<dl> + <dt>{{htmlattrdef("valign")}} {{Obsolete_Inline("HTML5")}}</dt> + <dd>Cet attribut définit l'alignement vertical du texte des cellules de la ligne. Les valeurs possibles de cet attribut sont : + <ul> + <li><code>baseline</code> qui alignera le texte à la ligne la plus basse possible en utilisant la <a class="external" href="https://fr.wikipedia.org/wiki/Ligne_de_base_%28typographie%29">ligne de base</a> des caractères. Si les caractères ont tous la même taille, cela aura le même effet que la valeur <code>bottom</code>.</li> + <li><code>bottom</code> qui placera le texte au plus bas de la cellule</li> + <li><code>middle</code> qui centrera verticalement le texte dans la cellule</li> + <li><code>top</code> qui placera le texte au plus haut de la cellule.</li> + </ul> + + <div class="note"><strong>Note: </strong>Cet attribut est obsolète dans le dernier standard, la propriété CSS {{cssxref("vertical-align")}} doit être utilisée à la place.</div> + </dd> +</dl> + +<h2 id="Exemples">Exemples</h2> + +<h3 id="Exemple_simple">Exemple simple</h3> + +<h4 id="HTML">HTML</h4> + +<pre class="brush: html"><table> + <tr> + <th>Prénom</th><th>Nom</th> + </tr> + <tr> + <td>Jean</td> <td>Biche</td> + </tr> + <tr> + <td>Marcel</td> <td>Patulacci</td> + </tr> +</table></pre> + +<h4 id="Résultat">Résultat</h4> + +<p>{{EmbedLiveSample("Exemple_simple","100%","200")}}</p> + +<div class="note"> +<p><strong>Note :</strong> Pour plus d'exemples, voir la page {{HTMLElement("table")}}.</p> +</div> + +<h3 id="Étendre_sur_plusieurs_lignes_ou_colonnes">Étendre sur plusieurs lignes ou colonnes</h3> + +<p>On utilise ici les attributs <code>rowspan</code> et <code>colspan</code> pour étendre des cellules sur plusieurs lignes et colonnes.</p> + +<h4 id="HTML_2">HTML</h4> + +<pre class="brush: html"><table> + <tr> + <th rowspan="2">Nom</th> + <th rowspan="2">ID</th> + <th colspan="2">Dates</th> + <th rowspan="2">Solde</th> + </tr> + <tr> + <th>Inscription</th> + <th>Résiliation</th> + </tr> + <tr> + <th>Margaret Nguyen</td> + <td>427311</td> + <td><time datetime="2010-06-03">3 juin 2010</time></td> + <td>n/a</td> + <td>0</td> + </tr> + <tr> + <th>Edvard Galinski</td> + <td>533175</td> + <td><time datetime="2011-01013">13 janvier 2011</time></td> + <td><time datetime="2017-04008">8 avril 2017</time></td> + <td>37</td> + </tr> + <tr> + <th>Hoshi Nakamura</td> + <td>601942</td> + <td><time datetime="2012-07-23">23 juillet 2012</time></td> + <td>n/a</td> + <td>15</td> + </tr> +</table></pre> + +<h4 id="CSS">CSS</h4> + +<pre class="brush: css">table { + border: 1px solid black; +} + +th, td { + border: 1px solid black; +}</pre> + +<h4 id="Résultat_2">Résultat</h4> + +<p>{{EmbedLiveSample("Étendre_sur_plusieurs_lignes_ou_colonnes")}}</p> + +<h3 id="Distinguer_en-tête_et_contenu">Distinguer en-tête et contenu</h3> + +<p>On utilise ici l'élément {{HTMLElement("thead")}} et l'élément {{HTMLElement("tbody")}} pour distinguer l'en-tête du tableau et le contenu de celui-ci.</p> + +<h4 id="HTML_3">HTML</h4> + +<pre class="brush: html"><table> + <thead> + <tr> + <th rowspan="2">Nom</th> + <th rowspan="2">Identifiant</th> + <th colspan="2">Dates</th> + <th rowspan="2">Solde</th> + </tr> + <tr> + <th>Inscription</th> + <th>Résiliation</th> + </tr> + </thead> + <tbody> + <tr> + <th scope="row">Margaret Nguyen</td> + <td>427311</td> + <td><time datetime="2010-06-03">3 juin 2010</time></td> + <td>n/a</td> + <td>0</td> + </tr> + <tr> + <th scope="row">Edvard Galinski</td> + <td>533175</td> + <td><time datetime="2011-01013">13 janvier 2011</time></td> + <td><time datetime="2017-04008">8 avril 2017</time></td> + <td>37</td> + </tr> + <tr> + <th scope="row">Hoshi Nakamura</td> + <td>601942</td> + <td><time datetime="2012-07-23">23 juillet 2012</time></td> + <td>n/a</td> + <td>15</td> + </tr> + </tbody> +</table></pre> + +<h4 id="CSS_2">CSS</h4> + +<pre class="brush: css">table { + border: 1px solid black; +} + +th, td { + border: 1px solid black; +}</pre> + +<h4 id="Résultat_3">Résultat</h4> + +<p>{{EmbedLiveSample("Distinguer_en-tête_et_contenu", 500, 150)}}</p> + +<h3 id="Mise_en_forme_simple">Mise en forme simple</h3> + +<p>Il est possible d'utiliser <a href="/fr/docs/Web/CSS/">CSS</a> afin de modifier l'apparence d'une ligne d'un tableau. Tous les styles appliqués à un élément <code><tr></code> auront un impact sur les cellules de cette ligne (sauf si celles-ci indiquent un style par dessus).</p> + +<p>Modifions ici la police et la couleur d'arrière-plan pour la ligne d'en-tête.</p> + +<h4 id="HTML_4">HTML</h4> + +<pre class="brush: html"><table> + <thead> + <tr> + <th rowspan="2">Nom</th> + <th rowspan="2">ID</th> + <th colspan="2">Dates</th> + <th rowspan="2">Solde</th> + </tr> + <tr> + <th>Inscription</th> + <th>Résiliation</th> + </tr> + </thead> + <tbody> + <tr> + <th scope="row">Margaret Nguyen</td> + <td>427311</td> + <td><time datetime="2010-06-03">3 juin 2010</time></td> + <td>n/a</td> + <td>0</td> + </tr> + <tr> + <th scope="row">Edvard Galinski</td> + <td>533175</td> + <td><time datetime="2011-01013">13 janvier 2011</time></td> + <td><time datetime="2017-04008">8 avril 2017</time></td> + <td>37</td> + </tr> + <tr> + <th scope="row">Hoshi Nakamura</td> + <td>601942</td> + <td><time datetime="2012-07-23">23 juillet 2012</time></td> + <td>n/a</td> + <td>15</td> + </tr> + </tbody> +</table></pre> + +<h4 id="CSS_3">CSS</h4> + +<pre class="brush: css">table { + border: 1px solid black; + font: 16px "Open Sans", Helvetica, Arial, sans-serif; +} + +thead > tr { + background-color: rgb(228, 240, 245); +} + +th, td { + border: 1px solid black; + padding:4px 6px; +} +</pre> + +<p>On utilise ici la propriété {{CSSxRef("font")}} sur l'élément {{HTMLElement("table")}} afin d'avoir une police plus agréable. Ensuite, pour tous les éléments <code><tr></code> qui sont les fils de {{HTMLElement("thead")}} (c'est-à-dire pour les lignes de l'en-tête), on indique une couleur d'arrière-plan bleu clair. Cela se propagera à l'ensemble des cellules de l'en-tête.</p> + +<h4 id="Résultat_4">Résultat</h4> + +<p>{{EmbedLiveSample("Mise_en_forme_simple", 500, 200)}}</p> + +<h2 id="Résumé_technique">Résumé technique</h2> + +<table class="properties"> + <tbody> + <tr> + <th scope="row"><a href="/fr/docs/Web/HTML/Catégorie_de_contenu">Catégories de contenu</a></th> + <td>Aucune.</td> + </tr> + <tr> + <th scope="row">Contenu autorisé</th> + <td>Zéro ou plusieurs éléments {{HTMLElement("td")}} ou {{HTMLElement("th")}}, éventuellement mélangés. Les éléments de script ({{HTMLElement("script")}} et {{HTMLElement("template")}}) sont également utilisés.</td> + </tr> + <tr> + <th scope="row">Omission de balises</th> + <td>La balise de début est obligatoire. La balise de fin peut être absente si l'élément {{HTMLElement("tr")}} est immédiatement suivi par un élément {{HTMLElement("tr")}} ou si l'élément du groupe parent (({{HTMLElement("thead")}}, {{HTMLElement("tbody")}} ou {{HTMLElement("tfoot")}}) n'a plus d'autre contenu.</td> + </tr> + <tr> + <th scope="row">Parents autorisés</th> + <td>Un élément {{HTMLElement("table")}} (uniquement si le tableau ne possède pas d'élément {{HTMLElement("body")}} et uniquement après un élément {{HTMLElement("caption")}}, {{HTMLElement("colgroup")}} ou {{HTMLElement("thead")}}) , {{HTMLElement("thead")}}, {{HTMLElement("tbody")}} ou {{HTMLElement("tfoot")}}.</td> + </tr> + <tr> + <th scope="row">Rôles ARIA autorisés</th> + <td>Tous les rôles sont autorisés.</td> + </tr> + <tr> + <th scope="row">Interface DOM</th> + <td>{{domxref("HTMLTableRowElement")}}</td> + </tr> + </tbody> +</table> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Spécification</th> + <th scope="col">État</th> + <th scope="col">Commentaires</th> + </tr> + </tbody> + <tbody> + <tr> + <td>{{SpecName('HTML WHATWG','tables.html#the-tr-element','tr element')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName('HTML5 W3C','tabular-data.html#the-tr-element','tr element')}}</td> + <td>{{Spec2('HTML5 W3C')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une<em>pull request</em>.</div> + +<p>{{Compat("html.elements.tr")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>Les autres éléments HTML relatifs aux tableaux : {{HTMLElement("caption")}}, {{HTMLElement("col")}}, {{HTMLElement("colgroup")}}, {{HTMLElement("table")}}, {{HTMLElement("tbody")}}, {{HTMLElement("td")}}, {{HTMLElement("tfoot")}}, {{HTMLElement("th")}}, {{HTMLElement("thead")}}.</li> + <li>Les propriétés et pseudo-classes CSS qui sont particulièrement utiles pour mettre en forme l'élément <code><tr></code> : + <ul> + <li>La pseudo-classe {{cssxref(":nth-child")}} qui permet de définir l'alignement des cellules dans la colonne ou sur une ligne</li> + <li>La propriété {{cssxref("text-align")}} qui permet d'aligner l'ensemble des cellules par rapport au même caractère (comme le point ou la virgule).</li> + </ul> + </li> +</ul> |