Ce modèle utilise le module Multiple image, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via une sous-page bac à sable. Voir le projet Scribunto si vous voulez en savoir plus.
Ce modèle utilise la feuille de style Image multiple/styles.css en CSS. Voir l'aide de l'extension TemplateStyles si vous voulez en savoir plus.
Ce modèle crée une boîte contenant entre deux et dix images, disposées verticalement ou horizontalement et avec des légendes pour la boîte entière ou par image.
Avec le choix approprié des paramètres, le modèle peut automatiquement redimensionner les images à une largeur totale donnée, chaque image ayant la même hauteur.
Sachez que ce modèle ne respecte pas les préférences de taille d'image par défaut des utilisateurs. L'ancienne version non-Lua de ce modèle imposait aussi une taille en pixels aux images, ce qui est en contradiction avec la recommandation sur la mise en forme des images : son usage était donc déconseillé dans l'espace encyclopédique et la prudence reste conseillée dans sa nouvelle version.
Si les paramètres de taille d'image sont omis, ce modèle définit toutes les images à 200px de largeur, indépendamment du fait que le lecteur ait défini une préférence pour une autre largeur d'image par défaut. Ceci provoque la visualisation hors échelle de plusieurs images par rapport aux autres images d'un article.
Mode d'emploi
Paramètre
Description
align
right(à droite, par défaut), left (à gauche), center (centré)
direction
horizontal(par défaut), vertical
header
Titre de la vignette, placé au-dessus de toutes les images.
header_align
Paramètre de l'alignement du titre de la vignette : left (à gauche), center (centré, par défaut), right (à droite)
width
Permet de définir la même largeur pour chaque image (c'est-à-dire qu'elle remplace toute largeur width[n] ci-dessous). Ne pas inclure si des largeurs d'image différentes sont prévues, y compris si les images doivent être redimensionnées à une largeur totale fixe.
total_width
Permet de mettre à l'échelle les images à la même hauteur et à la même largeur totale. N'utilisez pas à la fois la largeur totale total_width et la largeur simple width.
image[n]
(où [n] = 1 à 10) Nom de fichier de la [n]e image.
width[n]
(comme ci-dessus) Deux significations: (1) La largeur (en pixel, en nombre entier, en évitant « px ») de l'image [n]. Annulé par width (si installé). (2) La largeur complète de l'image originale [n] si total_width (la largeur totale) est remplie afin de redimensionner toutes les images à la même hauteur et à une largeur totale de votre choix.
height[n]
(comme ci-dessus) La hauteur entière de l'image [n] d'origine si total_width (la largeur totale) est remplie afin de redimensionner toutes les images à la même hauteur et à une largeur totale de votre choix. Sinon, le paramètre est ignoré.
alt[n]
(comme ci-dessus)Alt description pour une image [n] (numérotée de 1 à 10).
Remarque : Ce paramètre ne doit pas être utilisé avec des images qui ont reçu des licences libres (telles que la licence GDFL ou une licence CC libre) car ces licences exigent que les images soient liées à une déclaration de la licence sous laquelle elles sont utilisées.
thumbtime[n]
(comme ci-dessus) Lorsqu'on utilise des fichiers vidéo (Ogg theora), ce paramètre indique quel moment de la vidéo est affiché pour l’affichage initial. Pour cela, il faut indiquer soit un nombre uniquement en secondes, soit utiliser le format heures:minutes:secondes ; voir aussi commons:Commons:Video#Setting a video thumbnail image.
caption[n]
(comme ci-dessus) Légende pour l'image [n].
caption_align
left(à gauche, par défaut), center(centré), right(à droite).
footer
Titre du pied de vignette. Prend toute la largeur du pied de la vignette multi-images, par opposition aux images individuelles. Évitez si possible les options left (à gauche) et right (à droite), car les appareils mobiles peuvent afficher les images verticalement.
footer_align
Paramètre de l'alignement du titre du pied de vignette : left (à gauche, par défaut), center (centré), right (à droite)
et les chiffres indiquent le nombre de lauriers décernés.
{{multiple image
| footer = Quand un utilisateur a plusieurs fois les mêmes [[Wikipédia:Décernez les lauriers|lauriers]],
ils peuvent les représenter avec un [[WP:Rubans|ruban]]
et les chiffres indiquent le nombre de lauriers décernés.
| width = 60
| image1 = Ribbon numeral 2.png
| alt1 = 2
| image2 = Ribbon numeral 3.png
| alt2 = 3
| image3 = Ribbon numeral 4.png
| alt3 = 4
}}
Exemple avec liens
Un mulet
Un âne
Une truite
Le mulet dirige vers Mulet, l'âne ne dirige vers rien et la truite dirige vers la page de description de l'image (par défaut).
{{multiple image
| footer = Le mulet dirige vers ''[[Mulet]]'', l'âne ne dirige vers rien et la truite dirige vers la page de description de l'image (par défaut).
| align = left
| image1 = Juancito2.png
| width1 = 143
| alt1 = Un mulet
| caption1 = {{centrer|Un mulet}}
| link1 = Mulet
| image2 = Donkey 1 arp 750px.jpg
| width2 = 150
| alt2 = Un âne
| caption2 = {{centrer|Un âne}}
| link2 =
| image3 = Rainbow_trout.png
| width3 = 91
| alt3 = Une truite
| caption3 = {{centrer|Une truite}}
}}
La mise en forme multiligne est préférée pour ce modèle.
Paramètre
Description
Type
État
Alignement
align
Alignement des images sur la page : right (à droite, par défaut), left (à gauche), center (centré)
Valeurs suggérées
leftcenterright
Exemple
right
Chaîne
facultatif
Direction
direction
Direction d'affichage des images : horizontal (par défaut) ou vertical.
Valeurs suggérées
horizontalvertical
Exemple
horizontal
Chaîne
suggéré
Titre
header
Titre de la vignette, placé au-dessus de toutes les images.
Exemple
Plusieurs photos du même sujet.
Chaîne
suggéré
Alignement du titre
header_align
Alignement du titre des images
Valeurs suggérées
leftcenterright
Exemple
left
Chaîne
facultatif
Couleur de fond du titre
header_background
Code hexa de la couleur de fond du titre des images.
Exemple
#bbdd99
Chaîne
obsolète
Pied de vignette
footer
Titre affiché sous les images. Prend toute la largeur du pied de la vignette multi-images, par opposition aux images individuelles. Évitez si possible les options left (à gauche) et right (à droite), car les appareils mobiles peuvent afficher les images verticalement.
Exemple
Plusieurs images d’un même sujet.
Chaîne
suggéré
Alignement du pied de vignette
footer_align
Paramètre de l'alignement du titre du pied de vignette : left (à gauche, par défaut), center (centré), right (à droite).
Valeurs suggérées
leftcenterright
Exemple
center
Chaîne
facultatif
Couleur de fond du pied de vignette
footer_background
Code hexa de la couleur de fond du pied de vignette.
Exemple
#bbdd99
Chaîne
obsolète
Largeur des images
width
Permet de définir la même largeur pour chaque image (S’impose à TOUTES les images). Ne pas inclure si des largeurs d'image différentes sont prévues, y compris si les images doivent être redimensionnées à une largeur totale fixe.
Exemple
120
Nombre
facultatif
Image 1
image1
Première image
Exemple
New Hampshire Red Hen.jpg
Fichier
obligatoire
Texte alternatif à l’image 1
alt1
Texte alternatif à l’image 1, utilisé pour l’accessibilité (lecteurs d’écran, etc).
Exemple
Photo d’une poule rousse.
Chaîne
suggéré
Légende de l’image 1
caption1
Légende propre à l’image 1, affichée sous celle-ci.
Exemple
Une poule de race New Hampshire.
Chaîne
suggéré
Largeur de l’image 1
width1
Largeur en pixels de l’image 1.
Exemple
140
Nombre
facultatif
Hauteur de l’image 1
height1
Hauteur en pixels de l’image 1
Exemple
150
Nombre
facultatif
Image 2
image2
Deuxième image.
Exemple
White Hen in Norway.jpg
Fichier
obligatoire
Texte alternatif à l’image 2
alt2
Texte alternatif à l’image 2, utilisé pour l’accessibilité (lecteurs d’écran, etc).
Exemple
Photo d'une poule blanche.
Chaîne
suggéré
Légende de l’image 2
caption2
Légende propre à l’image 2, affichée sous celle-ci.
Exemple
Poule norvégienne.
Chaîne
suggéré
Largeur de l’image 2
width2
Largeur en pixels de l’image 2
Exemple
160
Nombre
facultatif
Hauteur de l’image 2
height2
Hauteur en pixels de l’image 2
Exemple
150
Nombre
facultatif
Image 3
image3
aucune description
Fichier
facultatif
Texte alternatif à l’image 3
alt3
aucune description
Chaîne
facultatif
Légende de l’image 3
caption3
aucune description
Chaîne
facultatif
Largeur de l’image 3
width3
aucune description
Nombre
facultatif
Hauteur de l’image 3
height3
aucune description
Nombre
facultatif
Image 4
image4
aucune description
Fichier
facultatif
Texte alternatif à l’image 4
alt4
aucune description
Chaîne
facultatif
Légende de l’image 4
caption4
aucune description
Chaîne
facultatif
Largeur de l’image 4
width4
aucune description
Nombre
facultatif
Hauteur de l’image 4
height4
aucune description
Nombre
facultatif
Image 5
image5
aucune description
Fichier
facultatif
Texte alternatif à l’image 5
alt5
aucune description
Chaîne
facultatif
Légende de l’image 5
caption5
aucune description
Chaîne
facultatif
Largeur de l’image 5
width5
aucune description
Nombre
facultatif
Hauteur de l’image 5
height5
aucune description
Nombre
facultatif
Alignement des légendes
caption_align
Alignement des légendes par rapport aux images qu’elles concernent.
Valeurs suggérées
leftcenterright
Exemple
left
Chaîne
facultatif
Largeur totale
total_width
Permet de mettre à l'échelle les images à la même hauteur et à la même largeur totale. N'utilisez pas à la fois la largeur totale total_width et la largeur simple width.