Module:Outils/Documentation

Ceci est la page de documentation de Module:Outils [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son module d'origine et elle n'est pas destinée à être visualisée directement.

Ce module contient différentes fonction pratiques.

Résumé des fonctions

Fonctions exportables :

trim(frame) – similaire à mw.text.trim mais renvoi nil lorsque la chaine est vide et ne génère pas d'erreur lorsque le paramètre n'est pas une chaine (revoit nil).
erreur() – destiné à affiché une message d'erreur en gros et rouge. Retourne la chaine transmise dans un span de class "error". Par défaut aucune erreur indiquée.
extractArgs – retourne une table avec les paramètres, à partir d'un objet frame, d'une table ou d'une liste de paramètre.
validTextArg – retourne le premier paramètre chaine non vide à partir de la table des paramètres et d'une liste de nom de paramètres
notEmpty() – retourne le premier élément non vide.
abr – génère une chaine d'abréviation discrète (ou non)
nobr – équivalent de {{nobr}}, transforme la chaine fournie en chaine insécable.
ordinal – retourne un ordinal abrégé comme {{1er}}, {{2e}}… à partir d'un nombre ou d'une chaine contenant uniquement des chiffres. Si le deuxième est défini, retourne 1^re au lieu de 1^er.
nombre2texte_reel – transforme un nombre en texte (5 → cinq ou cinquième). gère la langue (fr, be, ch), l'orthographe pré ou post 1990, le genre
nombre2texte – similaire à nombre2texte_reel mais pour un appel depuis un modèle.

Modules externes et autres éléments dont ce module a besoin pour fonctionner :

Module:Outils/Data – pour les conversion nombre → texte.

Détail par fonction

extractArgs

Outils.extractArgs( frame, ... )

... peut être la listed des paramètres supplémentaire passé au modèle ou une liste de nom de paramètres. Les résultats sont différents.
si frame n'est pas une table, retourne { frame, ... }
Si frame est une table simple et non une objet Frame, retourne frame
Si frame est un objet créé par #invoke:, retourne les paramètres passé à #invoke: (en priorité) et ceux passées au modèle. Si le paramètre invokeArgsOnly n'est pas vide, seul les paramètres transmis à invoke seront utilisés.

Exemple

function p.maFonction( frame, ... )
    local args = Outils.extractArgs( frame, ... )
    return ( args[1] or 'nil' ) .. ' ' .. ( args[2] or 'nil' ) .. ' ' .. ( args['nom'] or 'nil' )
end

appel direct : p.maFonction( 'oui', 'deux', 'Zebulon84' ) → « oui deux nil » (impossible de transmetre un paramètre nommé)
appel par table : p.maFonction{ 'oui', 'deux', nom = 'Zebulon84' } → « oui deux Zebulon84 »
appel par #invoke: : {{#invoke:p |maFonction |oui |2 |nom = Zebulon84}} → « oui deux Zebulon84 »
appel par modèle {{Ma fonction}} :
- le modèle contient {{#invoke:p |maFonction}},
  - {{Ma fonction|oui | deux |nom= Zebulon84}} → « oui deux Zebulon84 »
- le modèle contient {{#invoke:p |maFonction |nom = Zebulon84}}
  - {{Ma fonction |oui | deux }} → « oui deux Zebulon84 »
  - {{Ma fonction |oui | deux |nom = Hexasoft}} → « oui deux Zebulon84 »
- le modèle contient {{#invoke:p |maFonction |nom = {{{nom|Zebulon84}}} }}
  - {{Ma fonction |oui | deux }} → « oui deux Zebulon84 »
  - {{Ma fonction |oui | deux |nom = Hexasoft}} → « oui deux Hexasoft »
  - {{Ma fonction |oui | deux |nom = }} → « oui deux nil »
- le modèle contient {{#invoke:p |maFonction |nom = {{{nom|Zebulon84}}} |invokeArgsOnly = oui}}
  - {{Ma fonction |oui | deux }} → « nil nil Zebulon84 »
  - {{Ma fonction |oui | deux |nom = Hexasoft}} → « nil nil Hexasoft»