Modification de Modèle:Oui non/Documentation

{{Sous-page de documentation}}

== Utilisation ==

Ce modèle permet de normaliser un paramètre booléen.

Le modèle distingue quatre cas différents suivant le contenu du premier paramètre :
# oui, o, yes, y ou 1 (en minuscules ou majuscules)
# non, n, no, ou 0 (en minuscules ou majuscules)
# vide ou uniquement des espaces
# autre

Par défaut le modèle retourne « oui » dans le premier et le dernier cas, rien dans les autres cas.

== Syntaxe ==
 <nowiki>{{ Oui non | paramètre à analyser }}</nowiki>
 <nowiki>{{ Oui non | paramètre à analyser |oui=oui |non= |vide= |défaut=oui }}</nowiki>

== Paramètres ==
Les paramètres permettent de personnaliser le résultat suivant les quatre cas :

# '''oui''' :  valeur retournée si la valeur du paramètre analysé est <code>oui, o, yes, y, </code> ou <code>1</code> (par défaut : ''oui'')
# '''non''' : valeur retournée si la valeur du paramètre analysé est <code>non, no, n</code> ou <code>0</code> (par défaut ne retourne rien)
# '''vide''' : valeur retournée si le paramètre est vide ou absent (par défaut ne retourne rien)
# '''défaut''' : valeur retournée dans les autres cas (par défaut : ''oui'')

=== Clarification des cas "vide" et "défaut" ===

Le cas "vide" signifiant que le paramètre est vide ou omis, on peut considérer qu'il s'agit là du "cas par défaut" à proprement parler.

Le cas "défaut" signifiant que la valeur n'est pas reconnue par le modèle, il est fortement souhaitable d'éviter ce cas de figure.

== Exemples == 
* <code><nowiki>{{ Oui non | oui }}</nowiki></code> → {{ Oui non | oui}}
* <code><nowiki>{{ Oui non | Oui }}</nowiki></code> → {{ Oui non | oui}}
* <code><nowiki>{{ Oui non | OUI }}</nowiki></code> → {{ Oui non | oui}}
* <code><nowiki>{{ Oui non | o }}</nowiki></code> → {{ Oui non | o}}
* <code><nowiki>{{ Oui non | yes }}</nowiki></code> → {{ Oui non | yes}}
* <code><nowiki>{{ Oui non | 1 }}</nowiki></code> → {{ Oui non | 1}}
* <code><nowiki>{{ Oui non | non }}</nowiki></code> → {{ Oui non | non}}
* <code><nowiki>{{ Oui non | Non }}</nowiki></code> → {{ Oui non | non}}
* <code><nowiki>{{ Oui non | NON }}</nowiki></code> → {{ Oui non | non}}
* <code><nowiki>{{ Oui non | n }}</nowiki></code> → {{ Oui non | n}}
* <code><nowiki>{{ Oui non | N }}</nowiki></code> → {{ Oui non | n}}
* <code><nowiki>{{ Oui non | 0 }}</nowiki></code> → {{ Oui non | 0}}
* <code><nowiki>{{ Oui non | }}</nowiki></code> → {{ Oui non |  }}
* <code><nowiki>{{ Oui non | un contenu quelconque }}</nowiki></code> → {{ Oui non | un contenu quelconque}}

'''oui''' :
* <code><nowiki>{{ Oui non | oui | oui=OUI }}</nowiki></code> → {{ Oui non | y|oui=OUI}}
* <code><nowiki>{{ Oui non | oui | oui=jambon }}</nowiki></code> → {{ Oui non | 1|oui=jambon}}

'''non''' :
* <code><nowiki>{{ Oui non | n | non=NON }}</nowiki></code> → {{ Oui non | n|non=NON}}
* <code><nowiki>{{ Oui non | 0 | non=pomme de terre }}</nowiki></code> → {{ Oui non | 0|non=pomme de terre}}

