From 258ba7b4be62d8640477a3bd3146d08b00cb70ec Mon Sep 17 00:00:00 2001 From: julieng Date: Fri, 17 Sep 2021 20:59:20 +0200 Subject: convert content to md --- files/fr/web/css/display/index.md | 257 ++++++++++++++++---------------------- 1 file changed, 111 insertions(+), 146 deletions(-) (limited to 'files/fr/web/css/display') diff --git a/files/fr/web/css/display/index.md b/files/fr/web/css/display/index.md index 2f322c669c..c20330af76 100644 --- a/files/fr/web/css/display/index.md +++ b/files/fr/web/css/display/index.md @@ -8,22 +8,23 @@ tags: - display translation_of: Web/CSS/display --- -
{{CSSRef}}
+{{CSSRef}} -

La propriété display définit le type d'affichage utilisée pour le rendu d'un élément (de bloc ou en ligne) et la disposition utilisée pour ses éléments fils : grille ou boîtes flexibles.

+La propriété **`display`** définit le type d'affichage utilisée pour le rendu d'un élément ([de bloc ou en ligne](/fr/docs/Web/CSS/CSS_Flow_Layout)) et la disposition utilisée pour ses éléments fils : [grille](/fr/docs/Web/CSS/CSS_Grid_Layout) ou [boîtes flexibles](/fr/docs/Web/CSS/CSS_Flexible_Box_Layout). -

Le type d'affichage donné par display possède deux composantes : le type d'affichage extérieur qui définit comment la boîte participe au flux et le type d'affichage intérieur qui définit l'organisation des éléments enfants.

+Le type d'affichage donné par `display` possède deux composantes : le type d'affichage extérieur qui définit comment la boîte participe au [flux](/fr/docs/Web/CSS/CSS_Flow_Layout) et le type d'affichage intérieur qui définit l'organisation des éléments enfants. -

Certaines valeurs de display sont définies dans des spécifications séparées. Pour plus d'informations, voir la section Spécifications ci-après.

+Certaines valeurs de `display` sont définies dans des spécifications séparées. Pour plus d'informations, voir la section Spécifications ci-après. -

Syntaxe

+## Syntaxe -
/* Valeurs de type <display-outside> */
+```css
+/* Valeurs de type  */
 display: block;
 display: inline;
 display: run-in;
 
-/* Valeurs de type <display-inside> */
+/* Valeurs de type  */
 display: flow;
 display: flow-root;
 display: table;
@@ -32,12 +33,12 @@ display: grid;
 display: ruby;
 
 /* Combinaison de valeurs */
-/* <display-outside> et <display-inside> */
+/*  et  */
 display: block flow;
 display: inline table;
 display: flex run-in;
 
-/* Valeurs de type <display-listitem> */
+/* Valeurs de type  */
 display: list-item;
 display: list-item block;
 display: list-item inline;
@@ -47,7 +48,7 @@ display: list-item block flow;
 display: list-item block flow-root;
 display: flow list-item block;
 
-/* Valeurs de type <display-internal> */
+/* Valeurs de type  */
 display: table-row-group;
 display: table-header-group;
 display: table-footer-group;
@@ -61,11 +62,11 @@ display: ruby-text;
 display: ruby-base-container;
 display: ruby-text-container;
 
-/* Valeurs de type <display-box> */
+/* Valeurs de type  */
 display: contents;
 display: none;
 
-/* Valeurs de type <display-legacy> */
+/* Valeurs de type  */
 display: inline-block;
 display: inline-table;
 display: inline-flex;
@@ -75,161 +76,125 @@ display: inline-grid;
 display: inherit;
 display: initial;
 display: unset;
-
+``` -

La propriété display est définie à l'aide de mots-clés. Ces valeurs sont rangées selon six catégories.

