La propriété list-style-type permet de définir l'apparence d'un élément de liste. Généralement, celle-ci s'applique à l'élément <li> car il est le seul dont la propriété display vaut list-item par défaut. Toutefois, en utilisant cette valeur pour display sur d'autres éléments, on pourrait appliquer cette propriété.

Valeur initialedisc
Applicabilitééléments de liste
Héritéeoui
Médiavisuel
Valeur calculéecomme spécifié
Type d'animationdiscrète
Ordre canoniquel'ordre unique et non-ambigu défini par la grammaire formelle

La couleur de la puce utilisée sera la même que la couleur calculée de l'élément sur lequel elle s'applique.

Syntaxe

/* Liste partielle des mots-clés utilisables */
list-style-type: disc;
list-style-type: circle;
list-style-type: square;
list-style-type: decimal;
list-style-type: georgian;
list-style-type: cjk-ideographic;
list-style-type: kannada;

/* Une chaîne de caractères */
/* Type <string>            */
list-style-type: '-';

/* Un identifiant correspondant à */
/* une règle @counter-style       */
list-style-type: custom-counter-style;

list-style-type: none;

/* Valeurs globales */
list-style-type: inherit;
list-style-type: initial;
list-style-type: unset;

Valeurs

symbols()
Définit un style de puce utilisé.
none
Aucun marqueur n'est affiché.
<string>
La chaîne de caractères indiquée sera utilisée comme puce
<custom-ident>
Un identifiant correspondant à la valeur d'un @counter-style ou à un style prédéfini :
disc
  • Un disque plein (la valeur par défaut)
circle
  • Un cercle vide
square
  • Un carré plein
decimal
  • Des nombres en base 10
  • Commençant par 1
cjk-decimal
  • Nombres décimaux Han
  • E.g. 一, 二, 三, ..., 九八, 九九, 一〇〇
decimal-leading-zero
  • Nombres en base 10
  • Avec des 0 devant
  • E.g. 01, 02, 03, … 98, 99
lower-roman
  • Nombres romains minuscules
  • Par exemple i, ii, iii, iv, v…
upper-roman
  • Nombres romains en majuscules
  • Par exemple I, II, III, IV, V…
lower-greek
  • Lettres grecques minuscules
  • alpha, beta, gamma…
  • Par exemple α, β, γ…
lower-alpha
lower-latin
  • Lettres ASCII en minuscules
  • Par exemple a, b, c, … z
  • lower-latin n'est pas pris en charge par les versions avant IE7
  • Voir le tableau de compatibilité
upper-alpha
upper-latin
  • Lettres ASCII en majuscules
  • Par exemple A, B, C, … Z
  • upper-latin n'est pas pris en charge par les versions avant IE7
arabic-indic
-moz-arabic-indic
  • Exemple
