Modèle:Navigation/Documentation

Un article de Wikipédia, l'encyclopédie libre.

Vous avez de nouveaux messages (diff^?).

Ci-dessous la documentation de ce modèle. Voir la liste des modèles.
Cliquez ici pour purger le cache si le modèle utilise noinclude et vos modifications n’apparaissent pas.

{{Navigation}} est un modèle générique de palette de navigation, adapté à l’affichage de listes horizontales, souvent placées en bas d’articles. Toutefois, le modèle n’est pas restreint à l’affichage de listes, le contenu pouvant être quelconque.

Sommaire

1 Utilisation
2 Exemples
- 2.1 Panneau classique
- 2.2 Panneau avancé
3 Voir aussi

[modifier] Utilisation

Pour utiliser ce modèle, vous pouvez commencer par copier-coller le code suivant et fournir les arguments :

[modifier] Syntaxe

{{Navigation|
   couleur=|bordure=|fond=|
   image=|
   déroulable=|
   modèle={{subst:PAGENAME}}|
   cat=|
   titre=<!-- à renseigner -->|
   résumé=<!-- courte phrase décrivant le contenu recommandée si le panneau est déroulable -->|
   résumé visible=|
   contenu=<!-- à renseigner -->
}}<noinclude>
<!-- utiliser une sous-catégorie appropriée pour vos modèles -->
[[Catégorie:Palette de navigation|{{PAGENAME}}]]
<!-- Interwikis -->

</noinclude>

[modifier] Paramètres obligatoires

titre (ou title): Le texte qui apparaît centré dans la barre de titre en haut du panneau de navigation. C’est habituellement le sujet du modèle, c’est-à-dire une description succinte du texte détaillé indiqué dans le paramètre contenu. Il est souvent utile d’y inclure des liens sur certains termes.
contenu (ou body): Le contenu effectif affiché dans le panneau de navigation, habituellement une énumération ou une liste de liens. Le format devrait rester « en ligne ». Toutefois, si le contenu comprend plusieurs listes, on peut les séparer par un filet horizontal (“----” sur une ligne de code séparée) ou utiliser des sauts de ligne forcés (par exemple avec “<br />”). Voir aussi en bas de page des modèles utilitaires pour rendre insécables chaque élément de la liste.

[modifier] Paramètres optionels

couleur (ou color): La couleur de fond de la barre de titre. Attention : un consensus est souvent nécessaire pour le choix de la couleur, car la présence de plusieurs panneaux de navigation superposés dans la même page mais utilisant des couleurs différentes peut paraître déplaisante. Valeur par défaut #DDDDFF (bleu clair).
bordure: La couleur de la bordure du panneau. Valeur par défaut #AAAAAA (gris moyen).
fond: La couleur de fond du contenu du panneau. Valeur par défaut #FFFFFF (blanc).
image: vide par défaut. On peut préciser un lien complet vers une image qui sera affichée à gauche de la barre de titre.
déroulable: vide par défaut (panneau entièrement visible). Si sa valeur est non vide, le panneau de navigation sera affiché par défaut en mode enroulé mais sera déroulable par l'utilisateur (à l’impression, le panneau restera entièrement visible quel que soit l’état de l'affichage, et le lien de déroulage du panneau sera masqué).
modèle (ou name): Le nom du modèle, qui est nécessaire pour que les liens "voir • discuter • éditer" fonctionnent correctement sur toutes les pages où le modèle est utilisé. Vous pouvez entrer {{subst:PAGENAME}} pour cette valeur afin de faciliter les éditions ultérieures au cas où votre modèle serait renommé. Si vous ne fournissez pas ce paramètre, les liens ne s’affichent pas.
cat (ou catégorie): La catégorie (ou les catégories) dont toutes les pages (sauf celles dans l’espace “Modèle:”) incluant le panneau de navigation deviendront automatiquement membres.
résumé: Un texte résumé pour le contenu de la boîte (surtout utile quand la boîte est enroulée). Ce résumé apparaît dans une bulle d’aide lorsque le pointeur de la souris passe sur une zone du panneau de navigation sans autre lien ou titre. Ce devrait être une phrase assez courte (aucun lien dans le résumé ne sera accessible dans la bulle d’aide, voir ci-dessous).
résumé visible: vide par défaut (résumé invisible sauf lors du survol du panneau par le pointeur souris). Si sa valeur est non vide, le résumé apparaîtra en petits caractères dans la barre de titre, sous le titre lui-même (il ne sera pas caché quand la boîte est enroulée), et non dans une bulle d’aide (la présence de liens est alors possible).

[modifier] Exemples

[modifier] Panneau classique

Pour un panneau de navigation “Modèle:Pays d'Asie centrale”, le code suivant n’utilise que les deux paramètres obligatoires (titre et contenu) et le résumé optionnel (en bulle d’aide) :

{{Navigation|
  titre=[[Pays du monde|Pays]] d’[[Asie centrale]]|
  résumé=Liste des pays indépendants dont au moins une partie du territoire se situe en Asie centrale.|
  contenu=
{{·|{{Afghanistan}}}}
{{·|{{Kazakhstan}}}}
{{·|{{Kirghizistan}}}}
{{·|{{Mongolie}}}}
{{·|{{Ouzbékistan}}}}
{{·|{{Russie}}}}
{{·|{{Tadjikistan}}}}
{{nobr|{{Turkménistan}}}}
}}<noinclude>
[[Catégorie:Palette de navigation Asie|{{PAGENAME}}]]
<!-- Interwikis -->
[[en:Template:Central Asian countries]]
</noinclude>

affiche :

Pays d’Asie centrale

Afghanistan • Kazakhstan • Kirghizistan • Mongolie • Ouzbékistan • Russie • Tadjikistan • Turkménistan

[modifier] Panneau avancé

Le même panneau (dans le “Modèle:Pays d'Asie centrale”) avec

d’autres couleurs d’entête, de bordure et de fond,
une icône (paramètre image=[[Image:...]]),
déroulable (paramètre déroulable=1),
éditable (paramètre modèle=Pays d'Asie centrale, généré via subst: à la sauvegarde du modèle),
autocatégorisant (paramètre cat=[[Catégorie:...]], non appliqué dans le rendu plus bas sur cette page)
avec un résumé (ici rendu visible sous le titre) :

{{Navigation|
  couleur=#DDFF99|bordure=#AAEE66|fond=#EEFFDD|
  image=[[Image:Map Central Asia.PNG|50px|Asie centrale]]|
  déroulable=1|
  modèle=Pays d'Asie centrale|
  cat=[[Catégorie:Pays d'Asie centrale|{{PAGENAME}}]]|
  résumé=Liste des pays indépendants dont au moins une partie du territoire se situe en Asie centrale.|
  résumé visible=1|
  titre=[[Pays du monde|Pays]] d’[[Asie centrale]]|
  contenu=
{{·|{{Afghanistan}}}}
{{·|{{Kazakhstan}}}}
{{·|{{Kirghizistan}}}}
{{·|{{Mongolie}}}}
{{·|{{Ouzbékistan}}}}
{{·|{{Russie}}}}
{{·|{{Tadjikistan}}}}
{{nobr|{{Turkménistan}}}}
}}<noinclude>
[[Catégorie:Palette de navigation Asie|{{PAGENAME}}]]
<!-- Interwikis -->
[[en:Template:Central Asia navigation]]
</noinclude>

affiche :

v · d · é