Modèle:Nombre avec unité

Un article de Wikipédia, l'encyclopédie libre.

Le modèle {{Nombre avec unité}} (et son alias {{Unité}}) permet d’écrire facilement et de typographier correctement un nombre suivi d’une unité. Par rapport à une écriture directe, ses avantages sont :

• mettre en forme le nombre automatiquement en groupant les chiffres par groupes de trois, comme dans « 30 000 âmes » ;
• éviter un retour à la ligne automatique entre le nombre et l’unité correspondante, comme dans « 30 km » en fin de ligne ;
• faciliter l’écriture des exposants et des unités multiples, comme dans « 10 m∙s^-1 ».

Syntaxe :

• {{Nombre avec unité|nombre|unité₁|puissance₁|symbole₂|puissance₂|symbole₃|puissance₃|symbole₄|puissance₄}}
• {{Nombre avec unité|nombre|e=puissance de 10|unité₁|puissance₁|symbole₂|puissance₂|symbole₃|puissance₃|symbole₄|puissance₄}}

Paramètres :

Le modèle peut prendre jusqu’à neuf paramètres numéroté et un paramètre nommé:

Paramètre	Description	Type
1=	Valeur à afficher	Obligatoire
e=	Puissance de 10 à afficher	Facultatif
2=	Premier symbole	Obligatoire
3=	Exposant du premier symbole	Facultatif
4=	Deuxième symbole	Facultatif
5=	Exposant du deuxième symbole	Facultatif
6=	Troisième symbole	Facultatif
7=	Exposant du troisième symbole	Facultatif
8=	Quatrième symbole	Facultatif
9=	Exposant du quatrième symbole	Facultatif

Seuls les deux premiers paramètres numérotés sont obligatoires : il est possible de spécifier l’unité en une seule fois (ce qui permet d’utiliser une unité quelconque) ou de la décomposer sous la forme d’une liste symbole|exposant. Il est aussi possible de ne pas mettre d’exposant (quand il vaut 1), pour cela, il suffit de laisser celui-ci vide. Au maximum, il est possible d’afficher quatre symboles possédant chacun un exposant.

  Attention :

Le premier paramètre, celui de la valeur à afficher, est mis en forme à l’aide du mot magique {{formatnum:}}. Par conséquent :

• il faut utiliser le point comme séparateur décimal (convention anglo-saxonne), et non la virgule, dans le paramètre transmis au modèle. Le modèle affichera automatiquement le nombre suivant les conventions francophones.
• le mot magique ne sait pas convertir les notations scientifiques exponentielles (utilisant le symbole e avant l’exposant entier) ; on placera l’exposant entier dans le paramètre nommé e ;
• il ne faut pas insérer de séparateurs de milliers sous forme d’espace ou d’apostrophe : ils sont automatiquement ajoutés par le modèle sous forme d’espace (insécable).
• il est cependant possible de grouper les chiffres autrement que par trois, en insérant explicitement une virgule comme séparateur (convention anglo-saxonne), laquelle sera transformée en espace par le modèle.

Exemples :

• « {{Unité|2,3|%}} » affiche « 2 3 % », ce qui n’est sans doute pas le résultat attendu ;
• entrer « {{Unité|2.3|%}} » pour afficher « 2,3 % » ;
• entrer « {{Unité|1002.3|km}} » ou « {{Unité|1,002.3|km}} » pour afficher « 1 002,3 km » ;
• noter encore « {{Unité|12345,67890.12345678|¤}} » qui affiche « 12 345 67 890,12345678 ¤ », etc.

Exemples d’utilisation :

Syntaxe	Résultat	Commentaire
{{Unité|10000|km}} {{Unité|10000|km/h}} {{Unité|10000|km²}}	10 000 km 10 000 km/h 10 000 km²	Cas d’utilisation minimale : une valeur suivie d’un symbole.
{{Unité|10000|kilomètres par heure}}	10 000 kilomètres par heure	(Non conseillé.) Il est possible d’écrire l’unité en toutes lettres. Dans ce cas il n’est cependant pas strictement nécessaire d’empêcher une rupture de ligne entre le nombre et l’unité complète, seul le premier terme doit être lié au nombre, ici « {{Unité|10000|kilomètres}} par heure ». Notez cependant que le modèle {{Nombre avec unité}} empêche les ruptures de ligne dans toute l’expression « 10 000 kilomètres par heure ».
{{Unité|10000|km||h|-1}}	10 000 km∙h-1	Deux symboles successifs, le second avec un exposant.
{{Unité|10000|J|2|K|3|s|-1}}	10 000 J2∙K3∙s-1	Trois symboles avec des exposants spécifiques.
{{Unité|10000|J||kg||m|-2}}	10 000 J∙kg∙m-2	Trois symboles, les deux premiers ne possédant pas d’exposant.
{{Unité|-40.234|°C}}	-40,234 °C	Cas mettant en évidence l’utilisation de la notation anglo-saxonne dans le premier paramètre, lequel est affiché selon les conventions francophones.
{{Unité|1.23456|e=9|J|2|K|3|s|-1}}	1,23456×109 J2∙K3∙s-1	Trois symboles avec des exposants spécifiques, mettant en évidence l’utilisation de la notation anglo-saxonne, ainsi que l’usage de puissances de 10 (usage scientifique) dans le paramètre nommé e, formaté à l’aide du modèle {{x10}}.
{{Unité|1|[[kilomètre|km]]²}}	1 km²	Il est aussi possible de placer un lien vers les unités.

Nombres sans unité :

Pour typographier correctement une quantité sans unité, veuillez plutôt utiliser le mot magique « {{formatnum:}} » de la façon suivante :

{{formatnum:nombre}}

(Notez la présence du deux-points plutôt que la barre verticale.)

Voir aussi :

• Espace insécable, obtenue par «   » dans MediaWiki — éviter la rupture de ligne sur une espace.
• {{x10}} — notation scientifique avec puissance de 10.
• {{exp}} — mettre en exposant.
• {{nobr}} — éviter une rupture d’une ligne dans une expression.
• Aide de « formatnum » sur Meta.
• en:Category:Unit display : groupe de modèle à fonction équivalente, sur (en).

Ce modèle emploie quelques fonctionnalités complexes de la syntaxe des ParserFunctions. Veuillez ne pas tenter de le modifier à moins que vous ne soyez certain de bien comprendre sa conception et êtes préparé à réparer tous les dommages collatéraux si les résultats sont inattendus. Toute expérimentation devrait être conduite d’abord via une copie sur le Modèle bac à sable ou dans votre espace utilisateur. Cliquez ici pour purger le cache lorsque vos modifications n’apparaissent pas.