« Modèle:Trim/Documentation » : différence entre les versions

Dernière version du 27 mai 2025 à 19:48

Note : Ceci est une page de documentation pour un modèle.

📘 Description[modifier le wikicode]

Ce modèle supprime automatiquement les **espaces inutiles** (au début et à la fin) d’une chaîne de caractères. Il s’appuie sur la fonction Lua `#invoke:String|trim` pour effectuer ce nettoyage.

Il est utile pour s’assurer qu’un paramètre ou contenu ne provoque pas de problèmes d’affichage à cause d’espaces accidentels.

🔧 Syntaxe[modifier le wikicode]

{{Trim|1}}

1 : le texte ou paramètre à nettoyer.

🧪 Exemple[modifier le wikicode]

Avant : «{{{1}}}»
Après : «{{Trim| {{{1}}} }}»

🎨 Rendu[modifier le wikicode]

Avant : « Exemple avec espaces » Après : «»

🔍 Fonctionnalités[modifier le wikicode]

Supprime les **espaces en début et en fin de texte**.
Peut être combiné à d’autres modèles pour assurer un rendu propre.
Utile dans les infobox, tableaux, et modèles conditionnels pour éviter les faux positifs dus aux espaces.

🛠 Cas d’usage courant[modifier le wikicode]

Nettoyer les entrées utilisateur dans des modèles.
S’assurer qu’un test `…` fonctionne correctement.
Normaliser un paramètre passé à un module ou une infobox.

💡 Conseils[modifier le wikicode]

Utilisez ce modèle si vous observez un comportement étrange lié aux espaces.
Il peut être combiné à d’autres fonctions Lua pour une chaîne de traitement (ex. `lower`, `replace`, etc.).

@@ Ligne 1 : / Ligne 1 : @@
-<div class="documentation" style="background-color: #e6f4ea;">
+<noinclude><div class="documentation" style="background-color: #ECFBF3;">{{Sous-page de documentation}}</noinclude>
-{{Sous-page de documentation}}
+== 📘 Description ==
+Ce modèle supprime automatiquement les **espaces inutiles** (au début et à la fin) d’une chaîne de caractères.
+Il s’appuie sur la fonction Lua `#invoke:String|trim` pour effectuer ce nettoyage.
-== Utilisation ==
+Il est utile pour s’assurer qu’un paramètre ou contenu ne provoque pas de problèmes d’affichage à cause d’espaces accidentels.
-{{Avertissement méta-modèle}}
+== 🔧 Syntaxe ==
+<syntaxhighlight lang="wikitext">{{Trim|1}}</syntaxhighlight>
+* 1 : le texte ou paramètre à nettoyer.
-Quand un modèle affiche un paramètre non nommé, celui-ci conserve ses éventuels espaces et retours chariot avant et après. Si cela est indésirable, il est possible d'utiliser ce modèle pour effectuer un [[trim (programmation)|trim]].
+== 🧪 Exemple ==
+<syntaxhighlight lang="wikitext">
+Avant : «{{{1}}}»
+Après : «{{Trim| {{{1}}} }}»
+</syntaxhighlight>
-== Syntaxe ==
+== 🎨 Rendu ==
-<code><nowiki>{{</nowiki>trim|''<contenu>''}}</code>
+Avant : «&nbsp;&nbsp;&nbsp;Exemple avec espaces&nbsp;&nbsp;&nbsp;»
+Après : «{{Trim|   Exemple avec espaces   }}»
-== Exemples ==
+=== 🔍 Fonctionnalités ===
-=== Principe général ===
+* Supprime les **espaces en début et en fin de texte**.
-{| class="wikitable" style="margin-top:0.5em"
+* Peut être combiné à d’autres modèles pour assurer un rendu propre.
-! scope="col" | Code
+* Utile dans les infobox, tableaux, et modèles conditionnels pour éviter les faux positifs dus aux espaces.
-! scope="col" | Résultat
-|-
-| <code><nowiki>Riri{{trim| &nbsp;Fifi&nbsp; }}Loulou</nowiki></code>
-| RiriFifiLoulou
-|}
-=== Utilisation dans un modèle ===
+=== 🛠 Cas d’usage courant ===
-pour <nowiki>{{{1}}}</nowiki> valant " &nbsp;Fifi&nbsp; " :
+* Nettoyer les entrées utilisateur dans des modèles.
-{| class="wikitable" style="margin-top:0.5em"
+* S’assurer qu’un test `{{#if:{{{1}}}|…}}` fonctionne correctement.
-! scope="col" | Code
+* Normaliser un paramètre passé à un module ou une infobox.
-! scope="col" | Résultat
-|-
-| <code><nowiki>Riri{{{1}}}Loulou</nowiki></code>
-| Riri &nbsp;Fifi&nbsp; Loulou
-|-
-| <code><nowiki>Riri{{trim|{{{1}}}}}Loulou</nowiki></code>
-| RiriFifiLoulou
-|}
-<p>Pour plus d’informations, voir la [[Modèle:{{PAGENAME}}/Documentation|documentation du modèle]].</p>
+== 💡 Conseils ==
+* Utilisez ce modèle si vous observez un comportement étrange lié aux espaces.
+* Il peut être combiné à d’autres fonctions Lua pour une chaîne de traitement (ex. `lower`, `replace`, etc.).
+== 🔗 Voir aussi ==
+* [[Module:String]]
+* [[Modèle:Strtrim]]
+* [[Modèle:If]]
+* [[Aide:Modèles]]