Modèle:Méta palette de navigation/Documentation
Ceci est la sous-page de documentation du modèle {{Méta palette de navigation}} ; elle est insérée sur la page de celui-ci à l’aide du modèle {{Documentation}}. C’est également sur cette page que vous placerez les liens interwiki et les catégories du modèle.
Utilisation
modifierCe modèle permet la création aisée de 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 s’empiler sans espacement.
Syntaxe
modifier- Syntaxe de base
{{Méta palette de navigation | modèle = {{subst:PAGENAME}}<!-- Ne pas modifier --> | titre = | image = | dessus = | groupe1 = | liste1 = | groupe2 = | liste2 = ... | dessous = }}
- Syntaxe complète
Code complet du modèle
{{Méta palette de navigation | modèle = {{subst:PAGENAME}}<!-- Ne pas modifier --> | étatboîte = autocollapse<!-- Ne pas utiliser ce paramètre dans les livres --> | styletitre = | titre = | sous-titre = | image = | stylecorps = | stylegroupe = | styleliste = | stylepair = | styleimpair = | styledessus = | dessus = | groupe1 = | liste1 = | groupe2 = | liste2 = ... | groupe20 = | liste20 = | styledessous = | dessous = | nocat=oui }}
Nom du modèle
modifier- 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 «
Palette
» 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 • Modèle:Palette Unibroue
- 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 renommer la palette et d’y ajouter le terme «
Palette
» au début du nom du modèle.
Exemples de palettes
modifierSans groupe ni image
modifier
Avec images dans le titre et dans le corps
modifier
Avec sous-titre
modifier
Avec sous-groupes
modifierCe modèle pose un problème d’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.
Groupement de palettes avec {{Palette}}
modifierParamètres
modifierObligatoires
modifier- modèle
- Le nom du modèle, nécessaire pour les liens « v • d • m » (« voir • discuter • modifier ») afin qu’ils fonctionnent sur toutes les pages où ce modèle est utilisé. Vous pouvez entrer
{{subst:PAGENAME}}
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
{{-}}
pour que le texte soit bien centré. - La couleur de fond par défaut est
#ccccff
), mais il est possible de le modifier avec le paramètrestyletitre
(voir ci-dessous).
- liste#
- 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
<div> </div>
(Voir #Exemple avec code). Au moins un paramètreliste
est requis ; chaqueliste
additionnelle sera affichée sur une rangée séparée. Chaque liste# peut être précédée par un paramètre groupn correspondant, si nécessaire (Voir ci-dessous). - La couleur de fond par défaut des liste est
#ccccff
), mais peut être modifié avec les paramètresstylecorps
,stylepair
et/oustyle impair
(voir ci-dessous).
Optionnels
modifierCellules
modifier- groupe#
- Lorsque que spécifié, le texte apparaît dans l’entête de la cellule, à gauche de la liste#. Si absent, la liste# prend toute la largeur du tableau.
- La couleur de fond par défaut est
#ddddff
, mais peut être modifiée avec le paramètrestylegroupe
(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
liste1
doit être spécifié. Le paramètreimage
accepte la syntaxe wiki standard. Exemple :[[Image:Exemple.jpg|100px]]
- 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
right
dans la syntaxe du lien de l’image. Exemple :[[Image:Example.jpg|80px|right]]
- 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# sans le paramètre groupe#. (voir #Exemple avec image et style)
Styles
modifierLorsque vous indiquez des styles de couleur, veillez à respecter les recommandations sur l’usage de la couleur dans les articles.
- styletitre
- Les styles CSS à appliquer à la barre d’entête. Exemple :
styletitre = background:#nnnnnn;
styletitre = background:nom;
- stylecorps
- Les styles CSS à appliquer au corps du modèle. Le mot
style
(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 :background:#nnnnnn;
text-align:[right/center/left/justified];
width:N [em/%/px ou width:auto];
float:[left/right/none];
clear:[right/left/both/none];
- stylegroupe
- Les styles CSS à appliquer aux cellules groupe#. Cette option écrase tous les styles qui sont appliqués au tableau entier. Exemples :
background:#nnnnnn;
text-align:[left/center/right];
vertical-align:[top/middle/bottom];
white-space:nowrap;
- styleliste
- Les styles CSS à appliquer aux listes. Ce paramètre est écrasé si
stylepair
/styleimpair
est spécifié. (voir ci-dessous)
- stylepair
- styleimpair
- Les styles CSS à appliquer respectivement aux listes paires (liste2, liste4, etc.) et impaires (liste1, liste3, etc.). Habituellement utilisé pour afficher une couleur (
background:#nnnnnn;
) 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 :
background:#nnnnnn;
text-align:[left/center/right];
Autres
modifier- 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 uniquement destinées à des modèles (comme {{Palette Liste des modèles s}} par exemple).
Voir aussi
modifier