'''vide''' :
* <code><nowiki>{{ Oui non |  | vide=tomate }}</nowiki></code> → {{ Oui non |  |vide=tomate}}
* <code><nowiki>{{ Oui non | | vide=tomate | non=pomme }}</nowiki></code> → {{ Oui non | |vide=tomate|non=pomme}}
* <code><nowiki>{{ Oui non | vide=tomate }}</nowiki></code> → {{ Oui non |vide=tomate}}

'''défaut''' :
* <code><nowiki>{{ Oui non | je ne sais pas | défaut=OUI }}</nowiki></code> → {{ Oui non | je ne sais pas|défaut=OUI}}
* <code><nowiki>{{ Oui non | je ne sais pas | oui=jambon }}</nowiki></code> → {{ Oui non | je ne sais pas|oui=jambon}}
* <code><nowiki>{{ Oui non | je ne sais pas | défaut= }}</nowiki></code> → {{ Oui non | je ne sais pas|défaut=}}
* <code><nowiki>{{ Oui non | peut-être | oui=jambon | défaut=rosbif }}</nowiki></code> → {{ Oui non | peut-être|oui=jambon|défaut=rosbif}}
* <code><nowiki>{{ Oui non | 5| oui=jambon | défaut=rosbif }}</nowiki></code> → {{ Oui non | 5|oui=jambon|défaut=rosbif}}

=== Utilisation dans un #if ===

Pour avoir un code clair et éventuellement éviter des duplications, il peut être judicieux d'employer ce modèle dans un <code>#if</code> :

<pre>
{{#if: {{Oui non|{{{paramètre|}}}}}
  | paramètre vaut "oui"
  | paramètre vaut "non" ou est absent/vide
}}
</pre>

<pre>
{{#if: {{Oui non|{{{paramètre|}}}|vide=oui}}
  | paramètre vaut "oui" ou est absent/vide
  | paramètre vaut "non"
}}
</pre>

Rappel : comme indiqué [[#Clarification des cas "vide" et "défaut"|précédemment]], il est préférable que le cas "défaut" ne se produise jamais, et il ne devrait donc pas être nécessaire de le prendre en compte.


===Logical distinctions===

{| class=wikitable border=1 cellpadding=2 style="text-align:left; width:100%;"
|-
! colspan=7 style="background:#d0d0d0;" | Résumé des valeurs retournés par le modèle « {{Oui non}} »
|- style="text-align:left; vertical-align:top; font-weight:bold; background:#e8e8e8;"
| <br />parametre 1<br />({{code|1=1=}})
| code
| logique
| valeur par défaut
|
| texte retourné avec :<br />{{code|1=oui=Positif}}<br />{{code|1=non=Negatif}}<br />{{code|1=vide=Néant}}<br />{{code|1=defaut=Autre}}
|-
| oui, OUI, o, yes, y, 1
| {{code|1=<nowiki>{{Oui non|oui}}</nowiki>}}
| {{nobr|{{code|oui par définition}}}}
| "{{Oui non|oui}}"
|
| "{{Oui non|oui|oui=Positif|non=Negatif |vide=Néant |défaut=Autre}}"
|-
| {{nobr|Texte quelconque}}
| {{nobr|{{code|1=<nowiki>{{Oui non|Texte quelconque}}</nowiki>}}}}
| {{code|oui par défault}}
| "{{Oui non|Texte quelconque}}"
|
| "{{Oui non|Texte quelconque|oui=Posisitif |non=Negatif |vide=Néant |défaut=Autre}}"
|-
| non, NON, no, n, 0
| {{code|1=<nowiki>{{Oui non|non}}</nowiki>}}
| {{code|non par définition}}
| "{{Oui non|non}}"
|
| "{{Oui non|non|oui=Positif|non=Negatif |vide=Néant |défaut=Autre}}"
|-
| &lt;vide>
| {{code|1=<nowiki>{{Oui non|}}</nowiki>}}
| {{code|vide}}
| "{{Oui non|1=}}"
|
| "{{Oui non||oui=Positif|non=Negatif |vide=Néant |défaut=Autre}}"
|}
<includeonly>
[[Catégorie:Modèle de formatage]]
</includeonly>