Voir la source de Modèle:Méta palette de navigation/Documentation

<noinclude>{{documentation modèle vue directement}}
[[Catégorie:Modèle Wikipédia]]
</noinclude>
{{Sommaire à droite}}

== Utilisation ==
Ce modèle permet la création aisée de [[Aide:Palette de navigation|palette de navigation]] standard pour grouper par thème des liens internes dans un tableau en boîte déroulante. Dans un article, lorsqu’il y a plusieurs palettes, elles sont conçues pour <u>s’empiler sans espacement</u>. 

== Syntaxe ==
; Syntaxe de base
<pre>
{{Méta palette de navigation
 | modèle = {{subst:PAGENAME}}<!-- Ne pas modifier -->
 | titre  = 
 | image  = 

 | dessus = 

 | groupe1 = 
 | liste1  = 

 | groupe2 = 
 | liste2  = 

...

 | dessous = 
}}
</pre>

; Syntaxe complète
{{Boîte déroulante début|titre=Code complet du modèle}}
<pre>
{{Méta palette de navigation
 | modèle = {{subst:PAGENAME}}<!-- Ne pas modifier -->
 | étatboîte = autocollapse<!-- Ne pas utiliser ce paramètre dans les articles -->
 | styletitre = 
 | titre = 
 | sous-titre = 
 | image = 
 | stylecorps = 
 | stylegroupe = 
 | styleliste = 
 | stylepair = 
 | styleimpair = 
 | styledessus = 
 | dessus = 
 | groupe1 = 
 | liste1 = 
 | groupe2 = 
 | liste2 = 
   ...
 | groupe20 = 
 | liste20 = 
 | styledessous = 
 | dessous = 
 | nocat=oui
}}
</pre>
{{Boîte déroulante fin}}

== Nom du modèle ==
:;Création d’une nouvelle palette
::Lors de la création d’un nouveau modèle de palette de navigation, il est recommandé de respecter la convention des noms de modèle. Ainsi le nom devrait toujours débuter par « ''<code>Palette</code>'' » suivi du nom commençant par une majuscule. Quelques exemple de noms de modèle : '''Modèle:''Palette'' Nom de la palette''' • [[Modèle:Palette Régions des États-Unis]] • [[Modèle:Palette Processus nucléaires]] • 
:;Mise à jour d’une ancienne palette
::Lors de la mise à jour d’un ancien modèle de palette de navigation qui ne respecte pas la convention des titres de modèle, il est recommandé de [[Aide:Comment renommer une page|renommer la palette]] et d’y ajouter le terme « ''<code>Palette</code>'' » au début du nom du modèle.

== Exemples de palettes ==
=== Sans groupe ni image ===
{{Méta palette de navigation/Documentation/Exemple 2}}


=== Avec images dans le titre et dans le corps ===
{{Méta palette de navigation/Documentation/Exemple 3}}


=== Avec sous-titre ===
{{Méta palette de navigation/Documentation/Exemple 5}}


=== Avec [[Modèle:Méta palette de navigation sous-groupe|sous-groupes]] ===
{{Encart|aide_accessibilite|Ce modèle pose un problème d’[[Wikipédia:Atelier accessibilité/Qu'est-ce que c'est ?|accessibilité]] important. Vous êtes invités à limiter son utilisation car celui-ci entraîne une impossibilité ou une forte difficulté de consultation du contenu de Wikipédia pour différents types d’utilisateurs en situation de handicap technique ou personnel.}}

{{Méta palette de navigation/Documentation/Exemple 1}}


=== Groupement de palettes avec {{m|Palette}} ===
{{Palette|Exemple 1|Exemple 2|Exemple 3}}

== Paramètres ==
=== Obligatoires ===
:; ''modèle''
:: Le nom du modèle, nécessaire pour les liens « {{nobr|v • d • m}} » (« {{nobr|voir • discuter • modifier}} ») afin qu’ils fonctionnent sur toutes les pages où ce modèle est utilisé. Vous pouvez entrer <code><nowiki>{{subst:PAGENAME}}</nowiki></code> comme valeur afin d’éviter les erreurs.

