Voir la source de Modèle:Liste éléments/Documentation

{{Sous-page de documentation}}
{{Modèle utilisant les modules Lua|Module:Liste éléments}}

Ce modèle permet d'afficher une liste d'éléments séparés par une puce. Chaque élément est affiché de manière insécable, et les puces ne s'affichent jamais en début de ligne. Ce modèle est principalement destiné aux palettes de navigation.

Pour des raisons d'accessibilité, veuillez utiliser le modèle {{m|Liste horizontale}} ou la classe <code>liste-horizontale</code>.

== Syntaxe ==
<pre>{{liste éléments
 | élément 1
 | élément 2
 | et ainsi de suite
}}</pre>

On peut spécifier des paramètres optionnels « ''séparateur'' » et « ''espaces'' » :

<pre>{{liste éléments|séparateur=•|espaces=2
 | élément 1
 | élément 2
 | et ainsi de suite
}}</pre>

{| class="wikitable" style="margin-top:0.5em"
! scope="col" | Paramètre
! scope="col" | Description
! scope="col" | Valeurs possibles
! scope="col" | Valeur par défaut
|-
| '''séparateur''' <br /> <small>alias : '''sép'''</small>
| le caractère employé comme séparateur
| {{info|« · »|caractère « middot » (Alt+0183)}}, {{info|« • »|caractère « bullet » (Alt+0149)}}, <br /> {{m|espace}}…
| {{info|« · »|caractère « middot » (Alt+0183)}}
|-
| '''espaces'''
| le nombre d’espaces de chaque côté du séparateur
| 0, 1 ou 2
| 1
|-
| '''sécable'''
| si défini à « oui », les éléments seront sécables
| oui ou non
| non
|}

'''Notes :'''
* Si le séparateur est un {{info|« · »|caractère « point médian » (Alt+0183)}}, celui-ci est automatiquement mis en gras.
* On peut spécifier un séparateur spécial : « 2• » ou « •2 », qui est un alias pour « séparateur = • | espaces = 2 ». Cette technique est possible avec les caractères {{info|« • »|caractère « puce » (Alt+0149)}} et {{info|« · »|caractère « point médian » (Alt+0183)}}.
* Les espaces autour du séparateur sont insécables du séparateur ou de l'item de liste, mais un saut de ligne reste autorisé après le dernier espace et avant l'item suivant.

== Permettre la césure ==

Par défaut, les éléments sont affichés de manière insécable, mais il est possible de les rendre sécables en spécifiant un paramètre <code>sécable=oui</code> :

<pre>{{liste éléments | sécable = oui
 | Lorem ipsum dolor
 | sit amet consectetur
 | adipiscing elit sed
}}</pre>

De façon exceptionnelle, si un élément est particulièrement long et qu’il est préférable de permettre sa césure, on peut mettre celui-ci dans un modèle {{m|sécable}}, comme suit :

<pre>{{liste éléments
 | tomate
 | {{sécable|un élément long, très très long}}
 | carotte
}}</pre>

== Exemples ==

* <code><nowiki>{{liste éléments | Riri | Fifi | Loulou}}</nowiki></code>
: → &nbsp; {{liste éléments | Riri | Fifi | Loulou}}

* <code><nowiki>{{liste éléments | séparateur = 2• | Riri | Fifi | Loulou}}</nowiki></code>
: → &nbsp; {{liste éléments | séparateur = 2• | Riri | Fifi | Loulou}}

* <code><nowiki>{{liste éléments | séparateur = {{espace}} | Riri | Fifi | Loulou}}</nowiki></code>
: → &nbsp; {{liste éléments | séparateur = {{espace}} | Riri | Fifi | Loulou}}

* <code><nowiki>{{liste éléments | séparateur =, | Riri | Fifi | Loulou}}</nowiki></code> (virgule de ponctuation normale, gérée spécialement sans espace avant mais une espace après)
: → &nbsp; {{liste éléments | séparateur =, | Riri | Fifi | Loulou}}

* <code><nowiki>{{liste éléments | séparateur = - | Riri | Fifi | Loulou}}</nowiki></code> (tiret demi-cadratin)
: → &nbsp; {{liste éléments | séparateur = - | Riri | Fifi | Loulou}}

* <code><nowiki>{{liste éléments | séparateur = -- | Riri | Fifi | Loulou}}</nowiki></code> (tiret cadratin)
: → &nbsp; {{liste éléments | séparateur = -- | Riri | Fifi | Loulou}}

'''Exemple avec une palette de navigation :'''
<pre>{{Méta palette de navigation
| modèle = Modèle
| titre  = Titre

| groupe1 = nom du groupe
| liste1  = {{Liste éléments
 | Élément 1
 | Élément 2
 | Élément 3
 | Élément 4
 }}

| groupe2 = nom du groupe
| liste2  = {{Liste éléments
 | Élément 1
 | Élément 2
 | Élément 3
 | Élément 4
 }}
}}</pre>

{{Méta palette de navigation
| modèle = Modèle
| titre  = Titre
| nocat  = oui

| groupe1 = nom du groupe
| liste1  = {{Liste éléments
 | Élément 1
 | Élément 2
 | Élément 3
 | Élément 4
 }}

| groupe2 = nom du groupe
| liste2  = {{Liste éléments
 | Élément 1
 | Élément 2
 | Élément 3
 | Élément 4
 }}
}}

== Voir aussi ==
* {{m|Liste horizontale}} (modèle équivalent et accessible)
* {{m|Liste simple}}
* {{m|·}} (obsolète)
* {{m|•}} (obsolète)
* {{m|Méta palette de navigation}}
<includeonly>
[[Catégorie:Modèle de formatage]]
</includeonly>