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

{{Sous-page de documentation}}
{{Modèle importé de Wikipédia France
 |url=https://fr.wikipedia.org/w/index.php?title=Mod%C3%A8le:Bo%C3%AEte_d%C3%A9roulante&oldid=126593062
 |adaptation=Modification du balisage html au niveau des groupes
}}
== Utilisation ==
;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.

== Syntaxe ==
'''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>

Le paramètre <code>modèle</code> ne peut être ajouté que dans l'espace modèle. Il sert à ajouter un lien vers le modèle utilisant la boîte déroulante.

'''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>

== Paramètres ==
{| 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>modèle</code> || lien vers le modèle || || <code>nom du modèle (sans <code>modèle:</code>)</code>
|----
| <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 Foundation|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>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 
|}

== Variante ==
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).

== Exemples ==
{{boîte déroulante|image=[[Fichier:Gtk-dialog-info.svg|15px]]|align=left|alignT=center|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.}}
{{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.}}
{{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.}}
{{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.}}
{{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
}}
{{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.}}

== Template Data ==
<templatedata>
{
        "description": "Ce modèle permet de mettre un texte dépourvu de barre verticale dans une boîte déroulante",
        "params": {
                "titre": {
                        "label": "Titre",
                        "description": "Titre de la boîte",
                        "type": "string",
                        "required": true
                },
                "contenu": {
                        "label": "Contenu",
                        "description": "Texte à mettre en boîte",
                        "type": "string",
                        "required": true
                },
                "align": {
                        "label": "Nom du modèle",
                        "description": "Nom du modèle",
                        "type": "string",
                        "required": false
                },
                "align": {
                        "label": "Alignement du contenu",
                        "description": "left, right, center ou justify ?",
                        "type": "string",
                        "default": "left",
                        "required": false
                },
                "alignT": {
                        "label": "Alignement du titre",
                        "description": "left, right, center ou justify ?",
                        "type": "string",
                        "default": "center",
                        "required": false
                },
                "alignB": {
                        "label": "Alignement de la boîte",
                        "description": "left, right, center ou justify ?",
                        "type": "string",
                        "default": "left",
                        "required": false
                },
                "label": {
                        "label": "Label",
                        "description": "Texte du lien de droite",
                        "type": "string",
                        "default": "Dérouler/Enrouler",
                        "required": false
                },
                "hauteur": {
                        "label": "Hauteur",
                        "description": "Hauteur de la boîterepliée",
                        "type": "string",
                        "default": "1.6em",
                        "required": false
                },
                "largeur": {
                        "label": "Largeur",
                        "description": "Largeur de la boîterepliée",
                        "type": "string",
                        "default": "100%",
                        "required": false
                },
                "couleurTexteT": {
                        "label": "Couleur titre",
                        "description": "Couleur du titre",
                        "type": "string",
                        "default": "black",
                        "required": false
                },
                "thinning": {
                        "label": "Titre en gras",
                        "description": "Yes ou no",
                        "type": "string",
                        "default": "no",
                        "required": false
                },
                "couleurFondT": {
                        "label": "Couleur fond titre",
                        "description": "Couleur du fond de titre",
                        "type": "string",
                        "default": "#EFEFEF",
                        "required": false
                },
                "couleurFondB": {
                        "label": "Couleur fond boîte",
                        "description": "Couleur de fond de la boîte",
                        "type": "string",
                        "default": "#FFFFFF",
                        "required": false
                },
                "couleurFond": {
                        "label": "Couleur fond contenu",
                        "description": "Couleur de fond du contenu",
                        "type": "string",
                        "default": "white",
                        "required": false
                },
                "couleurBordure": {
                        "label": "Couleur bordure",
                        "description": "Couleur de la bordure",
                        "type": "string",
                        "default": "#AAAAAA",
                        "required": false
                }
        }
}
</templatedata>

== Voir aussi ==
{{Palette|Modèles navigationnels}}
<includeonly>
[[Catégorie:Modèle déroulant]]
[[Catégorie:Modèle encadré]]
</includeonly>