aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/css/list-style
diff options
context:
space:
mode:
Diffstat (limited to 'files/fr/web/css/list-style')
-rw-r--r--files/fr/web/css/list-style/index.html155
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>&lt;'list-style-type'&gt;</code></dt>
+ <dd>Voir {{cssxref("list-style-type")}}</dd>
+ <dt><code>&lt;'list-style-image'&gt;</code></dt>
+ <dd>Voir {{cssxref("list-style-image")}}</dd>
+ <dt><code>&lt;'list-style-position'&gt;</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
+&lt;ul class="un"&gt;
+ &lt;li&gt;Élément 1&lt;/li&gt;
+ &lt;li&gt;Élément 2&lt;/li&gt;
+ &lt;li&gt;Élément 3&lt;/li&gt;
+&lt;/ul&gt;
+Liste 2
+&lt;ul class="deux"&gt;
+ &lt;li&gt;Élément A&lt;/li&gt;
+ &lt;li&gt;Élément B&lt;/li&gt;
+ &lt;li&gt;Élément C&lt;/li&gt;
+&lt;/ul&gt;
+</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>