Ce modèle à risque est inclus sur un très grand nombre de pages et ne peut pas être modifié.

Cette protection ne constitue pas obligatoirement une approbation de la version actuelle. Vous pouvez proposer une modification en page de discussion. Lorsqu'un compromis sera trouvé en page de discussion, vous pourrez demander la modification auprès des administrateurs (voir le journal des protections).

Ce modèle utilise le module Unité, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via sa sous-page bac à sable. Voir le projet Scribunto si vous voulez en savoir plus.

Le modèle {{unité}} permet d’écrire facilement et de typographier correctement un nombre écrit en chiffres arabes ou romains suivi d’une unité ou d’un nom^[1]. Par rapport à une écriture directe, ses avantages sont :

• empêcher le retour à la ligne entre le nombre et l’unité ou le nom correspondant, par l’insertion d’une espace insécable, comme dans « 30 km » ou « 1 500 habitants » ;
• faciliter l’écriture des exposants et des unités multiples, comme dans « 10 m s⁻¹ » ;
• faciliter les traductions d’articles lors d’import de valeurs (il suffit de modifier le nom du modèle) en affichant le nombre selon le format local ;
• mettre en forme le nombre automatiquement, en groupant les chiffres par groupes de trois, comme dans « 30 000 habitants ». Note : dans certains cas, la redirection {{nombre}} peut paraître préférable d’un point de vue sémantique, exemple : {{nombre|250000 déportés}} ;
• mettre en forme automatiquement les nombres en notation scientifique, comme dans « 5 × 10⁸ » ;
• ajouter une infobulle sur les unités.

Dans le cas d’un nombre « simple » suivi d'un nom, utiliser de préférence le modèle {{nobr}}. Il ne gère que les nombres sans mise en forme particulière (en particulier, sans séparateurs de milliers ni décimaux), mais est plus économe en ressources consommées par le serveur.

Dans le cas d’un nombre « simple » seul (et uniquement dans ce cas), utiliser le mot magique {{formatnum:}}, qui demande moins de ressources au serveur. Utilisé avec des nombres plus « complexes », il impose d'adopter un hybride de typographie anglo-saxonne (séparateurs décimal et de milliers). En particulier, dans le cas d’un nombre suivi d’une partie décimale (comprenant des chiffres après la virgule), il prend le point comme séparateur décimal (au lieu de la virgule) et ne peut afficher correctement que trois chiffres de la partie décimale (ex. : {{formatnum:3.141592}}), ce qui n’est pas le cas de {{unité}} (voir : « Wikipédia:Conventions typographiques#Nombres et espaces » et « Formatage de formatnum: »).

Dans le cas des écritures fractionnaires (barre de fraction en argument du modèle), le modèle ne respecte pas les conventions concernant les nombres sur Wikipédia.

Deux syntaxes sont possibles, mais il ne faut pas les mélanger.

• Syntaxe simple (un nombre) :

  {{Unité|nombre|unité1|exposant1|unité2|exposant2|unité3|exposant3|unité4|exposant4|unité5|exposant5}}

Un seul paramètre est indispensable, nombre ou unité₁.

• Syntaxe plus complexe (deux nombres) :

  {{Unité|premier nombre|à=second nombre|et=second nombre|±=incertitude|e=puissance de 10|unité1|exposant1|symbole2|unité2|symbole3|unité3|unité4|exposant4|unité5|exposant5}}

Les paramètres à= (pour une plage de valeurs) et et= (pour une paire de valeurs) sont facultatifs mais mutuellement exclusifs. Les paramètres ±=, e= ainsi que les unités et les exposants sont facultatifs.

• {{Unité|nombre1 à/et nombre2 ± incertitude epuissance-de-10 unité1exposant1 unité2exposant2 unité3exposant3 unité4exposant4 unité5exposant5}}

Le terme « à/et » est à remplacer par à (plage de valeurs) ou et (paire de valeurs). Il faut au moins indiquer nombre1, ± incertitude ou unité1 ; à cette exigence près, nombre1, les groupes à/et nombre2, ± incertitude et epuissance-de-10 ainsi que les unités et leurs exposants sont tous facultatifs.

Le modèle interprète aussi correctement le signe de fraction, par exemple g/cm3 pour « g/cm³ » (gramme par centimètre cube).

Cette possibilité ne permet pas de gérer certains cas complexes, souvent des détournements du modèle, tels que plusieurs nombres séparés par du texte dans un seul modèle, par exemple « 1,23 jusqu’à 2,32 m² », ou des nombres ou exposants contenant des lettres (des variables mathématiques), par exemple « 2,5y e²ⁱ ».

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

Une unité complexe peut être spécifiée à l’aide d’un paramètre seul ou décomposée sous la forme d’une liste symbole|exposant. On peut omettre l’exposant (quand il vaut 1), en laissant simplement son champ vide. Le modèle accepte jusqu'à cinq symboles accompagnés chacun d'un exposant.

Le modèle reconnaît aussi bien le point que la virgule comme séparateur décimal, par exemple :

