From dea9d1f019d9e14357c58cf18653df1ac779d9d8 Mon Sep 17 00:00:00 2001 From: julieng Date: Wed, 13 Oct 2021 07:13:08 +0200 Subject: convert content to md --- files/fr/web/html/element/main/index.md | 277 ++++++++++++++++---------------- 1 file changed, 141 insertions(+), 136 deletions(-) (limited to 'files/fr/web/html/element/main') diff --git a/files/fr/web/html/element/main/index.md b/files/fr/web/html/element/main/index.md index 6f5982049c..40023666b2 100644 --- a/files/fr/web/html/element/main/index.md +++ b/files/fr/web/html/element/main/index.md @@ -8,175 +8,180 @@ tags: - Web translation_of: Web/HTML/Element/main --- -
{{HTMLRef}}
+{{HTMLRef}} -

L’élément HTML <main> représente le contenu majoritaire du {{HTMLElement("body")}} du document. Le contenu principal de la zone est constitué de contenu directement en relation, ou qui étend le sujet principal du document ou de la fonctionnalité principale d'une application.

+L’élément HTML **`
`** représente le contenu majoritaire du {{HTMLElement("body")}} du document. Le contenu principal de la zone est constitué de contenu directement en relation, ou qui étend le sujet principal du document ou de la fonctionnalité principale d'une application. -

Un document ne peut pas avoir plus d'un seul élément <main> sans attribut {{htmlattrxref("hidden")}}.

+Un document ne peut pas avoir plus d'un seul élément `
` sans attribut {{htmlattrxref("hidden")}}. -
{{EmbedInteractiveExample("pages/tabbed/main.html","tabbed-shorter")}}
+{{EmbedInteractiveExample("pages/tabbed/main.html","tabbed-shorter")}} -

Attributs

+## Attributs -

Cet élément prend uniquement en charge les attributs universels.

+Cet élément prend uniquement en charge [les attributs universels](/fr/docs/Web/HTML/Attributs_universels). -

Notes

+## Notes -
    -
  • Ce contenu doit être unique dans le document, excluant tout contenu qui est répété sur plusieurs documents comme des barres latérales, liens de navigation, informations relative au droit d'auteur, logo du site, et champs de recherche (sauf, bien entendu, si la fonctionnalité principale du document est un champ de recherche).
  • -
  • <main> ne contribue pas au plan du document. Autrement dit, à la différence d'éléments tels que {{HTMLElement("body")}}, les niveaux de titre comme {{HTMLElement("h2")}}, etc. <main> n'affecte pas la structure même de la page, c'est un élément purement informatif.
  • -
+- Ce contenu doit être unique dans le document, excluant tout contenu qui est répété sur plusieurs documents comme des barres latérales, liens de navigation, informations relative au droit d'auteur, logo du site, et champs de recherche (sauf, bien entendu, si la fonctionnalité principale du document est un champ de recherche). +- `
` ne contribue pas au plan du document. Autrement dit, à la différence d'éléments tels que {{HTMLElement("body")}}, les niveaux de titre comme {{HTMLElement("h2")}}, etc. `
` n'affecte pas la structure même de la page, c'est un élément purement informatif. -

Exemples

+## Exemples -

HTML

+### HTML -
<!-- autre contenu -->
+```html
+
 
-<main>
-  <h1>Pommes</h1>
-  <p>La pomme est le fruit à pépin du pommier.</p>
+
+

Pommes

+

La pomme est le fruit à pépin du pommier.

- <article> - <h2>Pomme rouge</h2> - <p>Ce sont des pommes rouges vives très communes dans les supermarchés.<p> - <p>... </p> - <p>... </p> - </article> +
+

Pomme rouge

+

Ce sont des pommes rouges vives très communes dans les supermarchés.

+

...

+

...