:; ''titre''
:: Texte centré qui apparaît dans l’entête du tableau. Habituellement, il s’agit du sujet du modèle. Ceci devrait être contenu sur une ligne, mais si une deuxième est nécessaire, utiliser <code><nowiki>{{-}}</nowiki></code> pour que le texte soit bien centré.
:: La couleur de fond par défaut est <code><span style="background: #ccccff;">#ccccff</span></code>), mais il est possible de le modifier avec le paramètre ''<code>styletitre</code>'' (voir ci-dessous).

:; ''liste<sub>#</sub>''
:: Le corps de ce modèle est habituellement une liste de liens. Le format prévoit une seule ligne, bien que le texte peut être entré sur des lignes séparées à l’intérieur des balises <code><nowiki><div> </div></nowiki></code> (Voir [[#Exemple avec code]]). Au moins un paramètre ''<code>liste</code>'' est requis ; chaque ''<code>liste</code>'' additionnelle sera affichée sur une rangée séparée. Chaque ''liste<sub>#</sub>'' peut être précédée par un paramètre ''group<sub>n</sub>'' correspondant, si nécessaire (Voir ci-dessous).
:: La couleur de fond par défaut des liste est <code><span style="background: #ccccff;">#ccccff</span></code>), mais peut être modifié avec les paramètres ''<code>stylecorps</code>'', ''<code>stylepair</code>'' et/ou ''<code>style impair</code>'' (voir ci-dessous).

=== Optionnels ===

==== Cellules ====
:; ''groupe<sub>#</sub>''
:: Lorsque que spécifié, le texte apparaît dans l’entête de la cellule, à gauche de la ''liste<sub>#</sub>''. Si absent, la ''liste<sub>#</sub>'' prend toute la largeur du tableau.
:: La couleur de fond par défaut est <code><span style="background: #ddddff;">#ddddff</span></code>, mais peut être modifiée avec le paramètre ''<code>stylegroupe</code>'' (voir ci-dessous).

:; ''image''
:: Une image peut être affichée dans la cellule sous le titre et à la droite du corps (les groupes/listes). Pour que l’image apparaisse correctement, un paramètre de la ''<code>liste1</code>'' doit être spécifié. Le paramètre ''<code>image</code>'' accepte la syntaxe wiki standard. Exemple :
::: <code><nowiki>[[Image:Exemple.jpg|100px]]</nowiki><code>
:: Dans un modèle où le corps (les groupes/listes) ne s’étend pas jusqu’au bout à droite, l’image débordera de la marge de droite. Ceci peut être corrigé en utilisant le paramètre ''<code>right</code>'' dans la syntaxe du lien de l’image. Exemple : 
::: <code><nowiki>[[Image:Example.jpg|80px|right]]</nowiki><code>

:; ''dessus''
:: Une cellule pleine largeur peut apparaître entre la barre de titre et le premier ''groupe/liste'', juste au-''dessus'' du corps (groupes/listes/image). Dans un modèle sans image, ''dessus'' se comporte de la même façon que ''liste1'' sans paramètre de ''groupe1''.

:; ''dessous''
:: Une cellule pleine largeur peut apparaître ''dessous'' le corps du modèle (groupes/listes/image). Dans un modèle sans image, ''dessous'' se comporte comme si la dernière ''liste<sub>#</sub>'' sans le paramètre ''groupe<sub>#</sub>''. (voir [[#Exemple avec image et style]])

==== Styles ====
Lorsque vous indiquez des styles de couleur, veillez à respecter les [[Wikipédia:Limitez l'usage de la couleur dans les articles|recommandations sur l’usage de la couleur dans les articles]].

:; ''styletitre''
:: Les styles [[Feuilles de style en cascade|CSS]] à appliquer à la barre d’entête. Exemple : 
::: <code><nowiki>styletitre = background:</nowiki>''#nnnnnn'';</code>
::: <code><nowiki>styletitre = background:</nowiki>''nom'';</code>

:; ''stylecorps''
:: Les styles CSS à appliquer au corps du modèle. Le mot ''<code>style</code>'' (plus court) peut être utilisé lorsqu’aucun autre paramètre de style n’est spécifié. Cette option doit être utilisée avec parcimonie, car elle peut provoquer des contradictions visuelles. Exemples :
::: <code>background:#''nnnnnn'';</code>
::: <code>text-align:[''right/center/left/justified''];</code>
::: <code>width:''N''&nbsp;[em/%/px ou width:auto];</code>
::: <code>float:[''left/right/none''];</code>
::: <code>clear:[''right/left/both/none''];</code>

:; ''stylegroupe''
:: Les styles CSS à appliquer aux cellules ''groupe<sub>#</sub>''. Cette option écrase tous les styles qui sont appliqués au tableau entier. Exemples :
::: <code>background:#''nnnnnn'';</code>
::: <code>text-align:[''left/center/right''];</code>
::: <code>vertical-align:[''top/middle/bottom''];</code>
::: <code>white-space:nowrap;</code>

:; ''styleliste''
:: Les styles CSS à appliquer aux listes. Ce paramètre est écrasé si ''<code>stylepair</code>/<code>styleimpair</code>'' est spécifié. (voir ci-dessous) 

:; ''stylepair''
:; ''styleimpair''
:: Les styles CSS à appliquer respectivement aux listes paires (''liste2'', ''liste4''{{nobr|, etc.}}) et impaires (''liste1'', ''liste3''{{nobr|, etc.}}). Habituellement utilisé pour afficher une couleur (<code>background:#''nnnnnn'';</code>) pour colorer alternativement des rangées de listes. 

:; ''styledessus''
:; ''styledessous''
:: Les styles CSS à appliquer à la cellule du haut (spécifiés par le paramètre ''dessus'') et la cellule du bas (spécifiés par le paramètre ''dessous''). Souvent utilisé pour l’alignement du texte et la couleur de fond :
::: <code>background:#''nnnnnn'';</code>
::: <code>text-align:[''left/center/right''];</code>

==== Autres ====
:; ''sous-titre''
:: Un sous-titre optionnel peut apparaître sous le titre obligatoire. Il sera automatiquement plus petit que le titre.

:; ''étatboîte''
:: Ce paramètre contrôle l’enroulement et le déroulement de la boîte lorsqu’elle s’affiche sur une page. 
::* ''collapsed'' : la boîte sera fermée (enroulée) lors du chargement de la page.
::* ''uncollapsed'' : la boîte sera ouverte (déroulée) lors du chargement de page.
::* ''vide (par défaut)'' : la boîte sera ouverte (déroulée), mais si la page contient deux boîtes ou plus, elle seront fermées (enroulées) lors du chargement de la page (''autocollapse'').

:; ''nocat''
:: Afin de détecter les palettes avec le champ ''modèle'' mal renseigné, ce modèle catégorise dans {{Catégorie|Palette avec paramètre modèle mal renseigné}} les modèles erronés. Cependant, si une palette est utilisée dans la documentation d'un modèle, celui-ci est détecté comme erreur. Afin de limiter le nombre de faux positifs, il est possible d'utiliser le paramètre ''nocat=oui'' dans le code des palettes <u>uniquement</u> destinées à des modèles (comme {{m|Palette Liste des modèles s}} par exemple).

== Voir aussi ==
* {{m|Méta palette de navigation sous-groupe}}
* {{m|Liste éléments}}
* {{m|Palette}}

<includeonly>



</includeonly>

<noinclude>
[[Category:Templates]]
</noinclude>