• « {{Unité|2,3|g}} » affiche « 2,3 g » ;
• « {{Unité|2.3|g}} » affiche « 2,3 g » ;
• « {{Unité|1002,3|km}} » affiche « 1 002,3 km » ;
• « {{Unité|1002.3|km}} » affiche « 1 002,3 km » ;
• « {{Unité|1,002.3|km}} » affiche « 1 002,3 km » ;
• « {{Unité|1 002.3|km}} » affiche « 1 002,3 km » ;
• « {{Unité|1234567890.12345678|¤}} » affiche « 1 234 567 890,123 456 78 ¤ » ;
• « {{Unité|1.002,3|km}} » affiche « 1,002 3 km » pour être compatible avec les limites précédentes du modèle, mais cette syntaxe est déconseillée car non conforme aux conventions typographiques.

La syntaxe à un paramètre simplifie la saisie :

• {{Unité|1,23 ± 0,02 e-3 m/s2}} affiche « (1,23 ± 0,02) × 10⁻³ m/s² ».

Pour les nombres sans mise en forme particulière et suivis d'un nom, utiliser de préférence le modèle {{nobr}}, plus simple. Pour typographier les nombres seuls, n’étant pas en notation scientifique, ne comportant que trois chiffres décimaux au plus, et non suivis d'une unité ou d’un nom, le mot magique « {{formatnum:nombre}} » est suffisant.

Ce modèle est inutile et déconseillé lorsque l’unité est le « pour cent ». Cela complique l’édition et la lecture du code wiki pour un résultat identique. Il suffit d’insérer une espace simple car, dans ce cas particulier, l’espace insécable est automatiquement gérée par MediaWiki, voir les conventions typographiques.

Note : en revanche, ce modèle doit être utilisé lorsque l’unité est le « pour mille ». {{Unité|5|‰}} aura pour rendu : 5 ‰.

Dans le cas des unités sexagésimales d’angle (mesure d’angle, latitude, longitude) et du degré d’alcool, le symbole d’unité ne doit pas être détaché du nombre. Il ne faut donc pas utiliser ce modèle.

On écrira donc simplement : « un angle de 30° », « un vin titrant 11° ».

Dans le cas de coordonnées composées, il est souhaitable d’utiliser le modèle {{nobr}} : {{nobr|35° 19′ 20″}} de latitude N qui donne : 35° 19′ 20″ de latitude N.

Le symbole « a » est celui de l'are ou d'annum (année julienne).

• « {{Unité|123 a}} » affiche « 123 a » avec l'infobulle « are ».
• « {{Unité|3 cm/an}} » affiche « 3 cm/an » avec l'infobulle « centimètre par an ».

Les multiples et sous-multiples usuels sont gérés correctement (absence d'ambiguïté, en pratique) : ca et ha (qui concernent l'are), ka, Ma et Ga (qui concernent l'annum).

• « F » est le symbole du farad.

« {{Unité|123 F}} » affiche « 123 F » avec l'infobulle « farad ».

• « F » est aussi l'abréviation courante des unités monétaires (actuelles ou anciennes) portant le nom de « franc » (ex. : franc suisse, franc CFA, franc Pacifique, franc français).

• « {{Unité|123 N m}} » affiche « 123 N m » avec l'infobulle « newton mètre ».
• « {{Unité|123 Nm3}} » affiche « 123 Nm³ » avec l'infobulle « normo mètre cube ».
  • « {{Unité|123 Nm}} » affiche « 123 Nm » avec l'infobulle « normo mètre ».

• « {{Unité|123 MN}} » affiche « 123 MN » avec l'infobulle « méganewton ».
• « MN » est aussi le symbole du mille marin.

• « {{Unité|64 b}} » affiche « 64 b » avec l'infobulle « bit ».
• « b » est aussi le symbole du barn.

MediaWiki retire automatiquement les balises HTML/CSS indésirables qui sont dans le paramètre |alt= pour être conforme aux normes W3C, ajouter le modèle {{unité}} n’est donc pas utile et n’aura aucun effet.

La Wikipédia anglophone n’a pas de modèle identique, mais utilise un modèle similaire, « val », qui permet d’indiquer un intervalle approximatif et une unité de mesure.

Ne pas utiliser la version francophone {{val}}, mais plutôt ce modèle {{unité}}.

• {{unité/2}} qui offre plus de possibilités (conversions, approximations, intervalles)
• {{Température}} qui permet de mettre en forme une température
• {{λ}} qui permet de formater les longueurs d’onde
• {{Monnaie}} qui permet de formater les devises
• {{Dunité}} qui sert à indiquer les deux dimensions d’un objet rectangulaire, par exemple d’une peinture
• {{Tunité}} qui sert à indiquer les trois dimensions d’un objet parallélépipédique, par exemple d’une tombe
• Aide:Syntaxe#Les nombres
• Wikipédia:Conventions concernant les nombres
• 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.
• Catégorie:Page incorrectement traitée par le Module:Unité