Editing Help/Images (section)

=== Optional gallery attributes === <!--T:145-->

<!--T:146-->
The gallery tag itself takes several additional parameters, specified as attribute name-value pairs:
</translate>

<syntaxhighlight lang=html>
<gallery {parameters}>
{images}
</gallery>
</syntaxhighlight>

<translate>
<!--T:147-->
* <code>caption="{caption}"</code>: (caption text between double quotes for more than one word) sets a caption centered atop the gallery. Only plain text may be used in the caption; formatting, templates and the like will not work.</translate>
<translate>
<!--T:148-->
* <code>widths={width}</code>: sets the (max) widths of the images in pixels; the [[<tvar name=options>Special:MyLanguage/Manual:$wgGalleryOptions</tvar>|default value]] is 120px.</translate> <translate><!--T:271--> (It has no effect if mode is set to one of the following: <tvar name=1>packed, packed-overlay, packed-hover, slideshow</tvar>.)</translate> ''<translate><!--T:149--> Note the plural: width'''s'''</translate>''.
<translate>
<!--T:150-->
* <code>heights={heights}</code>: sets the (max) heights of the images in pixels; the default value is 120px.</translate> <translate><!--T:272--> (It has no effect if mode is set to <tvar name=1>slideshow</tvar>.)</translate>
<translate>
<!--T:151-->
* <code>perrow={integer}</code>: sets the number of images per row.</translate> <translate><!--T:273--> (It has no effect if mode is set to one of the following: <tvar name=1>packed, packed-overlay, packed-hover, slideshow</tvar>.)</translate> <translate><!--T:152--> The default is <tvar name=1><code>perrow=0</code></tvar> which automatically adjusts the number of images per row based on width of screen.</translate>
<translate>
<!--T:153-->
* <code>showfilename={anything}</code>: Show the filenames of the images in the individual captions for each image (1.17+).</translate>
<translate>
<!--T:154-->
* <code>mode={traditional|nolines|packed|packed-hover|packed-overlay|slideshow}</code>: See section above (1.22+; 1.28+ for "slideshow").</translate>
<translate>
<!--T:241-->
* <code>showthumbnails</code>: For "slideshow" mode only, display the strip with image thumbnails below the slideshow by default (1.29+).
</translate>
* <translate><!--T:289--> Any html attribute allowed on a <tvar name=1><code>&lt;ul&gt;</code></tvar> tag (e.g. <tvar name=2><code>id</code></tvar>, <tvar name=3><code>title</code></tvar>, <tvar name=4><code>class</code></tvar>)</translate>

{{note|1=<translate><!--T:292--> In packed (and related) modes, the widths parameter has no effect; instead, the heights parameter determines the minimum height of the images.</translate> <translate><!--T:156--> Packed modes adjust the width of images to ensure that each row is of equal length, except when a row contains too few images to achieve this without excessively enlarging the images.</translate>}}

<translate>
<!--T:260-->
; Example 1

<!--T:261-->
Syntax:
</translate>

<syntaxhighlight lang=html>
<gallery widths=300 heights=200>
File:Example.jpg|Lorem ipsum
File:Example.jpg|Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
</gallery>
</syntaxhighlight>

<translate>
<!--T:262-->
Result:
</translate>

<gallery widths="300" heights="200">
File:Example.jpg|Lorem ipsum
File:Example.jpg|Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
</gallery>

<translate>
<!--T:157-->
; Example 2

<!--T:263-->
Syntax:
</translate>

<syntaxhighlight lang=html>
<gallery widths=60 heights=60 perrow=7 caption="<translate nowrap><!--T:288--> sunflowers are groovy</translate>">
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
</gallery>
</syntaxhighlight>

<translate>
<!--T:159-->
Result:
</translate>

<gallery widths="60" heights="60" perrow="7" caption="">
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
</gallery>

<translate>