Modèle:Image multiple/Documentation
Ceci est la page de documentation de Modèle:Image multiple [modifier] [purger].
Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.
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 Multiple image/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 |
| background color | Pour définir la couleur de fond de la boîte dans laquelle les images apparaissent. |
| 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) |
| header_background | |
| 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). |
| link[n] | (comme ci-dessus) Pour spécifier la page à laquelle la[n]ième image est liée (c'est-à-dire la page qui est chargée lorsque l'image est cliquée). Si elle est définie comme vide (par exemple, ...|alt1=... |link1= |caption1=...), le lien est désactivé (même vers la page standard de description des images Wikipedia) ; voir Wikipédia:Atelier accessibilité/Bonnes pratiques.
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) |
| footer_background |
{{multiple image
| align = left/right/center
| direction = horizontal/vertical
| header =
| header_align = left/right/center
| header_background =
| footer =
| footer_align = left/right/center
| footer_background =
| width =
| image1 =
| width1 =
| alt1 =
| caption1 =
| image2 =
| width2 =
| alt2 =
| caption2 =
| image3 =
| width3 =
| alt3 =
| caption3 =
| image4 =
| width4 =
| alt4 =
| caption4 =
| image5 =
| width5 =
| alt5 =
| caption5 =
}}
Exemples
{{multiple image
| footer = Les joueurs peuvent recevoir un carton jaune (avertissement) ou un carton rouge (expulsion).
| width = 60
| image1 = Yellow card.svg
| alt1 = Carton jaune
| image2 = Red card.svg
| alt2 = Carton rouge
}}
{{multiple image
| align = left
| direction = vertical
| header = Démonstration de la transparence [[Portable Network Graphics|PNG]]
| width = 200
| image1 = PNG transparency demonstration 1.png
| alt1 = Dés colorés avec fond blanc
| caption1 = Une image PNG avec une couche 8-bit de transparence...
| image2 = PNG transparency demonstration 2.png
| alt2 = Dés colorés avec fond en damier
| caption2 = ... ici avec un fond en damier.
}}
{{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 arrière-plan
{{multiple image
| image1=Adoxa_moschatellina_210406.jpg
| alt1=Herbe verte avec quelques petites fleurs blanches et jaunes
| image2=Adoxa_moschatellina_210406a.jpg
| alt2=Trois petites fleurs blanches et jaunes avec feuilles vertes en arrière-plan
| image3=adoxa_moschatellina_blatt.jpeg
| alt3=Feuilles d'une plante. Elles viennent en groupe de trois, chacune avec trois lobes.
| footer=[[Adoxe moscatelline|Petite musquée]] (''Adoxe moscatelline'')
| footer_background=#BBDD99
| background color=#BBDD99
| footer_align=center
| width=160
}}
Exemple avec liens
{{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}}
}}