Template:Image array/sandbox

This is the template sandbox page for Template:Image array (diff).
See also the companion subpage for test cases.

Template documentation[view] [edit] [history] [purge]

Before making a gallery, please read over the image use policy for galleries. Generally, a gallery should not be added so long as there is space for images to be effectively presented adjacent to text.

This template uses Lua:

Module:Image array (sandbox)

This template is used to generate a rectangular image array, typically for use within an infobox. For image galleries, please use {{gallery}} or <gallery>...</gallery>. For most other uses, please consider using {{multiple image}} instead.

Basic usage[edit]

A 4x4 image array

{{image array|perrow = 4
| image1 =   | caption1 =
| image2 =   | caption2 =
| image3 =   | caption3 =
| image4 =   | caption4 =
| image5 =   | caption5 =
| image6 =   | caption6 =
| image7 =   | caption7 =
| image8 =   | caption8 =
| image9 =   | caption9 =
| image10 =  | caption10 =
| image11 =  | caption11 =
| image12 =  | caption12 =
| image13 =  | caption13 =
| image14 =  | caption14 =
| image15 =  | caption15 =
| image16 =  | caption16 =
}}

{{image array
| perrow    = 4
| image1    = 
| caption1  = 
| image2    = 
| caption2  = 
| image3    = 
| caption3  = 
| image4    = 
| caption4  = 
| image5    = 
| caption5  = 
| image6    = 
| caption6  = 
| image7    = 
| caption7  = 
| image8    = 
| caption8  = 
| image9    = 
| caption9  = 
| image10   = 
| caption10 = 
| image11   = 
| caption11 = 
| image12   = 
| caption12 = 
| image13   = 
| caption13 = 
| image14   = 
| caption14 = 
| image15   = 
| caption15 = 
| image16   = 
| caption16 = 
}}

A 5x5 image array

{{image array|perrow = 5
| image1 =   | caption1 =
| image2 =   | caption2 =
| image3 =   | caption3 =
| image4 =   | caption4 =
| image5 =   | caption5 =
| image6 =   | caption6 =
| image7 =   | caption7 =
| image8 =   | caption8 =
| image9 =   | caption9 =
| image10 =  | caption10 =
| image11 =  | caption11 =
| image12 =  | caption12 =
| image13 =  | caption13 =
| image14 =  | caption14 =
| image15 =  | caption15 =
| image16 =  | caption16 =
| image17 =  | caption17 =
| image18 =  | caption18 =
| image19 =  | caption19 =
| image20 =  | caption20 =
| image21 =  | caption21 =
| image22 =  | caption22 =
| image23 =  | caption23 =
| image24 =  | caption24 =
| image25 =  | caption25 =
}}

A 5x6 image array

{{image array|perrow = 5
| image1 =   | caption1 =
| image2 =   | caption2 =
| image3 =   | caption3 =
| image4 =   | caption4 =
| image5 =   | caption5 =
| image6 =   | caption6 =
| image7 =   | caption7 =
| image8 =   | caption8 =
| image9 =   | caption9 =
| image10 =  | caption10 =
| image11 =  | caption11 =
| image12 =  | caption12 =
| image13 =  | caption13 =
| image14 =  | caption14 =
| image15 =  | caption15 =
| image16 =  | caption16 =
| image17 =  | caption17 =
| image18 =  | caption18 =
| image19 =  | caption19 =
| image20 =  | caption20 =
| image21 =  | caption21 =
| image22 =  | caption22 =
| image23 =  | caption23 =
| image24 =  | caption24 =
| image25 =  | caption25 =
| image26 =  | caption26 =
| image27 =  | caption27 =
| image28 =  | caption28 =
| image29 =  | caption29 =
| image30 =  | caption30 =
}}

Embedding[edit]

To create a simple floating image array, use the template with {{Image frame}}.

{{Image frame
| content = {{image array|perrow = 4
| image1 =   | caption1 =
| image2 =   | caption2 =
| image3 =   | caption3 =
| image4 =   | caption4 =
| image5 =   | caption5 =
| image6 =   | caption6 =
| image7 =   | caption7 =
| image8 =   | caption8 =
| image9 =   | caption9 =
| image10 =  | caption10 =
| image11 =  | caption11 =
| image12 =  | caption12 =
| image13 =  | caption13 =
| image14 =  | caption14 =
| image15 =  | caption15 =
| image16 =  | caption16 =
}}
}}

Additional parameters[edit]

Default image size[edit]

The default image size is 60px by 70px. To override this default, use |width=YY and |height=ZZ, where YY and ZZ are raw numbers, without the px units.

Alternative text[edit]

To add alternative text for an image, use |altX=, where X is the image number.

Hint text[edit]

To add hint or tooltip text for an image, use |textX=, where X is the image number. To use the captions for the hint or tooltip text for all images, use |text=y.

Link text[edit]

By default, clicking on an image will direct the viewer to the file page, which contains licensing and attribution information for the image. This is required for any non-public domain images. To change the link to the image, use |linkX=, where X is the image number. However, be careful to make sure that you only do this for public domain images that do not require attribution.

Borders[edit]

To add a standard image border to an image, use |borderX=, where X is the image number. To add a border around all the image cells, use |border-width=X, where X is the width in pixels.

Classes[edit]

To add a class to the entire image array, use |class=. For example, |class=infobox or |class=toccolours.

Examples.[edit]

Example 1: images only[edit]

{{Image array
| image1 = On The Streets of Vilnius (5984257911).jpg
| image2 = Taiwanese Buddhist Nun Black Robes.jpeg
| image3 = Louise Marie Thérèse (The Black Nun of Moret).jpg
| image4 = Pakistani Nun - Convent School Rawalpindi.jpg
}}

Example 2: optional parameters[edit]

{{Image array
| perrow = 2
| width = 140
| height = 140
| border-width = 2
| image1 = On The Streets of Vilnius (5984257911).jpg | caption1 = caption1
| alt1 = alt1 | text1 = text1 | link1 = Vilnius
| image2 = Taiwanese Buddhist Nun Black Robes.jpeg | caption2 = caption2
| alt2 = alt2 | text2 = text2 | link2 = Bhikkhuni
| image3 = Louise Marie Thérèse (The Black Nun of Moret).jpg | caption3 = caption3
| alt3 = alt3 | text3 = text3 | link3 = Louise Marie Therese
| image4 = Pakistani Nun - Convent School Rawalpindi.jpg | caption4 = caption4
| alt4 = alt4 | text4 = text4 | link4 = Rawalpindi
}}

caption1	caption2
caption3	caption4