Modèl:Gallery

Modèl dokimantasyon

Utilisation

Ce modèle permet de présenter des séries d'images en galerie, et de déterminer globalement ou séparément la taille (largeur, hauteur) qu'elles doivent avoir.

Contraintes liées à l'accessibilité

► Voir la discussion archivée du projet accessibilité, qui a fait remonter des problèmes lié à l'affichage en fonction des écrans :

• Taille fixée des images en pixels (180 px par défaut), sans redimensionnement automatique des vignettes en fonction de la taille des écrans
• Hauteur des légendes limitée, de sorte que le texte peut être partiellement masqué, en étant accessible seulement au moyen d'une barre de défilement
• Vide trop important entre le bas de la légende et le texte sous les images quand il y a deux rang d'images

► Voir Aide:Galerie pour l'utilisation de la balise <gallery>

Syntaxe

Chaque image doit être intégrée à la galerie avec la syntaxe suivante :

• {{Gallery|File:Nom du fichier |altn=Texte Alternatif |Légende}}

Paramètres

• File : indique le nom complet du fichier image. Les deux préfixes File: ou Image: peuvent être utilisés au choix.
• Altn : l'attribut alt se divise en alt1= pour la première image, alt2= pour la deuxième image, etc. Ce texte alternatif qui accompagne et décrit l'image est utilisé par les déficients visuels, ou par d'autres lecteurs qui ne peuvent pas bien voir cette image. S'il n'est pas précisé ici, aucun texte alternatif n'apparaîtra.
• Légende : texte de la légende à placer sous l'image.

Paramètres optionnels

Les paramètres suivants s'appliquent à l'ensemble de la galerie :

• title : titre de la galerie ;
• align : définit la position de la galerie sur la page, qui peut être alignée sur left (par défaut), center ou right ;
• footer : permet d'insérer un texte en petits caractères en-dessous de la galerie, aligné à droite ;
• style : définit les règles de style CSS à appliquer sur l'ensemble de la galerie.

Les paramètres suivants s'appliquent à toutes les images de la galerie :

• height : la hauteur maximale de chaque image. La valeur par défaut est de 180 pixels ;
• width : la largeur maximale, dont la valeur par défaut est de 180 pixels ;
• cellwidth : la largeur de chaque case ou cellule contenant une image. Par défaut, sa valeur est la même que width. En revanche, si une valeur est précisée, alors elle prend le pas sur celle indiquée pour width ;
• lines : le nombre de lignes requises pour la légende la plus grande (par défaut, sa valeur est de 2).

Le paramètre suivant s'applique à chaque image individuellement :

• widthn (n étant un chiffre) : détermine la largeur de l'image n quand celle-ci doit être différente de la valeur indiquée par width.

Exemples

• {{Gallery | title = {{m|Gallery}} | lines = 5 | width = 200 | height= 250 | align = center | footer=Texte sous les images | File:Deutsch-französische Grenzländer, mit genauer Einzeichnung der französischen Befestigungs-Anlagen.jpg |Frontière franco-allemande, montrant l'emplacement exact du système de fortifications français. 1/400 000e. Version réduite de la carte spéciale d'Alsace-Lorraine d'Algermissen. | File:McWay Falls Big Sur May 2011 001.jpg|Les chutes McWay (McWay Falls) dans le parc d'État Julia Pfeiffer, à [[Big Sur]] en Californie. | File:Kaleidoscope.webm|Vue intérieure d'un kaléidoscope. }}

{{Gallery}}

Frontière franco-allemande, montrant l'emplacement exact du système de fortifications français. 1/400 000e. Version réduite de la carte spéciale d'Alsace-Lorraine d'Algermissen. Frontière franco-allemande, montrant l'emplacement exact du système de fortifications français. 1/400 000e. Version réduite de la carte spéciale d'Alsace-Lorraine d'Algermissen.  Les chutes McWay (McWay Falls) dans le parc d'État Julia Pfeiffer, à Big Sur en Californie. Les chutes McWay (McWay Falls) dans le parc d'État Julia Pfeiffer, à Big Sur en Californie.  Vue intérieure d'un kaléidoscope. Vue intérieure d'un kaléidoscope.

Texte sous les images

• {{Gallery |title=Représentations de George Washington |width=120 |height=100 |lines=4 |align=center |footer=Exemple 2 |File:Federal Hall NYC 27.JPG | alt1=Une statue fait face à un bâtiment avec des colonnes grecques |Statue de Washington devant le [[Federal Hall]] de [[New York City]], face à [[Wall Street]]. |File:Mount Rushmore2.jpg | alt2=Un visage en pierre sculpté dans la montagne, vu de profil, avec 3 ouvriers. |Création du portrait de Washington sur le [[Mont Rushmore]], v. 1932. |File:2006 Quarter Proof.png | alt3=Pièce argentée brillante, arborant un buste de Washington. |Washington représenté sur une pièce de 25 cents. |File:United_States_one_dollar_bill,_obverse.jpg | width4=200 | alt4=Recto d'un billet de banque américain, avec le portrait de Washington au centre. |Billet d'un dollar américain. |File:George Washington Presidential $1 Coin obverse.png | alt5=Pièce d'or arborant un buste de Washington tourné vers la gauche |Washington sur une pièce d'un dollar. }}

Représentations de George Washington

Statue de Washington devant le Federal Hall de New York City, face à Wall Street. Statue de Washington devant le Federal Hall de New York City, face à Wall Street.  Création du portrait de Washington sur le Mont Rushmore, v. 1932. Création du portrait de Washington sur le Mont Rushmore, v. 1932.  Washington représenté sur une pièce de 25 cents. Washington représenté sur une pièce de 25 cents.  Billet d'un dollar américain. Billet d'un dollar américain.  Washington sur une pièce d'un dollar. Washington sur une pièce d'un dollar.

Exemple 2

Dans cet exemple, le paramètre width4=200 détermine la largeur de la Modèl:4e image, de sorte que le billet de un dollar est plus large que les autres images de la galerie. On voit que la place allouée à la légende en revanche n'est pas modifiée, et elle est sur deux lignes alors qu'une seule suffirait.