diff options
author | tristantheb <tristantheb@users.noreply.github.com> | 2021-06-19 10:25:05 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-06-19 10:25:05 +0200 |
commit | a47584de1bd47788cb5aa6178fa88b31977b2a8e (patch) | |
tree | 1c153a5dd0e939a3ef819df87d6b988da950352f /files/fr/web/html/element/dl/index.html | |
parent | 1b0940218952a8132ceb9e4b56792ad47e94d552 (diff) | |
download | translated-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.html | 224 |
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><dl></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><dl></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><dt></code></a>) et leurs descriptions ou dĂ©finitions (fournies par des Ă©lĂ©ments <a href="/fr/docs/Web/HTML/Element/dd"><code><dd></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><dl></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><dt></code></a>, chacun suivi par un ou plusieurs Ă©lĂ©ments <a href="/fr/docs/Web/HTML/Element/dd"><code><dd></code></a> entre lesquels on pourra Ă©ventuellement avoir des Ă©lĂ©ments <a href="/fr/docs/Web/HTML/Element/script"><code><script></code></a> et <a href="/fr/docs/Web/HTML/Element/template"><code><template></code></a>.</p> + + <p>Selon le WHATWG : un ou plusieurs Ă©lĂ©ments <a href="/fr/docs/Web/HTML/Element/div"><code><div></code></a> Ă©ventuellement entrecoupĂ©s d'Ă©lĂ©ments <a href="/fr/docs/Web/HTML/Element/script"><code><script></code></a> ou <a href="/fr/docs/Web/HTML/Element/template"><code><template></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"><dl> <dt>Firefox</dt> @@ -34,16 +73,11 @@ translation_of: Web/HTML/Element/dl volontaires. </dd> <!-- D'autres termes et leurs descriptions --> -</dl> -</pre> - -<h4 id="RĂ©sultat">RĂ©sultat</h4> - -<p>{{EmbedLiveSample("Un_seul_terme_et_une_seule_dĂ©finition","400","200")}}</p> +</dl></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"><dl> <dt>Firefox</dt> @@ -55,16 +89,11 @@ translation_of: Web/HTML/Element/dl volontaires. </dd> <!-- D'autres termes et leurs dĂ©finitions --> -</dl> -</pre> - -<h4 id="RĂ©sultat_2">RĂ©sultat</h4> - -<p>{{EmbedLiveSample("Plusieurs_termes_avec_une_mĂȘme_dĂ©finition","400","200")}}</p> +</dl></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"><dl> <dt>Firefox</dt> @@ -79,121 +108,84 @@ translation_of: Web/HTML/Element/dl de l'Himalaya et de la Chine mĂ©ridionale. </dd> <!-- D'autres termes et leurs dĂ©finitions --> -</dl> -</pre> +</dl></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"><dl> - <dt>Name</dt> - <dd>Godzilla</dd> - <dt>Born</dt> - <dd>1952</dd> - <dt>Birthplace</dt> - <dd>Japan</dd> - <dt>Color</dt> - <dd>Green</dd> + <dt>Nom</dt> + <dd>Godzilla</dd> + <dt>NĂ© le</dt> + <dd>1952</dd> + <dt>Lieu de naissance</dt> + <dd>Japon</dd> + <dt>Couleur</dt> + <dd>Vert</dd> </dl></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><div></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><dl></code></a> dans un Ă©lĂ©ment <a href="/fr/docs/Web/HTML/Element/div"><code><div></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"><dl> + <div> + <dt>Nom</dt> + <dd>Godzilla</dd> + </div> + <div> + <dt>NĂ© le</dt> + <dd>1952</dd> + </div> + <div> + <dt>Lieu de naissance</dt> + <dd>Japon</dd> + </div> + <div> + <dt>Couleur</dt> + <dd>Vert</dd> + </div> +</dl></pre> -<p>Les lecteurs d'Ă©cran annoncent <code><dl></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><dl></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><dt></code> et <code><dd></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><ul></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><dl></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><dl></code> de façon diffĂ©rente. Ă partir d'iOS 14, VoiceOver annoncera que le contenu de <code><dl></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', '<dl>')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('HTML5 W3C', 'grouping-content.html#the-dl-element', '<dl>')}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('HTML4.01', 'struct/lists.html#h-10.3', '<dl>')}}</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 & 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><dt></code></a></li> + <li>L'Ă©lĂ©ment <a href="/fr/docs/Web/HTML/Element/dd"><code><dd></code></a></li> </ul> |