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

{{Sous-page de documentation}}
<includeonly>{{Protection}}</includeonly>
{{Avertissement méta-modèle|nocat=oui}}

== Utilisation ==
{{Aide détaillée|Aide:Palette de navigation}}
Ce [[Aide:Modèle|modèle]] permet la création aisée de modèles de palettes de navigation standards, permettant de grouper des liens internes par thème, 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 ==
Copier-coller le texte ci-dessous et supprimer les paramètres dont vous n'avez pas besoin.
<pre>{{Méta palette de navigation
| modèle  = {{subst:PAGENAME}}
| titre   = 

| dessus  = 

| groupe1 = 
| liste1  = 

| groupe2 = 
| liste2  = 

| groupe3 = 
| liste3  = 

| dessous = 
}}</pre>

; Syntaxe complète
{{Boîte déroulante/début|titre=Code complet du modèle palette}}
<pre>{{Méta palette de navigation
| modèle      = {{subst:PAGENAME}}<!-- Nom du modèle, sans l'espace de noms -->
| étatboîte   = autocollapse
| styletitre  = 
| titre       = 
| sous-titre  = <!-- déprécié -->
| image       = 
| stylecorps  = 
| stylegroupe = 
| styleliste  = 
| stylepair   = 
| styleimpair = 

| styledessus = 
| dessus      = 

| groupe1 = 
| liste1  = 
| groupe2 = 
| liste2  = 
   ...
| groupe30 = 
| liste30  = 

| styledessous = 
| dessous      = 
| nocat        = oui
}}</pre>
{{Boîte déroulante/fin}}

== Nom du modèle palette ==
;Création d’une nouvelle palette
:Lors de la création d’un nouveau modèle de palette de navigation, il est demandé de respecter la convention des noms de modèle. Ainsi le nom devra toujours débuter par « ''<code>Palette</code>'' » suivi du nom commençant par une majuscule : '''Modèle:''Palette'' Nom de la palette'''. Quelques exemples de noms de modèle : {{Liste éléments|[[Modèle:Palette Régions des États-Unis]]|[[Modèle:Palette Processus nucléaires]]|[[Modèle:Palette Unibroue]]}}.

== Catégorie ==
Chaque palette doit être catégorisée dans au moins une des sous-catégories de [[:Catégorie:Palette de navigation]] entre des balises <<nowiki>noinclude</nowiki>> </<nowiki>noinclude</nowiki>>.

== 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 la 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-après).
: La couleur de fond par défaut des listes est <code><span style="background: #ccccff;">#ccccff</span></code>), mais peut être modifiée avec les paramètres ''<code>stylecorps</code>'', ''<code>stylepair</code>'' et/ou ''<code>style impair</code>'' (voir ci-après).

=== Optionnels ===
==== Cellules ====
; ''groupe<sub>#</sub>''
: Lorsqu'il est spécifié, le texte apparaît dans l’entête de la cellule, à gauche de la ''liste<sub>#</sub>''. S'il est 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-avant).

; ''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. Exemples : 
:* <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>stylecorps = background:#''nnnnnn'';</code>
:* <code>stylecorps = text-align:[''right/center/left/justified''];</code>
:* <code>stylecorps = width:''N''&nbsp;[em/%/px ou width:auto];</code>
:* <code>stylecorps = float:[''left/right/none''];</code>
:* <code>stylecorps = 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>stylegroupe = background:#''nnnnnn'';</code>
:* <code>stylegroupe = text-align:[''left/center/right''];</code>
:* <code>stylegroupe = width:''N''&nbsp;[em/%/px ou width:auto];</code>
:* <code>stylegroupe = vertical-align:[''top/middle/bottom''];</code>
:* <code>stylegroupe = 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-après.) 

; ''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, elles 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}}).

== 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 [[Modèle:Méta palette de navigation sous-groupe|sous-groupes]] ===
{{Encart|accessibilite|Ce modèle pose un problème d’[[Wikipédia:Atelier accessibilité/Qu'est-ce que c'est ?|accessibilité]] important. Vous êtes invité(e)s à limiter son utilisation car il 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}}

=== Avec [[Modèle:Méta palette de navigation sous-groupe|sous-groupes]] et image ===
{{Encart|accessibilite|Ce modèle pose un problème d’[[Wikipédia:Atelier accessibilité/Qu'est-ce que c'est ?|accessibilité]] important. Vous êtes invité(e)s à limiter son utilisation car il 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 6}}

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

== Voir aussi ==
* {{m|Palette}}
* {{m|Liste horizontale}}
* [[:Catégorie:Méta palette de navigation]]
* {{m|Utiliser la méta palette}} et [[:Catégorie:Convertir en méta palette]]

{{Palette|Modèles navigationnels}}

{{Projet|Palette}}<includeonly>
[[Catégorie:Méta palette de navigation|*]]
</includeonly>