Les modèles vous permettent de passer des paramètres. Ceux-ci sont utilisés pour modifier la façon dont le modèle est affiché, par exemple en incluant un texte spécifique ou en modifiant l'apparence.

Note : cette page décrit la manipulation des modèles dans l'éditeur source. Lors de l'insertion de modèles sur des pages, l'ÉditeurVisuel peut vous permettre de définir et d'insérer du texte dans les paramètres sans toucher au wikitexte.

Paramètres simples[modifier le wikicode]

Pour les petits modèles, il suffit souvent d'utiliser des paramètres basiques sans noms spécifiques pour modifier un modèle. Ces paramètres sont numérotés plutôt que nommés, en utilisant {{{1}}}, {{{2}}}, {{{3}}}, etc.

Guide[modifier le wikicode]

Ce guide explique comment créer un modèle basique de boîte avec des paramètres simples :

  • Créez une page sur votre wiki avec un nom basique (par exemple, « Modèle:Boîte ») :
  • Ajoutez le code suivant à cette page :
<div style="background-color: #CDF; border: 1px solid #999; color: black; height: 5em; padding-top: 2em; text-align: center; width: 10em;">
{{{1}}}
</div>
  • Enregistrez la page pour voir qu'elle affiche le contenu suivant :
{{{1}}}
  • Créez une page d'article sur votre wiki appelée Test modèle
  • Entrez le code suivant sur cette page pour afficher votre modèle :
{{Boîte|Exemple de texte}}
  • Enregistrez la page et notez qu'elle affiche le contenu suivant :
Exemple de texte

Comprendre ce qu'il se passe[modifier le wikicode]

Ce remplacement a eu lieu parce que {{{1}}} indique au wiki de passer le premier paramètre du modèle ici. Cela peut être étendu avec {{{2}}}, {{{3}}}, etc.

Le numéro représente le numéro du paramètre :

{{boîte|premier paramètre|deuxième paramètre|troisième paramètre}}

Si vous souhaitez ne pas utiliser un certain paramètre, vous pouvez le laisser vide, mais le caractère « | » doit quand même être inclus. Par exemple, le caractère « | » doit être inclus :

{{boîte|premier paramètre||troisième paramètre}}

Paramètres nommés et par défaut[modifier le wikicode]

Pour les modèles plus complexes, il est souvent préférable d'utiliser des paramètres nommés. Cela permet une plus grande liberté dans la création des modèles, et rend également les modèles plus faciles à utiliser car les utilisateurs sauront quel paramètre affecte quel élément.

Guide[modifier le wikicode]

Ce guide vous guidera dans l'utilisation de paramètres nommés au travers de l'exemple « Modèle:Boîte »" ci-dessus :

  • En utilisant les mêmes pages d'exemple que précédemment, modifiez « Modèle:Boîte » et remplacez le contenu par le code suivant :
<div style="background-color: {{{couleur de fond|#CDF}}}; border: 1px solid #999; color: {{{couleur texte|black}}}; height: 5em; padding-top: 2em; text-align: center; width: 10em;">
{{{texte}}}
</div>
{{{texte}}} introduit le concept de paramètre nommé. {{{couleur de fond|#CDF}}} introduit également la notion de paramètre par défaut : si « couleur de fond » n'est pas défini, "#CDF" sera utilisé.
  • Modifiez la page « Test modèle » et remplacez-la par le code suivant :
{{boîte|couleur de fond=navy|couleur texte=white|texte=Une boîte bleu marine}}
  • Enregistrez votre page, et notez qu'elle affiche ce qui suit :
Une boîte bleu marine

Comprendre ce qu'il se passe[modifier le wikicode]

Comme les paramètres ont des noms, vous pouvez les passer dans n'importe quel ordre, ainsi {{{boîte|couleur texte=white|texte=Une boîte bleu marine|couleur de fond=navy}} produirait une boîte identique.

En raison des paramètres par défaut, si, par exemple, la couleur de fond n'était pas définie - comme dans {{{box|couleur texte=white|texte=Une boîte bleu marine}} – vous obtiendriez :

Une boîte bleu marine

Les paramètres nommés sont souvent écrits sur des lignes séparées ou avec un espace entre le nom du paramètre et le signe « = », pour faciliter la lecture. Généralement, cela se fait dans un grand modèle composé de nombreux paramètres. Il n'est pas rare de les voir écrits sous cette forme :

{{boîte
 |couleur de fond = navy
 |couleur texte   = white
 |texte           = Une boîte bleu marine
}}

Le paramètre par défaut peut être laissé vide si vous souhaitez qu'un paramètre optionnel n'insère rien sur une page.

Par exemple, si vous écrivez {{{texte}}} dans un modèle, mais que vous n'incluez pas d'entrée "texte=" sur la page de l'article, il apparaîtra ainsi « {{{texte}}} ». En revanche, si vous écrivez {{{texte|}}} dans le modèle, la valeur par défaut est aucun texte, de sorte que rien n'apparaîtra sur la page de l'article.

Il est également possible de définir un autre paramètre comme valeur par défaut d'un paramètre, comme {{{texte|{{{1|}}}}}}. Ainsi, si un éditeur utilise {{{boîte|exemple de texte}}, il obtiendra le même résultat que {{boîte|texte=exemple de texte}}. Cela signifie qu'un modèle utilisera par défaut le paramètre |texte=, mais s'il ne le trouve pas, il utilisera le paramètre non nommé à la place ; s'il ne trouve pas ça, il n'utilisera pas de texte.

Voir aussi[modifier le wikicode]

Sauf mention contraire, le contenu de la communauté est disponible sous licence CC-BY-SA.