This is the template sandbox page for Template:Image array (diff). See also the companion subpage for test cases. |
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: |
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
editA 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
editTo 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
editDefault image size
editThe 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
editTo add alternative text for an image, use |altX=
, where X
is the image number.
Hint text
editTo 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
editBy 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
editTo 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
editTo add a class to the entire image array, use |class=
. For example, |class=infobox
or |class=toccolours
.
Examples.
editExample 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 |
See also
edit- {{Multiple image}}
- {{Photomontage}}
- {{Image frame}}
- Wikipedia:Collage tips