armenian
  • Système de numérotation arménien
  • (ayb/ayp, ben/pen, gim/keem…
bengali
-moz-bengali
  • Exemple
cambodian *
  • Exemple
  • est un synonyme pour khmer
cjk-earthly-branch
-moz-cjk-earthly-branch
  • Exemple
cjk-heavenly-stem
-moz-cjk-heavenly-stem
  • Exemple
cjk-ideographic
  • Identique à trad-chinese-informal
  • E.g. 一萬一千一百一十一
devanagari
-moz-devanagari
  • Exemple
ethiopic-numeric
  • Exemple
georgian
  • Système de numérotation géorgien
  • Par exemple an, ban, gan, … he, tan, in…
gujarati
-moz-gujarati
  • Exemple
gurmukhi
-moz-gurmukhi
  • Exemple
hebrew
  • Système de numérotation hébreux
hiragana
  • a, i, u, e, o, ka, ki, …
  • (Japonais)
hiragana-iroha
  • i, ro, ha, ni, ho, he, to, …
  • Iroha est l'ancien ordre japonais pour les syllabes.
japanese-formal
  • Système de numérotation japonais formel utilisé pour les documents légaux ou financiers.
  • E.g., 壱萬壱阡壱百壱拾壱
  • Ces kanjis ont été conçus afin de ne pas pouvoir être confondus avec d'autres
japanese-informal
  • Système de numérotation japonais informel
kannada
-moz-kannada
  • Exemple
katakana
  • A, I, U, E, O, KA, KI, …
  • (Japonais)
katakana-iroha
  • I, RO, HA, NI, HO, HE, TO, …
  • Iroha correspond à l'ancien ordre japonais pour les syllabes.
khmer
-moz-khmer
  • Exemple
korean-hangul-formal
  • Système de numérotation coréen hangul .
  • E.g., 일만 일천일백일십일
korean-hanja-formal
  • Système de numérotation formel coréen Han.
  • E.g. 壹萬 壹仟壹百壹拾壹
korean-hanja-informal
  • Système de numérotation coréen hanja numbering.
  • E.g., 萬 一千百十一
lao
-moz-lao
  • Exemple
lower-armenian *
  • Exemple
malayalam
-moz-malayalam
  • Exemple
mongolian
  • Exemple
myanmar
-moz-myanmar
  • Exemple
oriya
-moz-oriya
  • Exemple
persian
-moz-persian
  • Exemple
simp-chinese-formal
  • Système de numérotation formel chinois simplifié.
  • E.g. 壹万壹仟壹佰壹拾壹
simp-chinese-informal
  • Système de numérotation informel chinois simplifié.
  • E.g. 一万一千一百一十一
tamil
-moz-tamil
  • Exemple
telugu
-moz-telugu
  • Exemple
thai
-moz-thai
  • Exemple
tibetan *
  • Exemple
trad-chinese-formal
  • Système de numérotation formel chinois traditionnel.
  • E.g. 壹萬壹仟壹佰壹拾壹
trad-chinese-informal
  • Système de numérotation informel chinois traditionnel.
  • E.g. 一萬一千一百一十一
upper-armenian *
  • Exemple
disclosure-open
  • Symbole indiquant qu'un widget (comme <details>) est ouvert.
disclosure-closed
  • Symbole indiquant qu'un widget (comme <details>) est fermé.

Extensions non-standards

D'autres types sont fournis par Gecko (Firefox), Blink (Chrome and Opera) and WebKit (Safari) mais ne sont pas standards. Pour voir les différents navigateurs les supportant, se référer au tableau de compatibilité en bas de page.

-moz-ethiopic-halehame
  • Exemple
-moz-ethiopic-halehame-am
  • Exemple
ethiopic-halehame-ti-er
-moz-ethiopic-halehame-ti-er
  • Exemple
ethiopic-halehame-ti-et
-moz-ethiopic-halehame-ti-et
  • Exemple
hangul
-moz-hangul
  • Exemple
  • Exemple
  • Exemple
hangul-consonant
-moz-hangul-consonant
  • Exemple
  • Exemple
  • Exemple
urdu
-moz-urdu
  • Exemple

Syntaxe formelle

<counter-style> | <string> | none


<counter-style> = <counter-style-name> | symbols()


<counter-style-name> = <custom-ident>

Exemples

CSS

ol.normal {
  list-style-type: upper-alpha;
}

/* on peut aussi utiliser la propriété raccourcie */
/* "list-style": */
ol.shortcut {
  list-style: upper-alpha;
}

HTML

<ol class="normal">Liste 1
  <li>Coucou</li>
  <li>Monde</li>
  <li>Comment ça va ?</li>
</ol>

<ol class="shortcut">Liste 2
  <li>On a</li>
  <li>le</li>
  <li>même</li>
  <li>résultat</li>
</ol>

Résultat

Notes

  • Pour certains types, il est nécessaire d'avoir une police correspondante installée pour que l'affichage fonctionne.
  • Pour des raisons historiques, cjk-ideographic est synonyme de trad-chinese-informal.

Spécifications

Spécification Statut Commentaires
CSS Counter Styles Level 3
La définition de 'list-style-type' dans cette spécification.
Candidat au statut de recommandation Les compteurs CSS2.1 sont redéfinis.
La syntaxe est étendue pour prendre en charge les règles @counter-style.
Définition des types : hebrew, cjk-ideographic, hiragana, hiragana-iroha, katakana, katakana-iroha, japanese-formal, japanese-informal, simp-chinese-formal, trad-chinese-formal, simp-chinese-formal, trad-chinese-formal,korean-hangul-formal, korean-hanja-informal, korean-hanja-formal, cjk-decimal, ethiopic-numeric, disclosure-open et disclosure-closed.
<counter-style> est étendu avec la notation fonctionnelle symbols().
CSS Lists and Counters Module Level 3
La définition de 'list-style-type' dans cette spécification.
Version de travail La syntaxe est modifiée pour prendre en charge les identifiants utilisés avec les règles @counter-style.
Prise en charge du type <string>.
CSS Level 2 (Revision 1)
La définition de 'list-style-type' dans cette spécification.
Recommendation

Définition initiale.

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Edge Internet Explorer Opera Safari (WebKit)
Support simple pour :
none, disc, circle, square, decimal, lower-alpha, upper-alpha, lower-roman, upper-roman
1.0 1.0 (1.0) (Oui) 4.0 3.5 1.0 (85)
lower-latin, upper-latin, lower-greek, armenian, georgian 1.0 1.0 (1.0) ? 8.0 6.0 1.0 (85)
decimal-leading-zero 1.0 1.0 (1.0) ? 8.0 8.0 1.0 (85)
hebrew, cjk-ideographic, hiragana, hiragana-iroha, katakana, katakana-iroha 1.0 1.0 (1.0) ? Pas de support 7.0 (avec des chiffres en base 10 à la place)
15.0
1.0-1.2 (85-125)
japanese-formal, japanese-informal, simp-chinese-formal, trad-chinese-formal, simp-chinese-informal, trad-chinese-informal Pas de support 1.0 (1.7 ou moins) -moz
28.0 (28.0)
? Pas de support Pas de support Pas de support
korean-hangul-formal, korean-hanja-informal, korean-hanja-formal, cjk-decimal Pas de support 28.0 (28.0) ? Pas de support Pas de support

Pas de support

 

ethiopic-numeric, persian, arabic-indic, devanagari, bengali, gurmukhi, gujarati, oriya, tamil, telugu, kannada, malayalam, thai, lao, myanmar, khmer, cjk-heavenly-stem, cjk-earthly-branch Pas de support 1.0 (1.7 ou moins) -moz
33.0 (33.0) [1]
? Pas de support Pas de support

Pas de support

disclosure-open, disclosure-closed, mongolian Pas de support 33.0 (33.0) ? Pas de support Pas de support Pas de support
<string> Pas de support 39.0 (39.0) ? Pas de support Pas de support Pas de support
Fonctionnalité Android Firefox Mobile (Gecko) Edge IE Phone Opera Mobile Safari Mobile
Support simple ? ? ? ? ? ?

[1] Avant Firefox 38, Gecko ajoutait un point comme suffixe à l'indice appliqué par ethiopic-numeric (፫. au lieu de ፫). La spécification a évolué et définit l'absence d'un tel suffixe. Gecko a été adapté dans les versions ultérieures.

Voir aussi

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : SphinxKnight, fscholz, Goofy, teoli, Sebastianz, FredB, Mgjbot, ethertank, Fredchat, Kyodev, VincentN
 Dernière mise à jour par : SphinxKnight,