Modèle:Boîte déroulante/Documentation

Ceci est la page de documentation du modèle {{Boîte déroulante}}.
Cette page n’est pas destinée à être visualisée directement. Les liens utilisant des pseudo-variables peuvent paraître rompus (en rouge) ; ne pas les remplacer par des noms de pages codés en dur ni des URL.

Cette documentation concerne

• le modèle {{Boîte déroulante}}
• le modèle {{Boîte déroulante début}} (qui s’utilise avec {{Boîte déroulante fin}}) et permet de mettre un contenu plus varié.

Recommandation

Limiter l’utilisation de boîtes déroulantes

Ne pas utiliser de boîte déroulante à l’intérieur d’une boîte déroulante

Utiliser {{Boîte déroulante début}} pour mettre un tableau dans une boite déroulante.

Utilisation

{{Boîte déroulante}}

{{boîte déroulante|titre=TITRE|contenu=CONTENU}}
{{boîte déroulante|align=ALIGN|alignT=ALIGNT|titre=TITRE|label=LABEL|contenu=CONTENU|largeur=LARGEUR|hauteur=HAUTEUR}}

Utilisation

{{Boîte déroulante début}}

{{boîte déroulante début|titre=TITRE}}
Contenu
{{boîte déroulante fin}}

Paramètres obligatoires
paramètre	effet	valeurs possibles
titre	Titre affiché de la boîte	Totalement libre
contenu	Texte contenu dans la boîte	Totalement libre, mais certains caractères spéciaux ne passent pas. Utiliser dans ce cas "{{Boîte déroulante début}} contenu {{Boîte déroulante fin}}".
Paramètres facultatifs
paramètre	effet	valeur par défaut	valeurs possibles
br	saut de ligne en entête	br=yes	br=no pour les boites déroulantes empilées.
arrondi (désactivé)	arrondi des angles	0	Les angles peuvent apparaître arrondis si le navigateur le permet Mozilla : visible Internet explorer : non visible Valeur conseillée : 0.6em S’exprime en pt, px ou em
image	image à gauche		L’image facultative apparaît à l’ouverture de la boîte. Elle doit être totalement renseignée. Exemple : [[Image:Gtk-dialog-info.svg|15px]]
alignB	alignement de la boîte	left	left, right, center ou justify
hauteur	hauteur de la boîte repliée	1.6em	La hauteur doit être exprimée avec une unité valable. Ne pas mettre une hauteur inférieure à 1.6em sous peine d’effets indésirables
margeHaut	marge haut (avant la boîte)	0em	La hauteur doit être exprimée avec une unité valable. Il est possible de mettre 0
margeBas	marge bas (après la boîte)	1em	La hauteur doit être exprimée avec une unité valable. Il est possible de mettre 0
largeur	largeur de la boîte	100%	La largeur doit être exprimée avec une unité valable
couleurBordure	couleur de la bordure	#AAAAAA	Expression de couleur valide exemples : black, #C080FF, … Table des couleurs Modèle:Table des couleurs
couleurFondB	couleur de fond de la boîte	#FFFFFF
couleurFond	couleur de fond du contenu	white
Texte
align	alignement du contenu	left	left, right, center ou justify
alignT	alignement du titre	center
taille	taille de police du contenu	1em	libre, de préférence exprimé en em : 1em, 0.9em, etc.
label	texte du lien de droite	[ Dérouler ] / [ Enrouler ]	Totalement libre. Le caractère "/" permet de séparer les deux libellés. Exemple : [ afficher ] / [ masquer ]
couleurFondT	couleur de fond du titre	#EFEFEF	Expression de couleur valide exemples : black, #C080FF, … Table des couleurs Modèle:Table des couleurs
couleurTexteT	couleur du texte de titre	black
thinning	titre pas en gras	no	yes/no

Un modèle alternatif existe, composé de deux morceaux indissociables : {{Boîte déroulante début}} et {{Boîte déroulante fin}}, le premier accepte les mêmes paramètres que {{Boîte déroulante}}, la différence est que le contenu peut être arbitraire alors que ({{Boîte déroulante}} ne permet pas de caractères | dans le contenu).

Fichier:Gtk-dialog-info.svg par défaut (align=left, alignT=center) Lorem ipsum dolor sit amet, consectetaur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.		Contenu à droite (align=right) Lorem ipsum dolor sit amet, consectetaur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Contenu centré, titre à gauche (align=center, alignT=left) Lorem ipsum dolor sit amet, consectetaur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.		Contenu justifié, titre à droite (align=justify, alignT=right) Lorem ipsum dolor sit amet, consectetaur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
essais de couleurs pour démonstration   Fichier:Palette boîte déroulante.gif couleurBordure=green couleurFondB=lightpink couleurFondT=yellow couleurTexteT=blue couleurFond=lightcyan		Boîte déroulante avec angles ronds (arrondi=0.6em) Lorem ipsum dolor sit amet, consectetaur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.