View source for Template:Liste éléments/Documentation

{{Sous-page de documentation}}
{{Modèle obsolète|nouveau=Liste horizontale|message=Pour des raisons d'accessibilité, veuillez utiliser le modèle {{m|Liste horizontale}} ou la classe <code>liste-horizontale</code>.}}
{{Modèle utilisant les modules Lua|Module:Liste éléments}}
{{Modèle utilisant TemplateStyles|Liste éléments/styles.css}}

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.

== 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> (conversion automatique en tiret demi-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 pour afficher une liste horizontale, avec les éléments séparés par des puces.
* {{m|Liste verticale-horizontale}} - pour afficher une liste avec les éléments de premier niveau affichés verticalement, et les éléments de niveaux inférieurs affichés horizontalement.
* {{m|Liste simple}} - pour afficher une liste verticale classique, sans afficher les puces.
* {{m|·}} - obsolète
* {{m|Méta palette de navigation}}

{{Projet|Palette|Modèle}}
<includeonly>
[[Catégorie:Modèle de formatage de liste]]
</includeonly>