Modification de Aide:Modèle/Avancé

Pour créer des modèles complexes, comme les [[Aide:Infobox|Infoboxes]], il est préférable d'avoir des notions de programmation.


==Variables==
Les variables sont identifiées par un entourage de triples accolades : <code><nowiki>{{{Variable}}}</nowiki></code>. Une variable peut être obligatoire ou non dans un modèle, et elle peut être nommée ou non :

*Variables non nommées : Un modèle appelé de cette manière <code><nowiki>{{Modèle|Variable 1|Variable 2}}</nowiki></code> utilise dans son codes des variables non nommées, qui se présentent ainsi : <code><nowiki>{{{1}}}</nowiki></code>, <code><nowiki>{{{2}}}</nowiki></code>. Le code <code><nowiki>{{{1}}}</nowiki></code> prend la valeur de la première variable indiquée (dans notre exemple : {{citer|Variable 1}}), <code><nowiki>{{{2}}}</nowiki></code> prend la deuxième valeur indiquée, et ainsi de suite pour les chiffres suivants.
*Variables nommées : Un modèle appelé de cette manière <code><nowiki>{{Modèle|Valeur=1|Poids=2}}</nowiki></code> utilise des variables nommées représentées dans son code par <code><nowiki>{{{Valeur}}}</nowiki></code>, <code><nowiki>{{{Poids}}}</nowiki></code>. Contrairement aux variables non nommées, l'ordre des valeurs ne compte pas, uniquement le nom indiqué.
*Valeur par défaut : Pour indiquer une valeur par défaut pour une variable, il faut indiquer cette valeur dans le code de la variable à droite d'un ''pipe'' : <code><nowiki>{{{1|Par défaut}}}</nowiki></code>. La valeur par défaut peut être laissée à vide.
**Il est possible de rendre disponibles plusieurs noms de variables pour un même usage en exploitant la valeur par défaut : il suffit de définir le contenu d'une variable nommée comme la valeur par défaut d'une autre. Par exemple, ce code permet d'utiliser les noms ''Valeur'', ''Paramètre'' ou bien la variable en première position : <code><nowiki>{{{Valeur|{{{Paramètre|{{{1|}}}}}}}}}</nowiki></code>

À noter que si une variable est susceptible d'accepter une [[Aide:Listes|liste]] comme valeur, aucun code ne doit précéder le sien pour que la liste fonctionne. En d'autres termes, les trois accolades entrantes doivent se trouver sur une nouvelle ligne.


==Inclusion==
Le code inscrit sur la page des modèles est conçu pour être appelés par d'autres articles, mais il est possible de définir le comportement de certaines portions de code en les plaçant entre certaines balises :
*''Noinclude'' : Tout code se trouvant entre ces balises sera ignoré lors de l'utilisation du modèle. On placera les instructions d'utilisation du modèle entre ces balises.
*''Includeonly'' : Le code se trouvant entre ces balises ne s'affichera que si le modèle est appelé, et pas sur sa propre page. Utilisé pour masquer le modèle sur sa page si nécessaire (si la configuration de base du modèle ne peut constituer un exemple).

Les modèles voués à être utilisés au sein d'une phrase (comme [[:Modèle:Citer]]) ne doivent pas faire usage de ces codes. Les instructions d'utilisation doivent être portées sur la page de discussion du modèle.

Un modèle peut être appelé sur sa propre page sans risque de boucle infinie.


==Fonctions du parseur==
L'extension ParserFunction fournie avec MediaWiki offre plusieurs types d'opérateurs logiques. En règle général, on effectue les tests sur des variables.

===If===
<pre>{{#if: {{{Variable testée|}}} | Résultat si la variable contient quelque chose | Résultat si la variable est vide ou ne contient que des espaces ou des retours à la ligne}}</pre>

*Il est important d'inclure une valeur par défaut vide avec la variable afin de s'assurer que le test fonctionne.
*Il est possible de ne pas inclure le dernier résultat si rien ne doit être affiché quand la Valeur de test est vide.
*Un if peut contenir un autre if.

===Égalité===
<pre>{{#ifeq: {{{Variable testée|}}} | Valeur de comparaison | Résultat si les deux premiers paramètres sont égaux | Résultat si les deux premiers paramètres sont différents}}</pre>

*Le test fonctionne avec des chaînes de caractères comme avec des nombres.
*Le test entre chaînes de caractères est sensible à la casse.

===Switch===
<pre>{{#switch: {{{Variable testée|}}}
|Valeur 1 = Résultat si la variable et cette valeur sont égales
|Valeur 2 = Idem
|Valeur 3 = Idem
| Valeur à utiliser si la variable ne correspond à aucune des valeurs listées
}}
</pre>

===Tableaux===
Le ''pipe'' {{citer|{{!}}}} étant utilisé comme marqueur dans les fonctions du parseur, il ne sera pas interprété correctement lorsqu'on veut afficher directement ce caractère, comme pour les [[Aide:Tableaux|tableaux]]. Pour résoudre ce problème, il faut remplacer les ''pipes'' qu'on souhaite afficher par {{citer|<nowiki>{{!}}</nowiki>}}.


{{Modèle:Aide}}