diff options
Diffstat (limited to 'files/fr/web/css/list-style')
-rw-r--r-- | files/fr/web/css/list-style/index.html | 155 |
1 files changed, 155 insertions, 0 deletions
diff --git a/files/fr/web/css/list-style/index.html b/files/fr/web/css/list-style/index.html new file mode 100644 index 0000000000..19fcbef3f3 --- /dev/null +++ b/files/fr/web/css/list-style/index.html @@ -0,0 +1,155 @@ +--- +title: list-style +slug: Web/CSS/list-style +tags: + - CSS + - Propriété + - Reference +translation_of: Web/CSS/list-style +--- +<div>{{CSSRef}}</div> + +<p>La propriété <strong><code>list-style</code></strong> est une <a href="/fr/docs/Web/CSS/Propriétés_raccourcies">propriété raccourcie</a> qui permet de définir {{cssxref("list-style-type")}}, {{cssxref("list-style-image")}} et {{cssxref("list-style-position")}}.</p> + +<div>{{EmbedInteractiveExample("pages/css/list-style.html")}}</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> + +<div class="note"> +<p><strong>Note :</strong> Cette propriété s'applique aux éléments d'une liste (c'est-à-dire aux éléments pour lesquels {{cssxref("display")}}<code>: list-item</code><code>;</code>}}). Par défaut, cela inclut les éléments {{HTMLElement("li")}}. Cette propriété peut être héritée par les éléments et si on veut donc gérer une liste de façon uniforme, on pourra appliquer la propriété à l'élément parent (qui correspond en général à {{HTMLElement("ol")}} ou à {{HTMLElement("ul")}}).</p> +</div> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="brush:css no-line-numbers">/* Type */ +list-style: square; + +/* Image */ +list-style: url('../img/etoile.png'); + +/* Position */ +list-style: inside; + +/* type | position */ +list-style: georgian inside; + +/* type | image | position */ +list-style: lower-roman url('../img/etoile.png') outside; + +list-style: none; + +/* Valeurs globales */ +list-style: inherit; +list-style: initial; +list-style: unset; +</pre> + +<h3 id="Valeurs">Valeurs</h3> + +<p>Cette propriété raccourcie peut prendre un, deux ou trois mots-clés, dans n'importe quel ordre. Si {{cssxref("list-style-type")}} et {{cssxref("list-style-image")}} sont tous les deux définis, <code>list-style-type</code> sera utilisé si l'image est indisponible.</p> + +<dl> + <dt><code><'list-style-type'></code></dt> + <dd>Voir {{cssxref("list-style-type")}}</dd> + <dt><code><'list-style-image'></code></dt> + <dd>Voir {{cssxref("list-style-image")}}</dd> + <dt><code><'list-style-position'></code></dt> + <dd>Voir {{cssxref("list-style-position")}}</dd> + <dt><code>none</code></dt> + <dd>Aucun style n'est utilisé.</dd> +</dl> + +<h3 id="Syntaxe_formelle">Syntaxe formelle</h3> + +<pre class="syntaxbox">{{csssyntax}}</pre> + +<h2 id="Exemples">Exemples</h2> + +<h3 id="CSS">CSS</h3> + +<pre class="brush: css">.un { + list-style: circle; +} + +.deux { + list-style: square inside; +}</pre> + +<h3 id="HTML">HTML</h3> + +<pre class="brush: html">Liste 1 +<ul class="un"> + <li>Élément 1</li> + <li>Élément 2</li> + <li>Élément 3</li> +</ul> +Liste 2 +<ul class="deux"> + <li>Élément A</li> + <li>Élément B</li> + <li>Élément C</li> +</ul> +</pre> + +<h3 id="Résultat">Résultat</h3> + +<p>{{EmbedLiveSample('Exemples','auto', 220)}}</p> + +<h2 id="Accessibilité">Accessibilité</h2> + +<p>Safari ne reconnait pas (incorrectement) les listes non ordonnées lorsque <code>list-style:none</code> leur est appliqué et ne les ajoute pas dans l'arbre d'accessibilité (utilisé par les lecteurs d'écrans). Pour pallier ce problème, on peut ajouter un <a href="https://fr.wikipedia.org/wiki/Espace_sans_chasse">espace sans chasse</a> comme <a href="/fr/docs/Web/CSS/content">pseudo-contenu</a> avant chaque élément de liste afin que la liste soit correctement annoncée.</p> + +<pre class="brush: css">ul { + list-style: none; +} + +ul li::before { + content: "\200B"; +} +</pre> + +<ul> + <li><a href="https://unfetteredthoughts.net/2017/09/26/voiceover-and-list-style-type-none/">VoiceOver et <code>list-style-type: none</code> – Unfettered Thoughts (en anglais)</a></li> + <li><a href="/fr/docs/Web/Accessibility/Understanding_WCAG/Perceivable#Guideline_1.3_%E2%80%94_Create_content_that_can_be_presented_in_different_ways">Comprendre les règles WCAG 1.3</a></li> + <li><em><a href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/content-structure-separation-programmatic.html" rel="noopener">Understanding Success Criterion 1.3.1, W3C Understanding WCAG 2.0 </a></em><a href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/content-structure-separation-programmatic.html" rel="noopener">(en anglais)</a></li> +</ul> + +<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('CSS3 Lists', '#list-style-property', 'list-style')}}</td> + <td>{{Spec2('CSS3 Lists')}}</td> + <td>Aucun changement.</td> + </tr> + <tr> + <td>{{SpecName('CSS2.1', 'generate.html#propdef-list-style', 'list-style')}}</td> + <td>{{Spec2('CSS2.1')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<p>{{cssinfo}}</p> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div> + +<p>{{Compat("css.properties.list-style")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{cssxref("list-style-type")}}</li> + <li>{{cssxref("list-style-image")}}</li> + <li>{{cssxref("list-style-position")}}</li> +</ul> |