From 02cc75a2aa4d85b08be71ffbe0098d0ece037375 Mon Sep 17 00:00:00 2001 From: tristantheb Date: Sun, 11 Apr 2021 16:56:41 +0200 Subject: UPDATE: Update and fix
    element page (#465) * UPDATE: Update and fix
      element page * Review - HTML ol - minor fixes Co-authored-by: julieng --- files/fr/web/html/element/ol/index.html | 285 +++++++++++++++----------------- 1 file changed, 134 insertions(+), 151 deletions(-) (limited to 'files/fr/web/html/element') diff --git a/files/fr/web/html/element/ol/index.html b/files/fr/web/html/element/ol/index.html index 1bc58e0eba..419254935b 100644 --- a/files/fr/web/html/element/ol/index.html +++ b/files/fr/web/html/element/ol/index.html @@ -4,234 +4,217 @@ slug: Web/HTML/Element/ol tags: - Element - HTML + - HTML grouping content + - HTML:Flow content - Reference - - Web translation_of: Web/HTML/Element/ol ---
      {{HTMLRef}}
      -

      L'élément HTML <ol> représente une liste ordonnée. Les éléments d'une telle liste sont généralement affichés avec un indicateur ordinal pouvant prendre la forme de nombres, de lettres, de chiffres romains ou de points. La mise en forme de la numérotation n'est pas utilisée dans la description HTML mais dans la feuille de style CSS associée grâce à la propriété {{cssxref("list-style-type")}}.

      +

      L'élément HTML <ol> représente une liste ordonnée. Les éléments d'une telle liste sont généralement affichés avec un indicateur ordinal pouvant prendre la forme de nombres, de lettres, de chiffres romains ou de points. La mise en forme de la numérotation n'est pas utilisée dans la description HTML mais dans la feuille de style CSS associée grâce à la propriété list-style-type.

      {{EmbedInteractiveExample("pages/tabbed/ol.html", "tabbed-shorter")}}
      - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Catégories de contenuContenu de flux, contenu tangible si les enfants de l'élément <ol> incluent au moins un élément <li>.
      Contenu autoriséZéro, un, ou plusieurs éléments <li> (qui peuvent imbriquer d'autres éléments <ol> ou <ul>), <script> ou <template>.
      Omission de balisesAucune, la balise d'ouverture et la balise de fermeture sont obligatoires
      Parents autorisésTout élément acceptant du contenu de flux.
      Rôle ARIA implicitelist
      Rôles ARIA autorisésdirectory, group, listbox, menu, menubar, none, presentation, radiogroup, tablist, toolbar, tree.
      Interface DOMHTMLOListElement
      -

      Attributs

      +

      Attributs

      -

      Cet élément dispose des attributs universels.

      +

      À l'instar des autres éléments HTML, il est possible d'utiliser les attributs universels sur cet élément.

      -
      {{htmlattrdef("reversed")}} {{HTMLVersionInline(5)}}
      -
      Cet attribut booléen précise que les objets listés par l'élément sont affichés avec un ordre inversé (l'objet le moins important apparaît en première position).
      -
      {{htmlattrdef("start")}} {{HTMLVersionInline(5)}}
      -
      La valeur de cet attribut, un nombre entier, définit l'indice à partir duquel les objets de la liste sont numérotés. Bien que les indices des éléments puissent être des nombres romains ou des lettres la valeur de cet attribut doit être un nombre. Ainsi pour commencer la numérotation des éléments avec la lettre « C », il faudra entrer : <ol start="3">. Cet attribut a été déprécié en HTML4 mais a été réintroduit en HTML5.
      +
      reversed
      +
      Cet attribut booléen indique que les éléments de la liste sont dans l'ordre inverse. Les éléments sont numérotés de haut en bas.
      +
      start
      +
      Un nombre entier à partir duquel on commence à compter pour les éléments de la liste. Toujours un chiffre arabique (1, 2, 3, etc.), même lorsque le type de numérotation est constitué de lettres ou de chiffres romains. Par exemple, pour commencer à numéroter les éléments à partir de la lettre "d" ou du chiffre romain "iv", utilisez start="4".
      +
      type
      +
      Définit le type de numérotation : +
        +
      • a pour les lettres minuscules
      • +
      • A pour les lettres majuscules
      • +
      • i pour les chiffres romains minuscules
      • +
      • I pour les chiffres romains majuscules
      • +
      • 1 pour les chiffres (par défaut)
      • +
      +

      Le type spécifié est utilisé pour l'ensemble de la liste, sauf si un attribut différent type est utilisé sur un élément <li> fermé.

      + +
      +

      Note :

      +

      À moins que le type du numéro de la liste n'ait de l'importance (comme dans les documents juridiques ou techniques où les éléments sont référencés par leur numéro/lettre), utilisez plutôt la propriété CSS list-style-type.

      +
      +
      -

      Attributs dépréciés et obsolètes

      +

      Note d'utilisation

      -
      -
      {{htmlattrdef("compact")}} {{deprecated_inline}}
      -
      -

      Cet attribut booléen indique si la liste doit être affichée avec un style compact. L'interprétation de cet attribut dépend de l'agent utilisateur utilisé et ne fonctionne pas avec tous les navigateurs.

      - -
      Attention ! Cet attribut ne doit pas être utilisé car il a été déprécié : les feuilles de style CSS doivent être utilisées pour la mise en forme de l'élément {{HTMLElement("ol")}}. Afin d'obtenir un effet similaire à cet attribut, la propriété CSS {{cssxref("line-height")}} peut être utilisée avec une valeur de 80%.
      -
      -
      +

      En général, les éléments d'une liste ordonnée s'affichent avec un marqueur précédant l'élément, tel qu'un chiffre ou une lettre.

      -
      -
      {{htmlattrdef("type")}} {{deprecated_inline}}
      -
      Cet attribut définit comment les nombres ordinaux doivent être affichés. Il peut valoir les caractères suivants : -
        -
      • a : lettres minuscules
      • -
      • A : lettres majuscules
      • -
      • i : nombres romains en minuscules
      • -
      • I : nombres romains en majuscules
      • -
      • 1 : nombres
      • -
      - Le type sélectionné est alors utilisé pour toute la liste à moins qu'un élément {{HTMLElement("li")}} de la liste utilise une autre valeur pour l'attribut {{htmlattrxref("type", "li")}} - -
      Attention ! Cet attribut ne doit pas être utilisé car il a été déprécié : les feuilles de style CSS doivent être utilisées pour la mise en forme de l'élément {{HTMLElement("ol")}}. La propriété CSS {{cssxref("list-style-type")}} doit être utilisé à la place de cet attribut.
      -
      -
      +

      Les éléments <ol> et <ul> peuvent s'imbriquer aussi profondément que vous le souhaitez, alternant entre <ol> et <ul> comme vous le souhaitez.

      -

      Note d'utilisation

      +

      Les éléments <ol> et <ul> représentent tous deux une liste d'éléments. La différence est qu'avec l'élément <ol>, l'ordre est significatif. Par exemple :

        -
      • Les éléments {{HTMLElement("ol")}} et  {{HTMLElement("ul")}} représentent tous les deux une liste d'objets. Leur différence réside dans le fait qu'avec {{HTMLElement("ol")}} l'ordre est important. Un moyen mnémotechnique pour savoir lequel de ces deux éléments utiliser est d'essayer de changer l'ordre dans la liste : si sa signification a changé alors {{HTMLElement("ol")}} doit être utilisé, sinon {{HTMLElement("ul")}} doit être utilisé.
      • -
      • Il n'y pas de limitation concernant la profondeur ou l'éventuelle imbrication des listes définies par les éléments {{HTMLElement("ol")}} et {{HTMLElement("ul")}}.
      • +
      • Étapes d'une recette
      • +
      • Instructions détaillées
      • +
      • La liste des ingrédients en proportion décroissante sur les étiquettes d'information nutritionnelle
      -

      Exemples

      +

      Pour déterminer la liste à utiliser, essayez de modifier l'ordre des éléments de la liste ; si le sens change, utilisez l'élément <ol> - sinon, vous pouvez utiliser <ul>.

      -

      Exemple simple

      +

      Exemples

      -

      HTML

      +

      Exemple simple

      <ol>
      -  <li>Premier élément</li>
      -  <li>Deuxième élément</li>
      -  <li>Troisième élément</li>
      +  <li>Fee</li>
      +  <li>Fi</li>
      +  <li>Fo</li>
      +  <li>Fum</li>
       </ol>
       
      -

      Résultat

      - -

      {{EmbedLiveSample("Exemple_simple","300","150")}}

      +

      Le HTML ci-dessus affichera :

      -

      Exemple avec start

      +

      {{EmbedLiveSample("simple_example", 400, 150)}}

      -

      HTML

      +

      Utilisation des chiffres romains

      -
      <ol start="7">
      -  <li>Premier élément</li>
      -  <li>Deuxième élément</li>
      -  <li>Troisième élément</li>
      +
      <ol start="i">
      +  <li>Introduction</li>
      +  <li>Liste des Greffes</li>
      +  <li>Conclusion</li>
       </ol>
       
      -

      Résultat

      +

      Le HTML ci-dessus affichera :

      -

      {{EmbedLiveSample("Exemple_avec_start","300","150")}}

      +

      {{EmbedLiveSample("using_roman_numeral_type", 400, 150)}}

      -

      Utiliser les chiffres romains

      +

      Utilisation de l'attribut start

      -

      HTML

      +
      <p>Les places d'arrivée des concurrents qui ne sont pas dans le cercle des gagnants :</p>
       
      -
      <ol type="i">
      -  <li>toto</li>
      -  <li>truc</li>
      -  <li>bidule</li>
      +<ol start="4">
      +  <li>Speedwalk Stu</li>
      +  <li>Saunterin' Sam</li>
      +  <li>Slowpoke Rodriguez</li>
       </ol>
      -

      Résultat

      - -

      {{EmbedLiveSample("Utiliser_les_chiffres_romains","300","150")}}

      +

      Le HTML ci-dessus affichera :

      -

      Listes imbriquées

      +

      {{EmbedLiveSample("using_the_start_attribute", 400, 160)}}

      -

      HTML

      +

      Listes imbriquées

      <ol>
         <li>Premier élément</li>
      -  <li>Deuxième élément  <!-- La balise </li> n'est pas encore placée ! -->
      +  <li>Deuxième élément  <!-- La fermeture </li> n'est pas encore placée ! -->
           <ol>
             <li>Premier élément de la liste imbriquée</li>
             <li>Deuxième élément de la liste imbriquée</li>
             <li>Troisième élément de la liste imbriquée</li>
           </ol>
      -  </li>                 <!-- Voici la balise </li> ! -->
      +  </li>                 <!-- Voici la fermeture </li> ! -->
         <li>Troisième élément</li>
       </ol>
       
      -

      Résultat

      +

      Le HTML ci-dessus affichera :

      -

      {{EmbedLiveSample("Listes_imbriquées","300","300")}}

      +

      {{EmbedLiveSample("nesting_lists", 400, 200)}}

      -

      Listes imbriquées avec <ol> et <ul>

      - -

      HTML

      +

      Liste non ordonnée dans une liste ordonnée

      <ol>
         <li>Premier élément</li>
      -  <li>Deuxième élément  <!-- La balise </li> n'est pas placée ici ! -->
      +  <li>Deuxième élément  <!-- La fermeture </li> n'est pas placée ici ! -->
           <ul>
             <li>Premier élément de la liste non-ordonnée imbriquée</li>
             <li>Deuxième élément de la liste non-ordonnée imbriquée</li>
             <li>Troisième élément de la liste non-ordonnée imbriquée</li>
           </ul>
      -  </li>                 <!-- La balise </li> est ici. -->
      +  </li>                 <!-- La fermeture </li> est ici. -->
         <li>Troisième élément</li>
       </ol>
       
      -

      Résultat

      +

      Le HTML ci-dessus affichera :

      -

      {{EmbedLiveSample("Listes_imbriquées_avec_&lt;ol&gt;_et_&lt;ul&gt;","300","300")}}

      +

      {{EmbedLiveSample("unordered_list_inside_ordered_list", 400, 200)}}

      -

      Résumé technique

      - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      Catégories de contenuContenu de flux, et du contenu tangible si les enfants de l'élément <ol> incluent au moins un élément {{HTMLElement("li")}}.
      Contenu autoriséZéro, un, ou plusieurs éléments {{HTMLElement("li")}} (qui peuvent imbriquer d'autres éléments {{HTMLElement("ol")}} ou {{HTMLElement("ul")}}).
      Omission de balises{{no_tag_omission}}
      Parents autorisésTout élément acceptant du contenu de flux.
      Rôles ARIA autorisés{{ARIARole("directory")}}, {{ARIARole("group")}}, {{ARIARole("listbox")}}, {{ARIARole("menu")}}, {{ARIARole("menubar")}}, {{ARIARole("radiogroup")}}, {{ARIARole("tablist")}}, {{ARIARole("toolbar")}}, {{ARIARole("tree")}}, {{ARIARole("presentation")}}
      Interface DOM{{domxref("HTMLOListElement")}}
      - -

      Spécifications

      +

      Spécifications

      - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + +
      SpécificationÉtatCommentaires
      {{SpecName('HTML WHATWG', 'semantics.html#the-ol-element', '<ol>')}}{{Spec2('HTML WHATWG')}}Aucune modification depuis la dernière dérivation W3C {{SpecName('HTML5 W3C')}}.
      {{SpecName('HTML5 W3C', "grouping-content.html#the-ol-element", "HTMLOListElement")}}{{Spec2('HTML5 W3C')}}Ajout des attributs reversed et start. L'attribut type n'est plus déprécié.
      {{SpecName('HTML4.01', 'struct/lists.html#h-10.2', '<ol>')}}{{Spec2('HTML4.01')}}Dépréciation des attributs compact et type.
      SpécificationStatusCommentaire
      {{SpecName('HTML WHATWG', 'semantics.html#the-ol-element', '<ol>')}}{{Spec2('HTML WHATWG')}}Aucune modification depuis la dernière dérivation W3C {{SpecName('HTML5 W3C')}}.
      {{SpecName('HTML5 W3C', "grouping-content.html#the-ol-element", "HTMLOListElement")}}{{Spec2('HTML5 W3C')}}Ajout des attributs reversed et start. L'attribut type n'est plus déprécié.
      {{SpecName('HTML4.01', 'struct/lists.html#h-10.2', '<ol>')}}{{Spec2('HTML4.01')}}Dépréciation des attributs compact et type.
      -

      Compatibilité des navigateurs

      - - +

      Compatibilité des navigateurs

      {{Compat("html.elements.ol")}}

      -

      Voir aussi

      +

      Voir aussi

        -
      • Les autres éléments HTML relatifs aux listes : -
          -
        • {{HTMLElement("ul")}}
        • -
        • {{HTMLElement("li")}}
        • -
        • {{HTMLElement("menu")}}
        • -
        • l'élément {{HTMLElement("dir")}} qui est obsolète
        • -
        -
      • -
      • Les propriétés CSS pouvant servir à la mise en forme de l'élément <ol> : -
          -
        • {{cssxref("list-style")}} qui permet de choisir comment les nombres ordinaux sont affichés,
        • -
        • Les compteurs CSS, utiles pour gérer les listes imbriquées complexes,
        • -
        • {{cssxref("line-height")}} qui permet d'obtenir le même effet que l'attribut {{htmlattrxref("compact", "ol")}} qui est déprécié,
        • -
        • {{cssxref("margin")}} qui permet de contrôler l'indentation de la liste.
        • -
        -
      • +
      • Les autres éléments HTML relatifs aux listes : <ul>, <li>, <menu>
      • +
      • Les propriétés CSS pouvant servir à la mise en forme de l'élément <ol> : +
          +
        • list-style qui permet de choisir comment les nombres ordinaux sont affichés,
        • +
        • Les compteurs CSS, utiles pour gérer les listes imbriquées complexes,
        • +
        • line-height qui permet d'obtenir le même effet que l'attribut compact qui est déprécié,
        • +
        • margin qui permet de contrôler l'indentation de la liste.
        • +
        +
      -- cgit v1.2.3-54-g00ecf