+La propriété `display` est définie à l'aide de mots-clés. Ces valeurs sont rangées selon six catégories. -
-
{{CSSxRef("<display-outside>")}}
-
Ces mots-clés définissent le type d'affichage extérieur de l'élément. Autrement dit, ils définissent comment l'élément participe au flux.
-
{{CSSxRef("<display-inside>")}}
-
Ces mots-clés définissent le type d'affichage intérieur de l'élément qui définit le contexte de formatage qui organisera le contenu de l'élément (si celui-ci n'est pas un élément remplacé).
-
{{CSSxRef("<display-listitem>")}}
-
L'élément génère une boîte de bloc pour le contenu et une boîte en ligne séparée pour l'élément de liste.
-
{{CSSxRef("<display-internal>")}}
-
Certains modes de dispositions, tels que table et ruby possèdent une structure interne complexe avec différents rôles possibles pour les éléments descendants. Cette section définit ces rôles internes qui s'appliquent uniquement pour un mode de disposition donné.
-
{{CSSxRef("<display-box>")}}
-
Ces valeurs définissent si un élément génère une boîte ou non.
-
{{CSSxRef("<display-legacy>")}}
-
CSS 2 utilise une syntaxe avec un seul mot-clé pour la propriété display et il faut donc des mots-clés distincts pour les variantes bloc/en ligne d'un même mode de disposition.
-
+- {{CSSxRef("<display-outside>")}} + - : Ces mots-clés définissent le type d'affichage extérieur de l'élément. Autrement dit, ils définissent comment l'élément participe au flux. +- {{CSSxRef("<display-inside>")}} + - : Ces mots-clés définissent le type d'affichage intérieur de l'élément qui définit le contexte de formatage qui organisera le contenu de l'élément (si celui-ci n'est pas un élément remplacé). +- {{CSSxRef("<display-listitem>")}} + - : L'élément génère une boîte de bloc pour le contenu et une boîte en ligne séparée pour l'élément de liste. +- {{CSSxRef("<display-internal>")}} + - : Certains modes de dispositions, tels que `table` et `ruby` possèdent une structure interne complexe avec différents rôles possibles pour les éléments descendants. Cette section définit ces rôles internes qui s'appliquent uniquement pour un mode de disposition donné. +- {{CSSxRef("<display-box>")}} + - : Ces valeurs définissent si un élément génère une boîte ou non. +- {{CSSxRef("<display-legacy>")}} + - : CSS 2 utilise une syntaxe avec un seul mot-clé pour la propriété `display` et il faut donc des mots-clés distincts pour les variantes bloc/en ligne d'un même mode de disposition. -

Valeurs historiques de display

+### Valeurs historiques de `display` -

La spécification de niveau 3 permet d'utiliser deux valeurs pour définir la propriété display afin de définir explicitement le type d'affichage intérieur et le type d'affichage extérieur. Toutefois, cette syntaxe sur deux valeurs n'est pas encore prise en charge de façon homogène par les navigateurs.

+La spécification de niveau 3 permet d'utiliser deux valeurs pour définir la propriété `display` afin de définir explicitement le type d'affichage intérieur et le type d'affichage extérieur. Toutefois, cette syntaxe sur deux valeurs n'est pas encore prise en charge de façon homogène par les navigateurs. -

Les méthodes d'affichage historiques permettent d'obtenir les mêmes résultats avec un seul mot-clé. Ces valeurs devraient être privilégiées tant que la prise en charge de la syntaxe sur deux valeurs n'est pas mieux prise en charge. Ainsi, il est possible d'utiliseur deux valeur afin de définir un conteneur flexible en ligne :

+Les méthodes d'affichage historiques permettent d'obtenir les mêmes résultats avec un seul mot-clé. Ces valeurs devraient être privilégiées tant que la prise en charge de la syntaxe sur deux valeurs n'est pas mieux prise en charge. Ainsi, il est possible d'utiliseur deux valeur afin de définir un conteneur flexible en ligne : -
.container {
+```css
+.container {
   display: inline flex;
-}
+} +``` -

On pourra obtenir un comportement équivalent en écrivant cela avec une seule valeur.

+On pourra obtenir un comportement équivalent en écrivant cela avec une seule valeur. -
.container {
+```css
+.container {
   display: inline-flex;
 }
-
+``` -

Syntaxe formelle

+### Syntaxe formelle {{csssyntax}} -

Exemples

+## Exemples -

En plus de l'exemple qui suit, vous pouvez voir d'autres exemples sur les sections dédiées aux différents modes de disposition :

+En plus de l'exemple qui suit, vous pouvez voir d'autres exemples sur les sections dédiées aux différents modes de disposition : - +- [Grilles CSS](/fr/docs/Web/CSS/CSS_Grid_Layout) +- [Boîtes flexibles (_flexbox_) CSS](/fr/docs/Web/CSS/CSS_Flexible_Box_Layout) +- [Apprendre la disposition en CSS](/fr/docs/Apprendre/CSS/CSS_layout) -

HTML

+### HTML -
<p>
+```html
+

   Texte visible
-</p>
-<p class="secret">
+

+

   Texte invisible
-</p>
+

+``` -

CSS

+### CSS -
p.secret {
+```css
+p.secret {
   display: none;
-}
- -

Résultat

- -

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

- -

Accessibilité

- -

display: none;

- -

Utiliser la propriété display avec la valeur none sur un élément entraînera son retrait de l'arbre d'accessibilité. Cet élément ainsi que ses descendants ne seront plus annoncés par les lecteurs d'écrans.

- -

Si vous souhaitez masquer un élément visuellement, une alternative plus accessible consiste à utiliser une combinaison de propriétés afin de le retirer de l'écran mais de le conserver lisible pour les technologies d'assistance.

- -

display: contents;

- -

Tout élément ciblé avec display: contents sera retiré de l'arbre d'accessibilité par la plupart des navigateurs. Ainsi, l'élément et ses descendants ne seront plus annoncés par les outils d'assistance tels que les lecteurs d'écran. Ce comportement est incorrect selon la spécification CSSWG.

- - - -

Les tableaux

- -

Modifier la valeur de display pour un élément de tableau afin d'utiliser la valeur block, grid ou flex modifiera sa représentation au sein de l'arbre d'accessibilité. Aussi, le tableau ne sera plus correctement annoncé par les technologies d'assistance.

- - - -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('CSS3 Display', '#the-display-properties', 'display')}}{{Spec2('CSS3 Display')}}Ajout des valeurs run-in, contents, flow, flow-root et des valeurs avec plusieurs mots-clés.
{{SpecName('CSS3 Ruby', '#ruby-display', 'display')}}{{Spec2('CSS3 Ruby')}}Ajout des valeurs ruby, ruby-base, ruby-text, ruby-base-container et ruby-text-container.
{{SpecName('CSS3 Grid', '#grid-containers', 'display')}}{{Spec2('CSS3 Grid')}}Ajout des valeurs pour le modèle de boîtes en grille.
{{SpecName('CSS3 Flexbox', '#flex-containers', 'display')}}{{Spec2('CSS3 Flexbox')}}Ajout des valeurs pour le modèle de boîtes flexibles.
{{SpecName('CSS2.1', 'visuren.html#display-prop', 'display')}}{{Spec2('CSS2.1')}}Ajout des valeurs pour le modèle de boîte pour les tableaux et de la valeur inline-block.
{{SpecName('CSS1', '#display', 'display')}}{{Spec2('CSS1')}}Définition initiale. Définitions des valeurs basiques : none, block, inline, et list-item.
- -

{{cssinfo}}

- -

Compatibilité des navigateurs

- -

{{Compat("css.properties.display",10)}}

- -

Voir aussi

- - +} +``` + +### Résultat + +{{EmbedLiveSample("Exemples", 300, 60)}} + +## Accessibilité + +### `display: none;` + +Utiliser la propriété `display` avec la valeur `none` sur un élément entraînera son retrait de l'[arbre d'accessibilité](/fr/docs/Learn/Accessibility/What_is_accessibility#Accessibility_APIs). Cet élément ainsi que ses descendants ne seront plus annoncés par les lecteurs d'écrans. + +Si vous souhaitez masquer un élément visuellement, une alternative plus accessible consiste à utiliser [une combinaison de propriétés](https://gomakethings.com/hidden-content-for-better-a11y/#hiding-the-link) afin de le retirer de l'écran mais de le conserver lisible pour les technologies d'assistance. + +### `display: contents;` + +Tout élément ciblé avec `display: contents` sera retiré de l'arbre d'accessibilité par la plupart des navigateurs. Ainsi, l'élément et ses descendants ne seront plus annoncés par les outils d'assistance tels que les lecteurs d'écran. Ce comportement est incorrect selon [la spécification CSSWG](https://drafts.csswg.org/css-display/#the-display-properties). + +- [`display: contents` n'est pas un outil de réinitialisation CSS, par Adrian Roselli, en anglais](https://adrianroselli.com/2018/05/display-contents-is-not-a-css-reset.html) +- [Obtenir un balisage plus accessible grâce à `display: contents`, en anglais, par Hidde de Vries](https://hiddedevries.nl/en/blog/2018-04-21-more-accessible-markup-with-display-contents) + +### Les tableaux + +Modifier la valeur de `display` pour un élément de [tableau](/en-US/docs/Web/HTML/Element/table) afin d'utiliser la valeur `block`, `grid` ou `flex` modifiera sa représentation au sein de l'[arbre d'accessibilité](/fr/docs/Learn/Accessibility/What_is_accessibility#Accessibility_APIs). Aussi, le tableau ne sera plus correctement annoncé par les technologies d'assistance. + +- [Une rapide note sur l'impact de la propriété CSS `display` sur la sémantique des tableaux — The Paciello Group (en anglais)](https://developer.paciellogroup.com/blog/2018/03/short-note-on-what-css-display-properties-do-to-table-semantics/) +- [Du contenu masqué avec une meilleure accessibilité - Go Make Things (en anglais)](https://gomakethings.com/hidden-content-for-better-a11y/) +- [Comprendre les règles WCAG 1.3](/fr/docs/Web/Accessibility/Understanding_WCAG/Perceivable#Guideline_1.3_%E2%80%94_Create_content_that_can_be_presented_in_different_ways) +- [_Understanding Success Criterion 1.3.1, W3C Understanding WCAG 2.0_ (en anglais)](https://www.w3.org/TR/UNDERSTANDING-WCAG20/content-structure-separation-programmatic.html) + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------- | +| {{SpecName('CSS3 Display', '#the-display-properties', 'display')}} | {{Spec2('CSS3 Display')}} | Ajout des valeurs `run-in`, `contents`, `flow`, `flow-root` et des valeurs avec plusieurs mots-clés. | +| {{SpecName('CSS3 Ruby', '#ruby-display', 'display')}} | {{Spec2('CSS3 Ruby')}} | Ajout des valeurs `ruby`, `ruby-base`, `ruby-text`, `ruby-base-container` et `ruby-text-container`. | +| {{SpecName('CSS3 Grid', '#grid-containers', 'display')}} | {{Spec2('CSS3 Grid')}} | Ajout des valeurs pour le modèle de boîtes en grille. | +| {{SpecName('CSS3 Flexbox', '#flex-containers', 'display')}} | {{Spec2('CSS3 Flexbox')}} | Ajout des valeurs pour le modèle de boîtes flexibles. | +| {{SpecName('CSS2.1', 'visuren.html#display-prop', 'display')}} | {{Spec2('CSS2.1')}} | Ajout des valeurs pour le modèle de boîte pour les tableaux et de la valeur `inline-block.` | +| {{SpecName('CSS1', '#display', 'display')}} | {{Spec2('CSS1')}} | Définition initiale. Définitions des valeurs basiques : `none`, `block`, `inline`, et `list-item`. | + +{{cssinfo}} + +## Compatibilité des navigateurs + +{{Compat("css.properties.display",10)}} + +## Voir aussi + +- {{cssxref("visibility")}} +- {{cssxref("float")}} +- {{cssxref("position")}} +- {{cssxref("flex")}} +- {{cssxref("grid")}} +- [Explications sur les contextes de formatage](/fr/docs/Web/CSS/CSS_Flow_Layout/Explications_contextes_formatage) +- [Les dispositions de bloc et en ligne dans un flux normal](/fr/docs/Web/CSS/CSS_Flow_Layout/Disposition_de_bloc_en_ligne_avec_flux_normal) -- cgit v1.2.3-54-g00ecf