Template:Multiple image: Difference between revisions
Created page with "<includeonly><div class="thumb {{#switch: {{{align|}}} | left = tleft | center | centre = tnone | tright}}" style="width:{{#ifeq: {{{direction|horizontal}}} | vertical | {{#expr:..." |
No edit summary |
||
Line 1: | Line 1: | ||
{{#if:{{{image1|}}}{{{image2|}}}{{{image3|}}}{{{image4|}}}{{{image5|}}}{{{image6|}}}{{{image7|}}}{{{image8|}}}{{{image9|}}}{{{image10|}}}|<div class="thumb {{#switch: {{{align|}}} | left = tleft | center|centre = tnone | right|#default = tright}}" style="width: {{#switch:{{{direction|}}}<!-- | |||
If stacked vertically, box width = largest width + 12 px (6 px margin on left and right) --> | |||
{{ | | vertical = {{#expr: | ||
{{#if:{{{width|}}} | |||
| {{{width}}} | |||
{{# | | {{Max/27 | {{{width1|200}}} | {{{width2|}}} | {{{width3|}}} | {{{width4|}}} | {{{width5|}}} | {{{width6|}}} | {{{width7|}}} | {{{width8|}}} | {{{width9|}}} | {{{width10|}}} | 0 }} | ||
}} | |||
{{#if: {{{ | + 12 | ||
{{#if: {{{ | }} | ||
| horizontal | #default = {{#if:{{{width|}}}<!-- | |||
If stacked horizontally and a single common width was passed for use in all images, | |||
box width = (common width + 4px) * number of images + 8. | |||
This creates a 4px margin between the images, and a 6px margin on each side --> | |||
|{{#expr: | |||
({{{width}}}+4) | |||
* | |||
{{Template:Multiple image/numImgs | {{{image1|}}} | {{{image2|}}} | {{{image3|}}} | {{{image4|}}} | {{{image5|}}} | {{{image6|}}} | {{{image7|}}} | {{{image8|}}} | {{{image9|}}} | {{{image10|}}} }} | |||
+ | |||
8 | |||
}}<!-- | |||
If stacked horizontally and a custom width was passed for each image, | |||
box width = sum of all widths + 4 pixels of margin between each pair of images + 16 pixels of margin (8 on each side of the box) (why not 6px as in other cases?...)--> | |||
|{{#expr: | |||
{{#if:{{{image1|}}} |{{{width1|200}}}}}+ | |||
{{#if:{{{image2|}}} |{{{width2|200}}}}}+ | |||
{{#if:{{{image3|}}} |{{{width3|200}}}}}+ | |||
{{#if:{{{image4|}}} |{{{width4|200}}}}}+ | |||
{{#if:{{{image5|}}} |{{{width5|200}}}}}+ | |||
{{#if:{{{image6|}}} |{{{width6|200}}}}}+ | |||
{{#if:{{{image7|}}} |{{{width7|200}}}}}+ | |||
{{#if:{{{image8|}}} |{{{width8|200}}}}}+ | |||
{{#if:{{{image9|}}} |{{{width9|200}}}}}+ | |||
{{#if:{{{image10|}}} |{{{width10|200}}}}} | |||
+ | |||
4 * ({{Template:Multiple image/numImgs | {{{image1|}}} | {{{image2|}}} | {{{image3|}}} | {{{image4|}}} | {{{image5|}}} | {{{image6|}}} | {{{image7|}}} | {{{image8|}}} | {{{image9|}}} | {{{image10|}}} }} - 2) | |||
+ | |||
16 | |||
}} | |||
}} | |||
}}px; {{#switch: {{{align|}}} | center | centre = margin: 0 auto;}}{{#if:{{{background color|}}}|background-color: {{{background color}}} }}"> | |||
<div class="thumbinner" {{#if:{{{background color|}}}|style="background-color: {{{background color}}}"}}> | |||
{{#if:{{{header|}}}| | |||
<div style="clear: both; font-weight: bold; text-align: {{{header_align|center}}}; background-color: {{{header_background|transparent}}}"> | |||
{{{header}}} | |||
</div> | |||
}}{{#if:{{{image1|}}}| | |||
<div style="{{#ifeq: {{{direction|horizontal}}}|horizontal|float: left;}} margin: 1px; width: {{#expr: 2 + {{#if:{{{width|}}}|{{{width}}}|{{{width1|200}}}}}}}px"> | |||
<div class="thumbimage">[[file:{{{image1}}}|{{#if:{{{width|}}} | {{{width}}} | {{{width1|200}}} }}px{{#ifeq:{{{link1|:}}}|:||{{!}}link={{{link1}}}}}|alt={{{alt1|}}}|{{{caption1|}}}]] | |||
</div> | |||
{{#if:{{{caption1|}}}| | |||
<div class="thumbcaption" style="clear:left">{{{caption1}}} | |||
</div> | |||
}} | |||
</div> | |||
}}{{#if:{{{image2|}}}| | |||
<div style="{{#ifeq: {{{direction|horizontal}}}|horizontal|float: left;}} margin: 1px; width: {{#expr: 2 + {{#if:{{{width|}}}|{{{width}}}|{{{width2|200}}}}}}}px"> | |||
<div class="thumbimage">[[file:{{{image2}}}|{{#if:{{{width|}}} | {{{width}}} | {{{width2|200}}} }}px{{#ifeq:{{{link2|:}}}|:||{{!}}link={{{link2}}}}}|alt={{{alt2|}}}|{{{caption2|}}}]] | |||
</div>{{#if:{{{caption2|}}}| | |||
<div class="thumbcaption" style="clear:left">{{{caption2}}} | |||
</div> | |||
}} | |||
</div> | |||
}}{{#if:{{{image3|}}}| | |||
<div style="{{#ifeq: {{{direction|horizontal}}}|horizontal|float: left;}} margin: 1px; width: {{#expr: 2 + {{#if:{{{width|}}}|{{{width}}}|{{{width3|200}}}}}}}px"> | |||
<div class="thumbimage">[[file:{{{image3}}}|{{#if:{{{width|}}} | {{{width}}} | {{{width3|200}}} }}px{{#ifeq:{{{link3|:}}}|:||{{!}}link={{{link3}}}}}|alt={{{alt3|}}}|{{{caption3|}}}]] | |||
</div>{{#if:{{{caption3|}}}| | |||
<div class="thumbcaption" style="clear:left">{{{caption3}}} | |||
</div> | |||
}} | |||
</div> | |||
}}{{#if:{{{image4|}}}| | |||
<div style="{{#ifeq: {{{direction|horizontal}}}|horizontal|float: left;}} margin: 1px; width: {{#expr: 2 + {{#if:{{{width|}}}|{{{width}}}|{{{width4|200}}}}}}}px"> | |||
<div class="thumbimage">[[file:{{{image4}}}|{{#if:{{{width|}}} | {{{width}}} | {{{width4|200}}} }}px{{#ifeq:{{{link4|:}}}|:||{{!}}link={{{link4}}}}}|alt={{{alt4|}}}|{{{caption4|}}}]] | |||
</div>{{#if:{{{caption4|}}}| | |||
<div class="thumbcaption" style="clear:left">{{{caption4}}} | |||
</div> | |||
}} | |||
</div> | |||
}}{{#if:{{{image5|}}}| | |||
<div style="{{#ifeq: {{{direction|horizontal}}}|horizontal|float: left;}} margin: 1px; width: {{#expr: 2 + {{#if:{{{width|}}}|{{{width}}}|{{{width5|200}}}}}}}px"> | |||
<div class="thumbimage">[[file:{{{image5}}}|{{#if:{{{width|}}} | {{{width}}} | {{{width5|200}}} }}px{{#ifeq:{{{link5|:}}}|:||{{!}}link={{{link5}}}}}|alt={{{alt5|}}}|{{{caption5|}}}]] | |||
</div>{{#if:{{{caption5|}}}| | |||
<div class="thumbcaption" style="clear:left">{{{caption5}}} | |||
</div> | </div> | ||
}} | }} | ||
</ | </div> | ||
| | }}{{#if:{{{image6|}}}| | ||
<div style="{{#ifeq: {{{direction|horizontal}}}|horizontal|float: left;}} margin: 1px; width: {{#expr: 2 + {{#if:{{{width|}}}|{{{width}}}|{{{width6|200}}}}}}}px"> | |||
| | <div class="thumbimage">[[file:{{{image6}}}|{{#if:{{{width|}}} | {{{width}}} | {{{width6|200}}} }}px{{#ifeq:{{{link6|:}}}|:||{{!}}link={{{link6}}}}}|alt={{{alt6|}}}|{{{caption6|}}}]] | ||
</div>{{#if:{{{caption6|}}}| | |||
<div class="thumbcaption" style="clear:left">{{{caption6}}} | |||
</div> | |||
| | |||
< | |||
{{ | |||
| | |||
| | |||
| | |||
| | |||
| | |||
}} | }} | ||
</ | </div> | ||
| | }}{{#if:{{{image7|}}}| | ||
{{ | <div style="{{#ifeq: {{{direction|horizontal}}}|horizontal|float: left;}} margin: 1px; width: {{#expr: 2 + {{#if:{{{width|}}}|{{{width}}}|{{{width7|200}}}}}}}px"> | ||
| | <div class="thumbimage">[[file:{{{image7}}}|{{#if:{{{width|}}} | {{{width}}} | {{{width7|200}}} }}px{{#ifeq:{{{link7|:}}}|:||{{!}}link={{{link7}}}}}|alt={{{alt7|}}}|{{{caption7|}}}]] | ||
| | </div>{{#if:{{{caption7|}}}| | ||
| | <div class="thumbcaption" style="clear:left">{{{caption7}}} | ||
|width = | </div> | ||
| | |||
| | |||
}} | }} | ||
| | </div> | ||
}}{{#if:{{{image8|}}}| | |||
<div style="{{#ifeq: {{{direction|horizontal}}}|horizontal|float: left;}} margin: 1px; width: {{#expr: 2 + {{#if:{{{width|}}}|{{{width}}}|{{{width8|200}}}}}}}px"> | |||
| | <div class="thumbimage">[[file:{{{image8}}}|{{#if:{{{width|}}} | {{{width}}} | {{{width8|200}}} }}px{{#ifeq:{{{link8|:}}}|:||{{!}}link={{{link8}}}}}|alt={{{alt8|}}}|{{{caption8|}}}]] | ||
| | </div>{{#if:{{{caption8|}}}| | ||
< | <div class="thumbcaption" style="clear:left">{{{caption8}}} | ||
{{ | </div> | ||
| | |||
| | |||
| | |||
| | |||
| | |||
}} | }} | ||
</ | </div> | ||
| | }}{{#if:{{{image9|}}}| | ||
{{ | <div style="{{#ifeq: {{{direction|horizontal}}}|horizontal|float: left;}} margin: 1px; width: {{#expr: 2 + {{#if:{{{width|}}}|{{{width}}}|{{{width9|200}}}}}}}px"> | ||
| | <div class="thumbimage">[[file:{{{image9}}}|{{#if:{{{width|}}} | {{{width}}} | {{{width9|200}}} }}px{{#ifeq:{{{link9|:}}}|:||{{!}}link={{{link9}}}}}|alt={{{alt9|}}}|{{{caption9|}}}]] | ||
| | </div>{{#if:{{{caption9|}}}| | ||
<div class="thumbcaption" style="clear:left">{{{caption9}}} | |||
|width = | </div> | ||
| | |||
| | |||
}} | }} | ||
| | </div> | ||
}}{{#if:{{{image10|}}}| | |||
<div style="{{#ifeq: {{{direction|horizontal}}}|horizontal|float: left;}} margin: 1px; width: {{#expr: 2 + {{#if:{{{width|}}}|{{{width}}}|{{{width10|200}}}}}}}px"> | |||
| | <div class="thumbimage">[[file:{{{image10}}}|{{#if:{{{width|}}} | {{{width}}} | {{{width10|200}}} }}px{{#ifeq:{{{link10|:}}}|:||{{!}}link={{{link10}}}}}|alt={{{alt10|}}}|{{{caption10|}}}]] | ||
| | </div>{{#if:{{{caption10|}}}| | ||
< | <div class="thumbcaption" style="clear:left">{{{caption10}}} | ||
{{ | </div> | ||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
}} | }} | ||
</ | </div> | ||
}}{{#if:{{{footer|}}}| | |||
{{ | <div class="thumbcaption" style="clear: left; text-align: {{{footer_align|left}}}; background: {{{footer_background|transparent}}}">{{{footer}}} | ||
</div> | |||
| | |||
| | |||
| | |||
| | |||
}} | }} | ||
</div> | |||
</div> | |||
</noinclude> | }}<noinclude>{{doc}}<!-- PLEASE ADD CATEGORIES AND INTERWIKIS TO THE /doc SUBPAGE, THANKS --></noinclude> |
Revision as of 13:03, 11 September 2011
This template creates a box with two to ten images arranged vertically or horizontally with captions for the entire box and/or for each images.
Usage
- align defaults to "right"
- direction defaults to "horizontal"
- header_align defaults to "center"
- footer_align defaults to "left"
- image1 is name of first image. Similarly for image2, etc.
- width1 is width of first image. Similarly for width2, etc.
- width overrides width1, width2, width3, etc. If you want the images to be different sizes, do not provide the width parameter.
- alt1 is alt text of first image (see WP:ALT). Similarly for alt2, etc.
- caption1 is caption of first image. Similarly for caption2, etc.
- link1 is where the first page links to. Similarly for link2, etc. If not specified, image links to the image description page as usual. If specified to the empty value, the image does not link anywhere; this should be used for purely decorative images as per WP:ALT.
Important: If the image is under a free license like the GFDL or a CC license, you must not use this parameter as the terms of those licenses require the license, or a link to it, to be reproduced with the image. The image must, therefore, link to its image page. Public domain and (theoretically) fair use images are not subject to this restriction. - background color defines the background color between the border of the box and the images.
- header, footer, background color and captions are optional.
{{multiple image <!-- Essential parameters --> | align = <!-- left/right/center --> | direction = <!-- horizontal/vertical --> | width = <!-- Digits only; no "px" suffix, please --> <!-- Image 1 --> | image1 = <!-- Filename only; no "File:" or "Image:" prefix, please --> | width1 = | alt1 = | caption1 = <!-- Image 2 --> | image2 = <!-- Filename only; no "File:" or "Image:" prefix, please --> | width2 = | alt2 = | caption2 = <!-- Image 3 --> | image3 = <!-- Filename only; no "File:" or "Image:" prefix, please --> | width3 = | alt3 = | caption3 = <!-- up to |image10 is accepted --> <!-- Extra parameters --> | header = | header_align = <!-- left/right/center --> | header_background = | footer = | footer_align = <!-- left/right/center --> | footer_background = | background color = }}
Examples
{{multiple image | footer = Players are cautioned with a yellow card and sent off with a red card. | width = 60 | image1 = Yellow card.svg | alt1 = Yellow cartouche | image2 = Red card.svg | alt2 = Red cartouche }}
PNG transparency demonstration
{{multiple image | align = left | direction = vertical | header = [[PNG]] transparency demonstration | width = 200 | image1 = PNG transparency demonstration 1.png | alt1 = Colored dice with white background | caption1 = A PNG image with an 8-bit transparency layer... | image2 = PNG transparency demonstration 2.png | alt2 = Colored dice with checkered background | caption2 = ...here overlaid onto a checkered background. }}
{{multiple image | footer = When a user has many of one type of [[WP:BARN|barnstar]], they can represent them with [[WP:RIBBON|ribbons]] and these numerals to indicate the count. | width = 60 | image1 = Ribbon numeral 2.png | alt1 = 2 | image2 = Ribbon numeral 3.png | alt2 = 3 | image3 = Ribbon numeral 4.png | alt3 = 4 }}
Example with background color
{{multiple image | image1=Adoxa_moschatellina_210406.jpg | alt1=Green herb with a few tiny yellow-white flowers | image2=Adoxa_moschatellina_210406a.jpg | alt2=Three small white and yellow flowers before green-leaf background | image3=adoxa_moschatellina_blatt.jpeg | alt3=Leaves of a plant. They are in groups of three, each with three lobes. | footer=[[Adoxa]] (''Adoxa moschatellina'') | footer_background=#BBDD99 | background color=#BBDD99 | footer_align=center | width=160 }}
Example with links
{{multiple image | footer = The mule links to ''[[Mule]]'', the donkey does not link anywhere, and the trout links to its image description page as usual. | align = left | image1 = Frecklesmule.jpg | width1 = 143 | alt1 = A mule | caption1 = <center>A mule<br />骡子, ''luózi''</center> | link1 = Mule | image2 = Donkey 1 arp 750px.jpg | width2 = 150 | alt2 = A donkey | caption2 = <center>A donkey<br />驴子, lǘzi</center> | link2 = | image3 = Rainbow_trout.png | width3 = 91 | alt3 = A trout | caption3 = <center>A fish<br /> {{lang|zh|2=鱼}}, ''yú''</center> }}
Horizontal placement: matching image heights
- This trick is not required if all images have the same aspect ratio, where Template:Para suffices
- Decide on a common height for the images, say 100 pixels.
- Examine the individual image pages to obtain the full resolution. For example:
- File:Donkey 1 arp 750px.jpg shows "Donkey_1_arp_750px.jpg (750 × 536 pixels, file size: 125 KB, MIME type: image/jpeg)"
- File:Rainbow trout.png shows "Rainbow_trout.png (300 × 300 pixels, file size: 158 KB, MIME type: image/png)"
- For non-square images, use these figures to construct an expression for the Template:Para parameters, of the form:
{{#expr: (dh * ow / oh) round 0}}
- where
- dh is the desired height in pixels (100)
- ow is the original width in pixels (750 or 300)
- oh is the original height in pixels (536 or 300)
- For square images, simply set the appropriate Template:Para to be the desired height. If all are square, only Template:Para needs to be set.
{{multiple image | footer = The two images are both rendered 100 pixels high | align = right | image1 = Donkey 1 arp 750px.jpg | width1 = {{#expr: (100 * 750 / 536) round 0}} | alt1 = A donkey | caption1 = A donkey, not square and originally 536 pixels high | image2 = Rainbow_trout.png | width2 = 100 | alt2 = A trout | caption2 = A fish, square and originally 300 pixels high }}
See also
- {{Double image}}
- {{Triple image}}
ar:قالب:صور متعددة az:Şablon:Şəkillər albomu bs:Šablon:Dvostruka slika cs:Šablona:Více obrázků de:Vorlage:Mehrere Bilder dsb:Pśedłoga:Wšake wobraze eo:Ŝablono:Pluraj bildoj es:Plantilla:Imagen múltiple fa:الگو:تصویر چندگانه fr:Modèle:Multiple image hsb:Předłoha:Wjacore wobrazy id:Templat:Multiple image is:Snið:Multiple image it:Template:Immagine multipla mk:Шаблон:Повеќе слики ml:ഫലകം:Multiple image ja:Template:Multiple image pt:Predefinição:Imagem múltipla ro:Format:Imagine multiplă ru:Шаблон:Кратное изображение sk:Šablóna:Viaceré obrázky sr:Шаблон:Multiple image fi:Malline:Monta kuvaa stq:Foarloage:Moorere Bielden uk:Шаблон:Multiple image vi:Bản mẫu:Multiple image zh-yue:Template:Multiple image zh:Template:图像并列
The above documentation is transcluded from Template:Multiple image/doc. (edit | history) Editors can experiment in this template's sandbox (create) and testcases (create) pages. Please add categories and interwikis to the /doc subpage. Subpages of this template. |