Modèle:Liste éléments/Documentation

Ceci est la page de documentation de Modèle:Liste éléments [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

Ce modèle utilise le module Liste éléments, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via une sous-page bac à sable. Voir le Projet:Scribunto si vous voulez en savoir plus.

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 {{Liste horizontale}} ou la classe liste-horizontale.

Syntaxe

{{liste éléments
 | élément 1
 | élément 2
 | et ainsi de suite
}}

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

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

Paramètre	Description	Valeurs possibles	Valeur par défaut
séparateur alias : sép	le caractère employé comme séparateur	« · », « • », {{espace}}…	« · »
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 « · », 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 « • » et « · ».
• 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 sécable=oui :

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

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 {{sécable}}, comme suit :

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

Exemples

• {{liste éléments | Riri | Fifi | Loulou}}

→   Riri · Fifi · Loulou

• {{liste éléments | séparateur = 2• | Riri | Fifi | Loulou}}

→   Riri  •  Fifi  •  Loulou

• {{liste éléments | séparateur = {{espace}} | Riri | Fifi | Loulou}}

→   Riri Fifi Loulou

• {{liste éléments | séparateur =, | Riri | Fifi | Loulou}} (virgule de ponctuation normale, gérée spécialement sans espace avant mais une espace après)

→   Riri, Fifi, Loulou

• {{liste éléments | séparateur = - | Riri | Fifi | Loulou}} (tiret demi-cadratin)

→   Riri – Fifi – Loulou

• {{liste éléments | séparateur = -- | Riri | Fifi | Loulou}} (tiret cadratin)

→   Riri -- Fifi -- Loulou

Exemple avec une palette de navigation :

{{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
 }}
}}

Voir aussi

• {{Liste horizontale}} (modèle équivalent et accessible)
• {{Liste simple}}
• {{·}} (obsolète)
• {{•}} (obsolète)
• {{Méta palette de navigation}}