Voir la source de Modèle:Boîte déroulante/Documentation

<noinclude>{{Documentation modèle vue directement}}</noinclude>
;Cette documentation concerne :
* le modèle '''{{M|Boîte déroulante}}'''
* le modèle '''{{M|Boîte déroulante/début}}''' (qui s’utilise avec {{M|Boîte déroulante/fin}}) et permet de mettre un contenu plus varié.

'''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 {{M|Boîte déroulante/début}} pour mettre un tableau dans une boite déroulante.

'''Utilisation :''' pour {{M|Boîte déroulante}}
 <nowiki>{{boîte déroulante|titre=TITRE|contenu=CONTENU}}</nowiki>
 '''OU'''
 <nowiki>{{boîte déroulante
 |align=ALIGN
 |alignT=ALIGNT
 |titre=TITRE
 |label=LABEL
 |contenu=CONTENU
 |largeur=LARGEUR
 |hauteur=HAUTEUR
 }}</nowiki>

'''Utilisation :''' pour {{M|Boîte déroulante/début}}
<pre>
{{boîte déroulante/début|titre=TITRE}}
Contenu
{{boîte déroulante/fin}}
</pre>

{| class="wikitable"
|----
! scope="row" colspan="4" | <big>Paramètres obligatoires</big>
|----
! scope="col" | paramètre !! scope="col" | effet !! scope="col" colspan="2" | valeurs possibles
|----
| <code>titre</code> || Titre affiché de la boîte || colspan="2" | Totalement libre, mais le caractère « | » par exemple ne passe pas.
|----
| <code>contenu</code> || Texte contenu dans la boîte || colspan="2" | Totalement libre, mais certains caractères spéciaux ne passent pas, comme la barre verticale. Utiliser dans ce cas :<br /><code>{{M|Boîte déroulante/début}} ''contenu'' {{M|Boîte déroulante/fin}}</code>.
|----
! scope="row" colspan="4" | <big>Paramètres facultatifs</big>
|----
! scope="col" | paramètre !! scope="col" | effet !! scope="col" | valeur par défaut !! scope="col" | valeurs possibles
|----
| <code>arrondi</code> (désactivé) || arrondi des angles || <code>0</code> || Les angles peuvent apparaître arrondis si le navigateur le permet.<br />Visible sur les navigateurs [[Mozilla]], non visible sur [[Internet Explorer]].<br />Valeur conseillée : <code>0.6em</code>, s’exprime en '''pt''', '''px''' ou '''em'''
|----
| <code>image</code> || image à gauche ||  || L’image facultative apparaît à l’ouverture de la boîte.<br />Elle doit être totalement renseignée.<br />Exemple : <code><nowiki>[[Fichier:Gtk-dialog-info.svg|15px]]</nowiki></code>
|----
| <code>alignB</code> || alignement de la boîte || <code>left</code> || <code>left</code>, <code>right</code>, <code>center</code> ou <code>justify</code>
|----
| <code>hauteur</code> || hauteur de la boîte repliée || <code>1.6em</code> || La hauteur doit être exprimée avec une unité valable.<br />Ne pas mettre une hauteur inférieure à 1.6em sous peine d’effets indésirables
|----
| <code>margeHaut</code> || marge haut (avant la boîte) || <code>0em</code> || La hauteur doit être exprimée avec une unité valable.<br />Il est possible de mettre 0
|----
| <code>margeBas</code> || marge bas (après la boîte) || <code>1em</code> || La hauteur doit être exprimée avec une unité valable.<br />Il est possible de mettre 0
|----
| <code>largeur</code> || largeur de la boîte || <code>100%</code> || La largeur doit être exprimée avec une unité valable.
|----
| <code>couleurBordure</code> || couleur de la bordure || <code>#AAAAAA</code> || rowspan="3" | Expression de couleur valide<br />exemples : black, #C080FF, …<br />{{Boîte déroulante|titre=Table des couleurs|arrondi=0.6em|align=center|largeur=98%|couleurFondB=#eee|couleurFondT=#fff|couleurFond=#fff| contenu={{Table des couleurs}}}}
|----
| <code>couleurFondB</code> || couleur de fond de la boîte || <code>#FFFFFF</code> 
|----
| <code>couleurFond</code> || couleur de fond du contenu || <code>white</code> 
|----
! scope="row" colspan="4" | <big>Texte</big>
|----
| <code>align</code> || alignement du contenu || <code>left</code> || rowspan="2" |<code>left</code>, <code>right</code>, <code>center</code> ou <code>justify</code>
|----
| <code>alignT</code> || alignement du titre || <code>center</code> 
|----
| <code>label</code> || texte du lien de droite || <code><nowiki>[dérouler] / [enrouler]</nowiki></code> || Totalement libre. Le caractère "/" permet de séparer les deux libellés. Exemple : <code>[ afficher ] / [ masquer ]</code>.
|----
| <code>couleurFondT</code> || couleur de fond du titre || <code>#EFEFEF</code> || rowspan="2" | Expression de couleur valide<br />exemples : black, #C080FF, …<br />{{Boîte déroulante|titre=Table des couleurs|arrondi=0.6em|align=center|largeur=98%|couleurFondB=#eee|couleurFondT=#fff|couleurFond=#fff| contenu={{Table des couleurs}}}}
|---- 
| <code>couleurTexteT</code> || couleur du texte de titre || <code>black</code> 
|---- 
| <code>thinning</code> || titre pas en gras || <code>no</code> || yes/no 
|}

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


{| width="100%"
| width="48%" | {{boîte déroulante|image=[[Fichier:Gtk-dialog-info.svg|15px]]|align=left|align=left|titre=par défaut (align=left, alignT=center)|contenu=
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.}}
| width="4%" | &nbsp;
| width="48%" | {{boîte déroulante|align=right|titre=Contenu à droite (align=right)|contenu=
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.}}
|----
| width="48%" | {{boîte déroulante|align=center|alignT=left|titre=Contenu centré, titre à gauche (align=center, alignT=left)|contenu=
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.}}
| width="4%" | &nbsp;
| width="48%" | {{boîte déroulante|align=justify|alignT=right|titre=Contenu justifié, titre à droite (align=justify, alignT=right)|contenu=
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.}}
|----
| width="48%" | {{boîte déroulante|titre=essais de couleurs pour démonstration|couleurBordure=green|couleurFondB=lightpink|couleurFondT=yellow|couleurTexteT=blue|couleurFond=lightcyan|contenu=
<br />&nbsp;&nbsp;[[Fichier:Palette boîte déroulante.gif|alt=Exemple de boîte déroulante avec des couleurs]]
* couleurBordure=green
* couleurFondB=lightpink
* couleurFondT=yellow
* couleurTexteT=blue
* couleurFond=lightcyan
}}
| width="4%" | &nbsp;
| width="48%" | {{Boîte déroulante|titre=Boîte déroulante avec angles ronds (arrondi=0.6em)|arrondi=0.6em|contenu =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.}}
|----
|}

== Voir aussi ==
{{Modèles navigationnels}}
<includeonly>
<!--[[Modèle:Boîte déroulante]]-->
[[Catégorie:Modèle déroulant]]
[[Catégorie:Modèle encadré]]
</includeonly>

<noinclude>
[[dsb:Pśedłoga:Nawikašćik/Dokumentacija]]
[[en:Template:Hidden/doc]]
[[eo:Ŝablono:Kaŝskatolo/dokumentado]]
[[hsb:Předłoha:Nawigaciska lajsta/Dokumentacija]]
</noinclude>