Modèle:LargeurImage/Documentation

Le modèle {{LargeurImage}} calcule une largeur réduite d’image suivant deux contraintes (un minimum si possible, et un maximum absolu) respectées sur chacune de ses deux dimensions (largeur et hauteur), dont les valeurs natives sont données en paramètres. En aucun cas, la largeur retournée aura pour effet d’agrandir l’image.

Utilisation

Syntaxe

• {{LargeurImage|l=largeur|h=hauteur}}
• {{LargeurImage|l=largeur|h=hauteur|min=minimum conseillé|max=maximum absolu}}

Paramètres obligatoires

l= (ou w=)

La largeur native de l’image en pixels, telle qu’elle est affichée dans sa page d’information à sa meilleure résolution (ou sa largeur par défaut pour une image SVG).

h=

La hauteur native de l’image en pixels, telle qu’elle est affichée dans sa page d’information à sa meilleure résolution (ou sa hauteur par défaut pour une image SVG).

Paramètres optionnels

min=

Dimension en pixels minimale à respecter en hauteur comme en largeur (si possible, sauf si cela aurait pour effet d’agrandir l’image). Valeur par défaut : 252.

max=

Dimension en pixels maximale à respecter en hauteur comme en largeur (ce sera toujours le cas). Valeur par défaut : 348.

Note : dans quelques cas, uniquement avec les images au format portrait plus de deux fois plus hautes que larges, la hauteur obtenue peut légèrement dépasser ce maximum de quelques pixels ou ne pas l’atteindre, en raison de l’arrondi à l’entier le plus proche effectué sur la largeur calculée par ce modèle ; le nombre de pixels d’écart par rapport à cette hauteur maximum théorique n’excèdera jamais plus de la moitié du rapport hauteur/largeur.

Pour réduire les effets indésirables sur les bordures d’images après réduction, il est recommandé d’utiliser pour les paramètres min et max des multiples de 12, et de préférence max >= 4/3 * min (ce qui produit un rapport exact pour la conversion de la majorité des images qui présentent un rapport d’aspect 2:3 ou 3:4). Les valeurs par défaut (252 et 348) respectent ces recommandations, et restent aussi dans l’intervalle recommandé de 250 à 350 pixels maximum pour les images du jour en page d’accueil ou sur les portails.

Exemples

Cas provoquant une reduction des grandes tailles natives d’image (utilisant les valeurs par défaut min=252|max=348)

réduit la largeur à son maximum permis (la hauteur sera plus petite que le minimum préféré) :

• {{LargeurImage|l=3400|h= 600}} retourne 348 (image panoramique horizontale)
• {{LargeurImage|l=3200|h=1600}} retourne 348 (image paysage 2:1)
• {{LargeurImage|l=3000|h=2000}} retourne 348 (image paysage 3:2)

réduit la largeur dans l’intervale, en mettant la hauteur à son minimum permis :

• {{LargeurImage|l=2800|h=2100}} retourne 336 (image paysage 4:3)
• {{LargeurImage|l=2600|h=2400}} retourne 273 (image paysage presque carrée)

réduit la largeur et la hauteur à leur maximum permis :

• {{LargeurImage|l=2500|h=2500}} retourne 252 (image carrée 1:1)

réduit la hauteur dans l’intervale, en mettant la largeur to its minimum allowed :

• {{LargeurImage|l=2400|h=2600}} retourne 252 (image portrait presque carrée)
• {{LargeurImage|l=2100|h=2800}} retourne 252 (image portrait 3:4)

réduit la hauteur à son maximum permis (la largeur sera plus petite que le minimum préféré) :

• {{LargeurImage|l=2000|h=3000}} retourne 232 (image portrait 2:3)
• {{LargeurImage|l=1600|h=3200}} retourne 174 (image portrait 2:1)
• {{LargeurImage|l= 600|h=3400}} retourne 61 (image panoramique verticale)

Cas laissant qui laissent inchangées les petites tailles natives d’images (utilisant les valeurs par défaut min=252|max=348)

• {{LargeurImage|l=340|h= 60}} retourne 340 (image panoramique horizontale)
• {{LargeurImage|l=320|h=160}} retourne 320 (image paysage 2:1 landscape image)
• {{LargeurImage|l=300|h=200}} retourne 300 (image paysage 3:2 landscape image)
• {{LargeurImage|l=280|h=210}} retourne 280 (image paysage 4:3 landscape image)
• {{LargeurImage|l=260|h=240}} retourne 260 (image paysage presque carrée)
• {{LargeurImage|l=250|h=250}} retourne 250 (image carrée 1:1)
• {{LargeurImage|l=240|h=260}} retourne 240 (image portrait presque carrée)
• {{LargeurImage|l=210|h=280}} retourne 210 (image portrait 3:4)
• {{LargeurImage|l=200|h=300}} retourne 200 (image portrait 2:3)
• {{LargeurImage|l=160|h=320}} retourne 160 (image portrait 1:2)
• {{LargeurImage|l= 60|h=340}} retourne 60 (image panoramique verticale)