Aller au contenu

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

Wikipedia, ɔnsikopedi hɔrɔn ka nyɛ

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

Recommandations (voir Aide:Boîte déroulante et autres modèles déroulants) :

  • 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 : pour {{Boîte déroulante}}

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

Utilisation : pour {{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, mais le caractère « | » par exemple ne passe pas.
contenu Texte contenu dans la boîte Totalement libre, mais certains caractères spéciaux ne passent pas, comme la barre verticale. 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 boîtes déroulantes empilées.
arrondi (désactivé) arrondi des angles 0 Les angles peuvent apparaître arrondis si le navigateur le permet.
Visible sur les navigateurs Mozilla, non visible sur Internet Explorer.
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 : [[Fichier: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, …
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 ].
NB : Cette valeur dépend du common.js, la valeur par défaut peut être personnalisable dans votre propre JS si ce paramètre n'est pas déjà indiqué.
couleurFondT couleur de fond du titre #EFEFEF Expression de couleur valide
exemples : black, #C080FF, …
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).


 
 
 
Comparaison des modèles de navigation
voir • disc. • mod.
Enroulable Couleur
d’entête
Image Groupes Paramètres
style (Entête)
Paramètres
style (corps)
Exemple
Modèles pour palettes de navigation dédiées aux bas de pages
{{Méta palette de navigation}} collapsible navbox Corps + En-tête Oui Oui Oui Exemples
{{Boîte déroulante}} NavFrame NavHead Corps Non Oui Oui -
Modèles pour palettes de navigation dédiées aux débuts d’articles
{{Wikilien}} N/A N/A Oui N/A N/A Oui Méta-modèle