+
- <article> - <h2>La Granny Smith</h2> - <p>Ces pommes juteuses, vertes, font une très belle garniture pour les tartes aux pommes.<p> - <p>... </p> - <p>... </p> - </article> +
+

La Granny Smith

+

Ces pommes juteuses, vertes, font une très belle garniture pour les tartes aux pommes.

+

...

+

...

+
-</main> +
-<!-- Autre contenu -->
+ +``` -

Résultat

+### Résultat -

{{EmbedLiveSample("Exemples","300","200")}}

+{{EmbedLiveSample("Exemples","300","200")}} -

Accessibilité

+## Accessibilité -

Balisage du document

+### Balisage du document -

L'élément <main> a le rôle d'une balise main. Dans le contexte de l'accessibilité, les balises peuvent être utilisées par les outils d'assistance afin d'identifier et de naviguer rapidement entre les grandes sections d'un document. On privilégiera l'élément <main> à l'ajout du role="main", à moins qu'il faille prendre en charge d'anciens navigateurs.

+L'élément `
` a le rôle d'une [balise `main`](/fr/docs/Web/Accessibility/ARIA/Roles/Main_role). Dans le contexte de l'accessibilité, les [balises](/fr/docs/Accessibilit%C3%A9/ARIA/Techniques_ARIA) peuvent être utilisées par les outils d'assistance afin d'identifier et de naviguer rapidement entre les grandes sections d'un document. On privilégiera l'élément `
` à l'ajout du `role="main"`, à moins qu'il faille [prendre en charge d'anciens navigateurs](/fr/docs/Web/HTML/Element/main#Compatibilité_des_navigateurs). - +### Navigation rapide -

La navigation rapide (aussi appelée skip navigation ou skipnav en anglais) est une technique permettant aux outils d'assistance de passer certaines sections de contenu répétés (menu de navigation, bannières, etc.). Cela permet à l'utilisateur d'accéder plus rapidement au contenu principal de la page.

+La navigation rapide (aussi appelée _skip navigation_ ou _skipnav_ en anglais) est une technique permettant aux outils d'assistance de passer certaines sections de contenu répétés (menu de navigation, bannières, etc.). Cela permet à l'utilisateur d'accéder plus rapidement au contenu principal de la page. -

Ajouter un attribut {{htmlattrxref("id")}} à l'élément <main> lui permet d'être une cible pour la navigation rapide.

+Ajouter un attribut {{htmlattrxref("id")}} à l'élément `
` lui permet d'être une cible pour la navigation rapide. -
<body>
-  <a href="#main-content">Aller au contenu principal</a>
+    
+      Aller au contenu principal
 
-  <!-- Contenu relatif à la navigation et en-tête du document -->
+      
 
-  <main id="main-content">
-    <!-- Contenu principal de la page -->
-  </main>
-</body>
-
+
+ +
+ - +- [WebAIM : Liens et navigation rapide (en anglais)](https://webaim.org/techniques/skipnav/) -

Mode lecture

+### Mode lecture -

Les fonctionnalités « mode lecture » d'un navigateur vérifient la présence d'un élément <main> ainsi que la présence de titres et de sections lors de la convertion du document pour le mode lecture.

+Les fonctionnalités « mode lecture » d'un navigateur vérifient la présence d'un élément `
` ainsi que la présence de [titres](/fr/docs/Web/HTML/Element/Heading_Elements) et de [sections](/fr/docs/Web/HTML/Element#Sectionnement_du_contenu) lors de la convertion du document pour le mode lecture. - +- [Construire des sites web pour le mode lecture de Safari et pour les autres applications de lecture (en anglais)](https://medium.com/@mandy.michael/building-websites-for-safari-reader-mode-and-other-reading-apps-1562913c86c9) -

Résumé technique

+## Résumé technique - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + +
Categories de contenuContenu de flux, contenu tangible.
Contenu autoriséContenu de flux.
Omission de baliseAucune, les balises d'ouverture et de fermeture sont toutes les deux obligatoires.
Éléments parents autorisésTout élément qui accepte du contenu de flux, uniquement si c'est un élément hiérarchiquement correct pour un élément <main>.
Rôles ARIA autorisésLe rôle main est appliqué à <main> par défaut, et le rôle presentation est également autorisé.
Interface DOM{{domxref("HTMLElement")}}
+ Categories de contenu + + Contenu de flux, + contenu tangible. +
Contenu autorisé + Contenu de flux. +
Omission de balise + Aucune, les balises d'ouverture et de fermeture sont toutes les deux + obligatoires. +
Éléments parents autorisés + Tout élément qui accepte du + contenu de flux, uniquement si c'est + un élément hiérarchiquement correct pour un élément + <main>. +
Rôles ARIA autorisés + Le rôle main est appliqué à <main> par + défaut, et le rôle presentation est également autorisé. +
Interface DOM{{domxref("HTMLElement")}}
-

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('HTML5.1', 'grouping-content.html#the-main-element', '<main>')}}{{Spec2('HTML5.1')}}Pas de changement de {{SpecName('HTML5 W3C')}}
{{SpecName('HTML WHATWG', '#semantics.html#the-main-element', '<main>')}}{{Spec2('HTML WHATWG')}}Retrait de la restriction sur l'interdiction de l'utilisation de l'élément <main> comme descendant d'un élément {{HTMLElement("article")}}, {{HTMLElement("aside")}}, {{HTMLElement("footer")}}, {{HTMLElement("header")}}, ou {{HTMLElement("nav")}}. Retrait de la restriction interdisant d'utiliser plusieurs fois <main> dans un document.
{{SpecName('HTML5 W3C', 'grouping-content.html#the-main-element', '<main>')}}{{Spec2('HTML5 W3C')}}Définition intiale.
+## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| {{SpecName('HTML5.1', 'grouping-content.html#the-main-element', '<main>')}} | {{Spec2('HTML5.1')}} | Pas de changement de {{SpecName('HTML5 W3C')}} | +| {{SpecName('HTML WHATWG', '#semantics.html#the-main-element', '<main>')}} | {{Spec2('HTML WHATWG')}} | Retrait de la restriction sur l'interdiction de l'utilisation de l'élément `
` comme descendant d'un élément {{HTMLElement("article")}}, {{HTMLElement("aside")}}, {{HTMLElement("footer")}}, {{HTMLElement("header")}}, ou {{HTMLElement("nav")}}. Retrait de la restriction interdisant d'utiliser plusieurs fois `
` dans un document. | +| {{SpecName('HTML5 W3C', 'grouping-content.html#the-main-element', '<main>')}} | {{Spec2('HTML5 W3C')}} | Définition intiale. | + +## Compatibilité des navigateurs + +{{Compat("html.elements.main")}} + +## Voir aussi + +- Les éléments qui permettent de structurer un document HTML + + - {{HTMLElement("html")}} + - {{HTMLElement("head")}} + - {{HTMLElement("body")}} + +- Les éléments liés au plan d'un document HTML : -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- -
-
    -
  • Les éléments qui permettent de structurer un document HTML -
      -
    • {{HTMLElement("html")}}
    • -
    • {{HTMLElement("head")}}
    • -
    • {{HTMLElement("body")}}
    • -
    -
  • -
  • Les éléments liés au plan d'un document HTML : -
      -
    • {{HTMLElement("article")}}
    • -
    • {{HTMLElement("aside")}}
    • -
    • {{HTMLElement("footer")}}
    • -
    • {{HTMLElement("header")}}
    • -
    • {{HTMLElement("nav")}}
    • -
    -
  • -
-
+ - {{HTMLElement("article")}} + - {{HTMLElement("aside")}} + - {{HTMLElement("footer")}} + - {{HTMLElement("header")}} + - {{HTMLElement("nav")}} -- cgit v1.2.3-54-g00ecf