aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/html/element/dl/index.html
diff options
context:
space:
mode:
authortristantheb <tristantheb@users.noreply.github.com>2021-06-19 10:25:05 +0200
committerGitHub <noreply@github.com>2021-06-19 10:25:05 +0200
commita47584de1bd47788cb5aa6178fa88b31977b2a8e (patch)
tree1c153a5dd0e939a3ef819df87d6b988da950352f /files/fr/web/html/element/dl/index.html
parent1b0940218952a8132ceb9e4b56792ad47e94d552 (diff)
downloadtranslated-content-a47584de1bd47788cb5aa6178fa88b31977b2a8e.tar.gz
translated-content-a47584de1bd47788cb5aa6178fa88b31977b2a8e.tar.bz2
translated-content-a47584de1bd47788cb5aa6178fa88b31977b2a8e.zip
UPDATE: Update translation of the HTML elements — 🛠 Priority work area (#500)
* UPDATE: Updating pages starting with A * FIX: Update missing KS to html anchor * Review HTML Element a * Review HTML Element abbr * Review HTML Element acronym * Review HTML Element address * Review HTML Element applet * Review HTML Element area * Review HTML Element article * Review HTML Element aside * Review HTML Element audio * UPDATE: Updating pages wtarting with B * Review HTML Element b * Review HTML Element base * Review HTML Element basefont * Review HTML Element bdi * Review HTML Element bdo * Review HTML Element big * Review HTML Element blink * Review HTML Element blockquote * Review HTML Element body * Review HTML Element br * Review HTML Element button * Review HTML Element button - rm HTMLRef * Review HTML Element button - lint link * UPDATE: Updating pages starting with C * UPDATE: Updating pages starting with D * UPDATE: Refresh the reference page * UPDATE: Updating pages starting with E * Review HTML Element canvas * Review HTML Element caption * Review HTML Element center * Review HTML Element cite * UPDATE: Updating pages starting with F * BCD: Update all updated pages with new BCD format * FIX: add missing bracket * Review - HTML element - code * Review - HTML Element - col * Review - HTML Element - colgroup * Review - HTML Element - content * Review - HTML Element - data * Review - HTML Element - datalist * Review - HTML Element - dd * Review - HTML Element - del * Review - HTML Element * Review - HTML Element - dfn * Review - HTML Element - dialog * Review - HTML element - dir * Review - HTML Element div * Review - HTML Element - dl * Review - HTML Element - dt * Review - HTML Element - em * Review - HTML Element - embed * Review - HTML Element - fieldset * Review - HTML Element - figcaption * Review - HTML Element - figure * Review - HTML Element - font * Review - HTML Element - footer * Review - HTML Element - form * Review - HTML Element - frame * Review - HTML Element - frameset * Review updates since PR start - A * Review updates since PR start - B * Review updates since PR start - C * Review updates since PR start - D * Review updates since PR start - F Co-authored-by: julieng <julien.gattelier@gmail.com>
Diffstat (limited to 'files/fr/web/html/element/dl/index.html')
-rw-r--r--files/fr/web/html/element/dl/index.html224
1 files changed, 108 insertions, 116 deletions
diff --git a/files/fr/web/html/element/dl/index.html b/files/fr/web/html/element/dl/index.html
index 44c315b040..963cb4a33b 100644
--- a/files/fr/web/html/element/dl/index.html
+++ b/files/fr/web/html/element/dl/index.html
@@ -2,29 +2,68 @@
title: '<dl> : l''élément de liste de descriptions'
slug: Web/HTML/Element/dl
tags:
+ - Definition List
+ - Description list
- Element
- HTML
+ - HTML grouping content
+ - HTML:Flow content
+ - HTML:Palpable Content
- Reference
- Web
translation_of: Web/HTML/Element/dl
+browser-compat: html.elements.dl
---
<div>{{HTMLRef}}</div>
-<p>L'élément HTML <strong><code>&lt;dl&gt;</code></strong> représente une liste de descriptions sous la forme d'une liste de paires associant des termes (fournis par des éléments {{HTMLElement("dt")}}) et leurs descriptions ou définitions (fournies par des éléments {{HTMLElement("dd")}}). On utilisera par exemple cet élément pour implémenter un glossaire.</p>
+<p>L'élément HTML <strong><code>&lt;dl&gt;</code></strong> représente une liste de descriptions sous la forme d'une liste de paires associant des termes (fournis par des éléments <a href="/fr/docs/Web/HTML/Element/dt"><code>&lt;dt&gt;</code></a>) et leurs descriptions ou définitions (fournies par des éléments <a href="/fr/docs/Web/HTML/Element/dd"><code>&lt;dd&gt;</code></a>). On utilisera par exemple cet élément pour implémenter un glossaire.</p>
<div>{{EmbedInteractiveExample("pages/tabbed/dl.html", "tabbed-standard")}}</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>
-
-<h2 id="Attributs">Attributs</h2>
+<table class="properties">
+ <tbody>
+ <tr>
+ <th scope="row"><a href="/fr/docs/Web/Guide/HTML/Content_categories">Catégories de contenu</a></th>
+ <td><a href="/fr/docs/Web/Guide/HTML/Content_categories#flow_content">Contenu de flux</a> et, si les éléments enfants de <code>&lt;dl&gt;</code> incluent une paire avec un nom et une valeur, du <a href="/fr/docs/Web/Guide/HTML/Content_categories#palpable_content">contenu tangible</a>.</td>
+ </tr>
+ <tr>
+ <th scope="row">Contenu autorisé</th>
+ <td>
+ <p>Zéro ou plusieurs groupes composés d'un ou plusieurs éléments <a href="/fr/docs/Web/HTML/Element/dt"><code>&lt;dt&gt;</code></a>, chacun suivi par un ou plusieurs éléments <a href="/fr/docs/Web/HTML/Element/dd"><code>&lt;dd&gt;</code></a> entre lesquels on pourra éventuellement avoir des éléments <a href="/fr/docs/Web/HTML/Element/script"><code>&lt;script&gt;</code></a> et <a href="/fr/docs/Web/HTML/Element/template"><code>&lt;template&gt;</code></a>.</p>
+
+ <p>Selon le WHATWG : un ou plusieurs éléments <a href="/fr/docs/Web/HTML/Element/div"><code>&lt;div&gt;</code></a> éventuellement entrecoupés d'éléments <a href="/fr/docs/Web/HTML/Element/script"><code>&lt;script&gt;</code></a> ou <a href="/fr/docs/Web/HTML/Element/template"><code>&lt;template&gt;</code></a>.</p>
+ </td>
+ </tr>
+ <tr>
+ <th scope="row">Omission de balises</th>
+ <td>Aucune, la balise d'ouverture et la balise de fermeture sont obligatoires.</td>
+ </tr>
+ <tr>
+ <th scope="row">Parents autorisés</th>
+ <td>Tout élément acceptant du <a href="/fr/docs/Web/Guide/HTML/Content_categories#contenu_de_flux">contenu de flux</a>.</td>
+ </tr>
+ <tr>
+ <th scope="row">RĂŽle ARIA implicite</th>
+ <td><a href="https://www.w3.org/TR/html-aria/#dfn-no-corresponding-role">Pas de rĂŽle correspondant</a></td>
+ </tr>
+ <tr>
+ <th scope="row">RÎles ARIA autorisés</th>
+ <td><a href="https://w3c.github.io/aria/#group">group</a>, <code><a href="/fr/docs/Web/Accessibility/ARIA/Roles/List_role">list</a></code>, <code><a href="https://w3c.github.io/aria/#none">none</a></code>, <a href="https://w3c.github.io/aria/#presentation">presentation</a></td>
+ </tr>
+ <tr>
+ <th scope="row">Interface DOM</th>
+ <td><a href="/fr/docs/Web/API/HTMLDListElement"><code>HTMLDListElement</code></a></td>
+ </tr>
+ </tbody>
+</table>
-<p>Cet élément inclut <a href="/fr/docs/Web/HTML/Attributs_universels">les attributs universels</a>.</p>
+<h2 id="attributes">Attributs</h2>
-<h2 id="Exemples">Exemples</h2>
+<p>Cet élément inclut <a href="/fr/docs/Web/HTML/Global_attributes">les attributs universels</a>.</p>
-<h3 id="Un_seul_terme_et_une_seule_définition">Un seul terme et une seule définition</h3>
+<h2 id="examples">Exemples</h2>
-<h4 id="HTML">HTML</h4>
+<h3 id="single_term_and_description">Un seul terme et une seule définition</h3>
<pre class="brush: html">&lt;dl&gt;
&lt;dt&gt;Firefox&lt;/dt&gt;
@@ -34,16 +73,11 @@ translation_of: Web/HTML/Element/dl
volontaires.
&lt;/dd&gt;
&lt;!-- D'autres termes et leurs descriptions --&gt;
-&lt;/dl&gt;
-</pre>
-
-<h4 id="RĂ©sultat">RĂ©sultat</h4>
-
-<p>{{EmbedLiveSample("Un_seul_terme_et_une_seule_définition","400","200")}}</p>
+&lt;/dl&gt;</pre>
-<h3 id="Plusieurs_termes_avec_une_mĂȘme_dĂ©finition">Plusieurs termes avec une mĂȘme dĂ©finition</h3>
+<p>{{EmbedLiveSample("single_term_and_description", "", 120)}}</p>
-<h4 id="HTML_2">HTML</h4>
+<h3 id="multiple_terms_single_description">Plusieurs termes avec une mĂȘme dĂ©finition</h3>
<pre class="brush: html">&lt;dl&gt;
&lt;dt&gt;Firefox&lt;/dt&gt;
@@ -55,16 +89,11 @@ translation_of: Web/HTML/Element/dl
volontaires.
&lt;/dd&gt;
&lt;!-- D'autres termes et leurs définitions --&gt;
-&lt;/dl&gt;
-</pre>
-
-<h4 id="RĂ©sultat_2">RĂ©sultat</h4>
-
-<p>{{EmbedLiveSample("Plusieurs_termes_avec_une_mĂȘme_dĂ©finition","400","200")}}</p>
+&lt;/dl&gt;</pre>
-<h3 id="Un_seul_terme_avec_plusieurs_définitions">Un seul terme avec plusieurs définitions</h3>
+<p>{{EmbedLiveSample("multiple_terms_single_description", "", 180)}}</p>
-<h4 id="HTML_3">HTML</h4>
+<h3 id="single_term_multiple_descriptions">Un seul terme avec plusieurs définitions</h3>
<pre class="brush: html">&lt;dl&gt;
&lt;dt&gt;Firefox&lt;/dt&gt;
@@ -79,121 +108,84 @@ translation_of: Web/HTML/Element/dl
de l'Himalaya et de la Chine méridionale.
&lt;/dd&gt;
&lt;!-- D'autres termes et leurs définitions --&gt;
-&lt;/dl&gt;
-</pre>
+&lt;/dl&gt;</pre>
+
+<p>{{EmbedLiveSample("single_term_multiple_descriptions", "", 180)}}</p>
-<h4 id="RĂ©sultat_3">RĂ©sultat</h4>
+<h3 id="multiple_terms_and_descriptions">Termes et descriptions multiples</h3>
-<p>{{EmbedLiveSample("Un_seul_terme_avec_plusieurs_définitions","400","200")}}</p>
+<p>Il est également possible de définir plusieurs termes avec plusieurs descriptions correspondantes, en combinant les exemples ci-dessus.</p>
-<h3 id="Métadonnées">Métadonnées</h3>
+<h3 id="metadata">Métadonnées</h3>
<p>Les listes de définitions sont utiles lorsqu'on souhaite afficher des métadonnées sous forme d'une liste de clés-valeurs.</p>
<pre class="brush: html">&lt;dl&gt;
- &lt;dt&gt;Name&lt;/dt&gt;
- &lt;dd&gt;Godzilla&lt;/dd&gt;
- &lt;dt&gt;Born&lt;/dt&gt;
- &lt;dd&gt;1952&lt;/dd&gt;
- &lt;dt&gt;Birthplace&lt;/dt&gt;
- &lt;dd&gt;Japan&lt;/dd&gt;
- &lt;dt&gt;Color&lt;/dt&gt;
- &lt;dd&gt;Green&lt;/dd&gt;
+ &lt;dt&gt;Nom&lt;/dt&gt;
+ &lt;dd&gt;Godzilla&lt;/dd&gt;
+ &lt;dt&gt;NĂ© le&lt;/dt&gt;
+ &lt;dd&gt;1952&lt;/dd&gt;
+ &lt;dt&gt;Lieu de naissance&lt;/dt&gt;
+ &lt;dd&gt;Japon&lt;/dd&gt;
+ &lt;dt&gt;Couleur&lt;/dt&gt;
+ &lt;dd&gt;Vert&lt;/dd&gt;
&lt;/dl&gt;</pre>
-<div class="note">
-<p><strong>Astuce :</strong> Il peut ĂȘtre pratique de dĂ©finir un sĂ©parateur clĂ©/valeur en CSS3, par exemple : dt:after {content: ": ";}.</p>
-</div>
+<p>Conseil : il peut ĂȘtre pratique de dĂ©finir un sĂ©parateur clĂ©-valeur dans le CSS, par exemple :</p>
-<h2 id="Notes">Notes</h2>
+<pre class="brush: css">dt::after {
+ content: ": ";
+}</pre>
-<p>Cet Ă©lĂ©ment ne doit pas ĂȘtre utilisĂ© (de mĂȘme que les Ă©lĂ©ments {{HTMLElement("ul")}}), dans le seul but de crĂ©er une indentation sur la page. Bien que cela fonctionne parfaitement, c'est une pratique dĂ©conseillĂ©e qui mĂȘle mise en forme et sĂ©mantique. Cela modifie le rĂŽle que doivent avoir les listes de dĂ©finitions.</p>
+<h3 id="wrapping_name-value_groups_in_htmlelementdiv_elements">Intégration de groupes nom-valeur dans les éléments <code>&lt;div&gt;</code>.</h3>
-<p>Pour changer l'indentation de la définition d'un terme, il faut utiliser la propriété <a href="/fr/docs/Web/CSS">CSS</a> {{cssxref("margin")}}.</p>
+<p><a href="/fr/docs/Glossary/WHATWG">WHATWG</a> HTML permet d'envelopper chaque groupe nom-valeur d'un Ă©lĂ©ment <a href="/fr/docs/Web/HTML/Element/dl"><code>&lt;dl&gt;</code></a> dans un Ă©lĂ©ment <a href="/fr/docs/Web/HTML/Element/div"><code>&lt;div&gt;</code></a>. Cela peut ĂȘtre utile lors de l'utilisation de <a href="/fr/docs/Web/HTML/Microdata">microdonnĂ©es</a>, ou lorsque les <a href="/fr/docs/Web/HTML/Global_attributes">attributs universels</a> s'appliquent Ă  un groupe entier, ou encore Ă  des fins de style.</p>
-<h2 id="Accessibilité">Accessibilité</h2>
+<pre class="brush: html">&lt;dl&gt;
+ &lt;div&gt;
+ &lt;dt&gt;Nom&lt;/dt&gt;
+ &lt;dd&gt;Godzilla&lt;/dd&gt;
+ &lt;/div&gt;
+ &lt;div&gt;
+ &lt;dt&gt;NĂ© le&lt;/dt&gt;
+ &lt;dd&gt;1952&lt;/dd&gt;
+ &lt;/div&gt;
+ &lt;div&gt;
+ &lt;dt&gt;Lieu de naissance&lt;/dt&gt;
+ &lt;dd&gt;Japon&lt;/dd&gt;
+ &lt;/div&gt;
+ &lt;div&gt;
+ &lt;dt&gt;Couleur&lt;/dt&gt;
+ &lt;dd&gt;Vert&lt;/dd&gt;
+ &lt;/div&gt;
+&lt;/dl&gt;</pre>
-<p>Les lecteurs d'écran annoncent <code>&lt;dl&gt;</code> de façon différente. Certains lecteurs d'écran tels que VoiceOver sur iOS n'annonceront pas le fait que le contenu de <code>&lt;dl&gt;</code> est une liste. Il faut donc s'assurer que la relation entre les éléments de la liste est bien communiquée grùce aux contenus des éléments.</p>
+<h2 id="notes">Notes</h2>
-<ul>
- <li><a href="https://s.codepen.io/aardrian/debug/NzGaKP"><code>&lt;dt&gt;</code> et <code>&lt;dd&gt;</code> sur CodePen</a></li>
-</ul>
+<p>Cet Ă©lĂ©ment ne doit pas ĂȘtre utilisĂ© (de mĂȘme que les Ă©lĂ©ments <a href="/fr/docs/Web/HTML/Element/ul"><code>&lt;ul&gt;</code></a>), dans le seul but de crĂ©er une indentation sur la page. Bien que cela fonctionne parfaitement, c'est une pratique dĂ©conseillĂ©e qui mĂȘle mise en forme et sĂ©mantique. Cela modifie le rĂŽle que doivent avoir les listes de dĂ©finitions.</p>
-<p> </p>
+<p>Pour changer l'indentation de la définition d'un terme, il faut utiliser la propriété <a href="/fr/docs/Web/CSS">CSS</a> <a href="/fr/docs/Web/CSS/margin"><code>margin</code></a>.</p>
-<h2 id="Résumé_technique">Résumé technique</h2>
+<h2 id="accessibility_concerns">Accessibilité</h2>
-<table class="properties">
- <tbody>
- <tr>
- <th scope="row"><dfn><a href="/fr/docs/Web/HTML/Catégorie_de_contenu">Catégories de contenu</a></dfn></th>
- <td><a href="/fr/docs/Web/HTML/Catégorie_de_contenu#Contenu_de_flux">Contenu de flux</a> et, si les éléments enfants de <code>&lt;dl&gt;</code> incluent une paire avec un nom et une valeur, du <a href="/fr/docs/Web/HTML/Catégorie_de_contenu#Contenu_tangible">contenu tangible</a>.</td>
- </tr>
- <tr>
- <th scope="row"><dfn>Contenu autorisé</dfn></th>
- <td>
- <p>Zéro ou plusieurs groupes composés d'un ou plusieurs éléments {{HTMLElement("dt")}}, chacun suivi par un ou plusieurs éléments {{HTMLElement("dd")}} entre lesquels on pourra éventuellement avoir des éléments {{HTMLElement("script")}} et {{HTMLElement("template")}}.</p>
-
- <p>Selon le WHATWG : un ou plusieurs éléments {{HTMLElement("div")}} éventuellement entrecoupés d'éléments {{HTMLElement("script")}} ou {{HTMLElement("template")}}.</p>
- </td>
- </tr>
- <tr>
- <th scope="row">Omission de balises</th>
- <td>{{no_tag_omission}}</td>
- </tr>
- <tr>
- <th scope="row"><dfn>Parents autorisés</dfn></th>
- <td>Tout élément acceptant du <a href="/fr/docs/Web/HTML/Catégorie_de_contenu#Contenu_de_flux">contenu de flux</a>.</td>
- </tr>
- <tr>
- <th scope="row">RÎles ARIA autorisés</th>
- <td>{{ARIARole("group")}}, {{ARIARole("presentation")}}</td>
- </tr>
- <tr>
- <th scope="row"><dfn>Interface DOM</dfn></th>
- <td>{{domxref("HTMLDListElement")}}</td>
- </tr>
- </tbody>
-</table>
+<p>Les lecteurs d'Ă©cran annoncent <code>&lt;dl&gt;</code> de façon diffĂ©rente. À partir d'iOS 14, VoiceOver annoncera que le contenu de <code>&lt;dl&gt;</code> est une liste lors de la navigation au curseur (mais pas via la lecture gĂ©nĂ©rale). Il faut donc s'assurer que la relation entre les Ă©lĂ©ments de la liste est bien communiquĂ©e grĂące aux contenus des Ă©lĂ©ments.</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('HTML WHATWG', 'semantics.html#the-dl-element', '&lt;dl&gt;')}}</td>
- <td>{{Spec2('HTML WHATWG')}}</td>
- <td> </td>
- </tr>
- <tr>
- <td>{{SpecName('HTML5 W3C', 'grouping-content.html#the-dl-element', '&lt;dl&gt;')}}</td>
- <td>{{Spec2('HTML5 W3C')}}</td>
- <td> </td>
- </tr>
- <tr>
- <td>{{SpecName('HTML4.01', 'struct/lists.html#h-10.3', '&lt;dl&gt;')}}</td>
- <td>{{Spec2('HTML4.01')}}</td>
- <td>DĂ©finition initiale.</td>
- </tr>
- </tbody>
-</table>
+<ul>
+ <li><a href="https://codepen.io/aardrian/debug/NzGaKP">CodePen - Les camarades HTML : dt &amp; dd</a> <small>(en)</small></li>
+ <li><a href="https://adrianroselli.com/2020/09/voiceover-on-ios-14-supports-description-lists.html">VoiceOver sous iOS 14 prend en charge les listes de descriptions</a> <small>(en)</small></li>
+ </ul>
+
+<h2 id="specifications">Spécifications</h2>
-<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+<p>{{Specifications}}</p>
-<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>
+<h2 id="browser_compatibility">Compatibilité des navigateurs</h2>
-<p>{{Compat("html.elements.dl")}}</p>
+<p>{{Compat}}</p>
-<h2 id="Voir_aussi">Voir aussi</h2>
+<h2 id="see_also">Voir aussi</h2>
<ul>
- <li>{{HTMLElement("dt")}}</li>
- <li>{{HTMLElement("dd")}}</li>
+ <li>L'élément <a href="/fr/docs/Web/HTML/Element/dt"><code>&lt;dt&gt;</code></a></li>
+ <li>L'élément <a href="/fr/docs/Web/HTML/Element/dd"><code>&lt;dd&gt;</code></a></li>
</ul>