From a47584de1bd47788cb5aa6178fa88b31977b2a8e Mon Sep 17 00:00:00 2001 From: tristantheb Date: Sat, 19 Jun 2021 10:25:05 +0200 Subject: UPDATE: Update translation of the HTML elements — 🛠 Priority work area (#500) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * 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 --- files/fr/web/html/element/dfn/index.html | 214 ++++++++++++++----------------- 1 file changed, 98 insertions(+), 116 deletions(-) (limited to 'files/fr/web/html/element/dfn/index.html') diff --git a/files/fr/web/html/element/dfn/index.html b/files/fr/web/html/element/dfn/index.html index 7ff128d4f2..147a16f0a6 100644 --- a/files/fr/web/html/element/dfn/index.html +++ b/files/fr/web/html/element/dfn/index.html @@ -2,52 +2,97 @@ title: ' : l''élément de définition' slug: Web/HTML/Element/dfn tags: + - Definition + - Definitions - Element - HTML + - HTML text-level semantics - Reference + - Semantic Markup - Web + - dfn translation_of: Web/HTML/Element/dfn +browser-compat: html.elements.dfn ---
{{HTMLRef}}
-

L'élément HTML <dfn> est utilisé afin d'indiquer le terme qui est en train d'être défini dans une phrase ou un paragraphe (sa définition est écrite dans son parent {{HTMLElement("p")}} ou {{HTMLElement("dt")}}/{{HTMLElement("dd")}} ou {{HTMLElement("section")}} le plus proche).

- -
-

Note : Si cette phrase vous paraît absconse, n'hésitez pas à consulter les exemples ci-après.

-
- -

Le rôle de l'élément <dfn> est purement sémantique.

+

L'élément HTML <dfn> (aussi nommé « définition ») est utilisé pour indiquer le terme défini dans le contexte d'une expression ou d'une phrase de définition. L'élément <p>, le couple <dt>/<dd> ou l'élément <section> qui est le plus proche ancêtre de <dfn> est considéré comme la définition du terme.

{{EmbedInteractiveExample("pages/tabbed/dfn.html", "tabbed-shorter")}}
- + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Catégories de contenuContenu de flux, contenu phrasé, contenu tangible.
Contenu autoriséContenu phrasé mais sans élément <dfn> qui soit un descendant.
Omission de balisesAucune, la balise d'ouverture et la balise de fermeture sont obligatoires.
Parents autorisésTout élément acceptant du contenu phrasé.
RĂ´le ARIA impliciteterm
Rôles ARIA autorisésTous les rôles sont autorisés.
Interface DOMHTMLElement.
-

Attributs

+

Attributs

-

Comme pour tous les éléments, on peut appliquer les attributs universels sur <dfn>.

+

Comme pour tous les éléments, on peut appliquer les attributs universels sur <dfn>.

Pour cet élément, l'attribut title possède un sens particulier noté ci-après.

-

Notes d'utilisation :

+

Notes d'utilisation

-
    -
  • L'Ă©lĂ©ment <dfn> marque le terme Ă©tant dĂ©fini. La dĂ©finition du terme doit ĂŞtre donnĂ©e par l'Ă©lĂ©ment {{HTMLElement("p")}}, ou {{HTMLElement("section")}} parent ou par un groupe de liste de dĂ©finitions (gĂ©nĂ©ralement une paire {{HTMLElement("dt")}}, {{HTMLElement("dd")}}).
    • -
  • La valeur exacte du terme Ă©tant dĂ©fini est dĂ©terminĂ© par les règles suivantes : -
      -
    1. Si l'élément <dfn> possède un attribut title alors le terme en question est la valeur de cet attribut. Dans ce cas, l'élément doit toujours contenir du texte mais ce dernier peut être une autre forme du terme (par exemple une abbréviation, auquel cas on utilisera un élément {{HTMLElement("abbr")}})
      2. -
    2. Sinon et s'il contient seulement un élément {{HTMLElement("abbr")}} avec l'attribut {{htmlattrxref("title", "abbr")}}, alors le terme en question est la valeur de cet attribut.
      3. -
    3. Dans tous les autres cas, le texte contenu par l'élément <dfn> est le terme qui est défini.
      4. -
    -
    • -
+

L'utilisation de l'élément <dfn> présente certains aspects peu évidents. Nous les examinons ici.

+ +

Spécifier le terme à définir

-

Exemples

+

Le terme à définir est identifié selon ces règles :

-

Identification simple d’un terme

+
    +
  1. Si l'élément <dfn> possède un attribut title, la valeur de l'attribut title est considérée comme étant le terme défini. L'élément doit toujours contenir du texte, mais ce texte peut être une abréviation (peut-être en utilisant <abbr>) ou une autre forme du terme.
    2. +
  2. Si le <dfn> contient un seul élément enfant et n'a pas de contenu textuel propre, et que l'élément enfant est un élément <abbr> avec un attribut title lui-même, alors la valeur exacte du <abbr> de l'élément title est le terme défini.
    3. +
  3. Sinon, le contenu textuel de l'élément <dfn> est le terme défini. Ceci est illustré dans le premier exemple ci-dessous.
    4. +
+ +
+

Note :

+

Si l'élément <dfn> possède un attribut title, il doit contenir le terme défini et aucun autre texte.

+
+ + + +

Si vous incluez un attribut id sur l'élément <dfn>, vous pouvez ensuite créer un lien vers celui-ci en utilisant des éléments <a>. Ces liens doivent être des utilisations du terme, l'objectif étant que le lecteur puisse accéder rapidement à la définition du terme s'il ne la connaît pas déjà, en cliquant sur le lien du terme.

+ +

C'est ce que montre l'exemple sous Liens vers les définitions ci-dessous.

+ +

Exemples

+ +

Voyons quelques exemples de divers scénarios d'utilisation.

+ +

Identification simple d'un terme

Dans cet exemple, on utilise simplement l'élément <dfn> afin d'identifier l'emplacement du terme défini au sein de sa définition.

-

HTML

+

HTML

<p>
   L'élément HTML de définition
@@ -58,15 +103,15 @@ translation_of: Web/HTML/Element/dfn
 
 
L'élément <dfn> n'ayant ici pas d'attribut title, c'est le contenu textuel qui représente le terme que l'on définit.

 
-
RĂ©sultat

+
RĂ©sultat

 
-
{{EmbedLiveSample("Identification_simple_d’un_terme", 650, 120)}}

+
{{EmbedLiveSample("basic_identification_of_a_term", "", 120)}}

 
-
Liens vers des définitions

+
 
-
Il est possible d'utiliser l'attribut id afin de créer des liens avec des éléments {{HTMLElement("a")}} qui pointent vers la définition.

+
Il est possible d'utiliser l'attribut id afin de créer des liens avec des éléments <a> qui pointent vers la définition.

 
-
HTML

+
HTML

 
 
<p>L'élément de définition
 (<strong><dfn id="definition-dfn">&lt;dfn&gt;</dfn></strong>) est
@@ -89,108 +134,45 @@ agere divinius? </p>
 <code><a href="#definition-dfn">&lt;dfn&gt;</a></code> pour
 ce projet.</p>

 
-
On voit ici que l'élément possède désormais un attribut {{htmlattrxref("id")}} avec la valeur "definition-dfn". Cet attribut permet d'utiliser l'élément comme cible d'un lien. Plus bas, on crée un tel lien avec un élément {{HTMLElement("a")}} dont l'attribut {{htmlattrxref("href", "a")}} vaut "#definition-dfn", ce qui permet de remonter à la définition.

+
On voit ici que l'élément possède désormais un attribut id avec la valeur "definition-dfn". Cet attribut permet d'utiliser l'élément comme cible d'un lien. Plus bas, on crée un tel lien avec un élément <a> dont l'attribut href vaut "#definition-dfn", ce qui permet de remonter à la définition.

 
-
RĂ©sultat

+
RĂ©sultat

 
-
{{EmbedLiveSample("Liens_vers_des_définitions", 650, 300)}}

+
{{EmbedLiveSample("links_to_definitions", "", 350)}}

 
-
Combiner les abbréviations et les définitions

+
Utiliser les abréviations et les définitions

 
-
Dans certains cas, on souhaite utiliser l'abbréviation d'un terme lorsqu'on le définit. Pour cela, on peut utiliser <dfn> et {{HTMLElement("abbr")}} de la façon suivante :

+
Dans certains cas, on souhaite utiliser l'abréviation d'un terme lorsqu'on le définit. Pour cela, on peut utiliser <dfn> et <abbr> de la façon suivante :

 
-
HTML

+
HTML

 
-
<p>The <dfn><abbr title="Hubble Space Telescope">HST</abbr></dfn>
-is among the most productive scientific instruments ever constructed.
-It has been in orbit for over 20 years, scanning the sky and
-returning data and photographs of unprecedented quality and
-detail.</p>
+
<p>Le <dfn><abbr title="TĂ©lescope Spatial Hubble">TSH</abbr></dfn>
+est l'un des instruments scientifiques les plus productifs jamais
+construits. Il est en orbite depuis plus de 20 ans, scrutant le ciel
+et renvoyant des données et des photographies d'une qualité et d'un
+niveau de détail sans précédent.</p>
 
-<p>Indeed, the <abbr title="Hubble Space Telescope">HST</abbr> has
-arguably done more to advance science than any device ever built.</p>

+<p>En effet, le <abbr title="TĂ©lescope Spatial Hubble">TSH</abbr> a sans 
+doute fait plus pour faire avancer la science que tout autre appareil
+jamais construit.</p>

 
-
On notera que l'élément <abbr> est imbriqué dans l'élément <dfn>. L'élément <abbr> indique que le terme est une abbréviation ("HST") et indique le détail de cette abbrévation ("Hubble Space Telescope") grâce à son attribut  title. L'élément <dfn> indique quant à lui que c'est bien ce terme abrégé qu'on est en train de définir.

+
On notera que l'élément <abbr> est imbriqué dans l'élément <dfn>. L'élément <abbr> indique que le terme est une abréviation ("HST") et indique le détail de cette abrévation ("Hubble Space Telescope") grâce à son attribut title. L'élément <dfn> indique quant à lui que c'est bien ce terme abrégé qu'on est en train de définir.

 
-
RĂ©sultat

+
RĂ©sultat

 
-
{{EmbedLiveSample("Combiner_les_abbréviations_et_les_définitions", 650, 200)}}

+
{{EmbedLiveSample("using_abbreviations_and_definitions_together", "", 200)}}

 
-
Résumé technique

-
-
- 
-  
-   
-   
-  
-  
-   
-   
-  
-  
-   
-   
-  
-  
-   
-   
-  
-  
-   
-   
-  
-  
-   
-   
-  
- 
-
Catégories de contenuContenu de flux, contenu phrasé, contenu tangible.
Contenu autoriséContenu phrasé mais sans élément {{HTMLElement("dfn")}} qui soit un descendant.
Omission de balises{{no_tag_omission}}
Parents autorisésTout élément acceptant du contenu phrasé.
Rôles ARIA autorisésTous les rôles sont autorisés.
Interface DOM{{domxref("HTMLElement")}}.

-
-
Spécifications

-
-
- 
-  
-   
-   
-   
-  
- 
- 
-  
-   
-   
-   
-  
-  
-   
-   
-   
-  
-  
-   
-   
-   
-  
- 
-
SpécificationsÉtatCommentaires
{{SpecName('HTML WHATWG', 'semantics.html#the-dfn-element', '<dfn>')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'text-level-semantics.html#the-dfn-element', '<dfn>')}}{{Spec2('HTML5 W3C')}}
{{SpecName('HTML4.01', 'struct/text.html#h-9.2.1', '<dfn>')}}{{Spec2('HTML4.01')}}

+
Spécifications

 
-
Compatibilité des navigateurs

+
{{Specifications}}

 
-
+
Compatibilité des navigateurs

 
-
{{Compat("html.elements.dfn")}}

+
{{Compat}}

 
-
Voir aussi

+
Voir aussi

 
 
    
- 
  • Les Ă©lĂ©ments HTML en lien avec les listes de dĂ©finitions :
-  
      
-   
    • {{HTMLElement("dl")}}
      • 
-   
    • {{HTMLElement("dt")}}
      • 
-   
    • {{HTMLElement("dd")}}
      • 
-  
    
- 
    • 
- 
  • {{HTMLElement("abbr")}}
    • 
+  
  • ÉlĂ©ments liĂ©s aux listes de dĂ©finitions : <dl>, <dt>, <dd>
    • 
+  
  • L'Ă©lĂ©ment <abbr>
    • 
 

-- 
cgit v1.2.3-54-g00ecf