Centre des communautés
Advertisement

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[]

Pour les petits modèles, l'utilisation de paramètres basiques sans noms pour modifier un modèle suffira généralement. Ces paramètres sont numérotés plutôt que nommés, en utilisant {{{1}}}, {{{2}}}, {{{3}}} et ainsi de suite.

Guide[]

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: #DDD2; border: 1px solid #5556; 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 constatez qu'elle affiche le contenu suivant :
Texte d'exemple

Comprendre ce qu'il s'est passé[]

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}}

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

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[]

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|#DDD2}}}; border: 1px solid #5556; padding: 2em; text-align: center; width: 10em;">
{{{texte}}}
</div>
{{{texte}}} introduit le concept de paramètre nommé. {{{couleur de fond|#DDD2}}} introduit également la notion de paramètre par défaut : si « couleur de fond » n'est pas défini, « #DDD2 » sera utilisé.
  • Modifiez la page « Test modèle » et remplacez-la par le code suivant :
{{boîte|couleur de fond=navy|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 s'est passé[]

Comme les paramètres ont des noms, vous pouvez les passer dans n'importe quel ordre, ainsi {{{boîte|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|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_fond  = navy
 |texte         = Une boîte bleu marine
}}

Un paramètre par défaut peut être laissé vide si vous ne souhaitez pas qu'un paramètre optionnel n'insère quelque chose 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 trouve pas |texte=, il utilisera le paramètre non nommé à la place ; s'il ne trouve pas {{{1}}}, il n'utilisera pas de texte.

Ignorer un paramètre[]

Certains modèles peuvent contenir des paramètres facultatifs, qui peuvent être fournis ou non.

Lors de la création d'un tel modèle, il est recommandé d'utiliser un paramètre nommé pour le paramètre facultatif ou d'en faire le dernier afin que les utilisateurs puissent simplement ne pas le fournir. S'il n'est pas nommé et qu'il n'est pas le dernier, il n'y a pas de moyen facile de l'ignorer. Un utilisateur peut fournir une valeur vide comme

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

mais cela peut ne pas fonctionner comme prévu, selon le modèle, car les valeurs vides se comportent différemment des valeurs non fournies. Par exemple, les valeurs par défaut ne sont pas utilisées car le paramètre a été fourni, juste avec une valeur vide.

Si un modèle utilise des paramètres optionnels innommés et qu'il est nécessaire d'ignorer un tel paramètre, il est possible d'utiliser des numéros explicites pour tous les paramètres, par exemple

{{boîte|1=premier paramètre|3=troisième paramètre}}.

Une autre possibilité est que le modèle vérifie spécifiquement les paramètres vides en utilisant des Fonctions parseur conditionnelles.

Étapes suivantes[]

Maintenant que vous savez ce que sont les paramètres de modèle, vous devriez apprendre à utiliser les fonctions parseur.

Vous devriez également apprendre à documenter les paramètres de modèle.

Voir aussi[]

Advertisement