模板:Multiple image/doc

「Template:MI」重新導向至此，您可能想尋找頁面Template:Mi。

本模板可生成一個垂直或水平排列多張圖片的框，可以水平或者垂直組合，並給整個框或者單獨的圖片添加說明文字。

適當選擇參數可以讓模板自動將圖像大小調整為給定的總寬度，每個圖像具有相同的高度。

語法和參數

提供height[n]和total_width參數用於自動調整尺寸。

自動將所有圖像調整為相同的高度和給定的總寬度

{{Multiple image|total_width = 600
<!-- 布局参数 -->
| align             = <!-- right（默认）、left、center、none --> 
| direction         = <!-- horizontal（默认）、vertical -->
| background color  = <!-- 框的背景颜色，web颜色，例如#33CC00 -->
| width             = <!-- 每个图像宽度显示的像素数（整数，省略“px”后缀）；会被下面的“width[n]”覆盖 -->
| caption_align     = <!-- left（默认）、center、right --> 
| image_style       = <!-- border:1;（默认） -->
| image_gap         = <!-- 5（默认）-->

<!-- 顶部 -->
| header_background = <!-- 顶部的背景颜色，web颜色形式，如#33CC00 -->
| header_align      = <!-- center（默认）、left、right -->
| header            = <!-- 顶部文本 -->

<!--图像1-->
| image1            = <!-- 仅文件名称，不含“File:”或“Image:”前缀 -->
| width1            = <!-- 图像的显示宽度，会忽略上面的“width” -->
| alt1              = 
| link1             = 
| thumbtime1        =
| caption1          = 
<!--图像2-->
| image2            = <!-- 仅文件名称，不含“File:”或“Image:”前缀 -->
| width2            = <!-- 图像的显示宽度，会忽略上面的“width” -->
| alt2              = 
| link2             = 
| thumbtime2        =
| caption2          = 
<!-- 依此类推，最多10个（image10） -->

<!-- 底部 -->
| footer_background = <!-- 底部的背景，web颜色形式，如#33CC00 -->
| footer_align      = <!-- left（默认）、center、right -->
| footer            = <!-- 底部的文本 -->
}}

沒有將所有圖像自動調整為相同高度的大小

{{multiple image
<!-- 布局参数 -->
 | align             = <!-- right（默认）、left、center、none --> 
 | direction         = <!-- horizontal（默认）、vertical -->
 | background color  = <!-- box background -->
 | total_width       = <!-- 所有图片的总宽度的像素数（整数，忽略“px”后缀） -->
 | caption_align     = <!-- left（默认）、center、right --> 

<!-- 顶部 -->
 | header_background = 
 | header_align      = <!-- center（默认）、left、right -->
 | header            = 

<!--图像1-->
 | image1            = <!-- 仅文件名称，不含“File:”或“Image:”前缀 -->
 | alt1              = 
 | link1             = 
 | thumbtime1        =
 | caption1          = 
<!--图像2-->
 | image2            = <!-- 仅文件名称，不含“File:”或“Image:”前缀 -->
 | alt2              = 
 | link2             = 
 | thumbtime2        =
 | caption2          = 
<!-- 依此类推，最多10个（image10） -->

<!-- 底部 -->
 | footer_background = 
 | footer_align      = <!-- left（默认）、center、right -->
 | footer            = 
}}

參數	描述
align	right （預設）、left、center
direction	horizontal （預設）、vertical
background color	設定包含了各圖像的框的背景顏色。
header_background
header_align	center （預設）、left、right
header
width	用於給每個圖像（覆蓋下面的width[n]）設定相同的寬度。如果想要不同的圖像寬度，包括如果要將圖像大小調整為固定的總寬度，則不要使用此參數。
total_width	用於將圖像調整為相同的高度，總寬度為這個值。不要同時使用total_width和width。
image[n]	（[n] = 1到10）  第n個圖像的檔案名稱。
width[n]	（同上）  兩個含義：(1) 第n個圖像的寬度（像素數，省略「px」）。會被width覆蓋（如果設定了）。(2) 如果提供了total_width參數以將所有圖像的大小調整為相同的寬度的指定的高度，則此值為原先的第n個圖像的總寬度。
height[n]	（同上）  如果提供了total_width以將所有圖像的大小調整為相同的高度和指定的寬度，則此值為第n個圖像的完整高度。其他情況下會忽略。
alt[n]	（同上）  第n個圖像的替代文字。
link[n]	（同上）  第n個圖像連結至的頁面。 如果完全忽略了這個參數，那麼圖像和往常一樣，連結至圖像的描述頁。 如果此參數存在但是留空，圖像不會有連結，根據WP:ALT，這通常用於圖像僅用途裝飾的情況。
thumbtime[n]	（同上）  使用視訊檔時，設定最初顯示的時間位置。
caption[n]	（同上）  第n個圖像的描述文字。
caption_align	left （預設）、center、right
footer_background
footer_align	left （預設）、center、right
footer	包含整個框寬度範圍的描述文字，區別與單獨的圖像。如有可能，請避免「left」和「right」，因此銩裝置可能會將圖片垂直顯示。

範例

黃牌用於警告，紅牌用於罰下。

{{multiple image
 | width = 60
 | image1 = Yellow card.svg
 | alt1 = 黃色橢圓形邊緣
 | image2 = Red card.svg
 | alt2 = 紅色橢圓形邊緣
 | footer = 黃牌用於警告，紅牌用於罰下。
}}

PNG 透明度示範

具有8位元透明度圖層的PNG圖像...

...這裡覆蓋一個方格的背景。

{{multiple image
 | align = left
 | direction = vertical
 | width = 200
 | header = [[Portable Network Graphics|PNG]] 透明度示範
 | image1 = PNG transparency demonstration 1.png
 | alt1 = 彩色骰子加白色背景
 | caption1 = 具有8位元透明度圖層的PNG圖像...
 | image2 = PNG transparency demonstration 2.png
 | alt2 = 彩色骰子加方格背景
 | caption2 = ...這裡覆蓋一個方格的背景。
}}

使用background color

Adoxa（五福花）

{{multiple image
 | background color = #BBDD99
 | width = 160
 | image1 = Adoxa_moschatellina_210406.jpg
 | alt1 = 綠草與一些小黃白色的花
 | image2 = Adoxa_moschatellina_210406a.jpg
 | alt2 = 在綠色葉子背景前的三朵小白色和黃色的花
 | image3 = adoxa_moschatellina_blatt.jpeg
 | alt3 = 一棵植物的葉，每組有三個，每個有三塊葉
 | footer_background = #BBDD99
 | footer_align = center
 | footer = Adoxa（[[五福花]]）
}}

使用連結 (link[n])

A mule
（騾子 luózi）

A donkey
（驢子 lǘzi）

A fish
(魚 yú)

騾子的圖像連結至騾子，驢子的圖像則沒有連結，鮭魚的圖像連結至圖像的描述頁面。

{{multiple image
 | align = left

 | image1 = Frecklesmule.jpg
 | width1 = 143
 | alt1 = A mule
 | link1 = 骡子
 | caption1 = A mule<br />（骡子 ''luózi''）

 | image2 = Donkey 1 arp 750px.jpg
 | width2 = 150
 | alt2 = 驴子
 | link2 = 
 | caption2  = A donkey<br />（驴子 ''lǘzi''）

 | image3 = Rainbow_trout.png
 | width3 = 91
 | alt3 = 鲑鱼
 | caption3  = A fish<br />({{lang|zh|2=鱼}} ''yú'')

 | footer = 骡子的图像链接至[[骡子]]，驴子的图像则没有链接，鲑鱼的图像链接至图像的描述页面。
}}

多行

要建立一系列的圖像並帶有多行，使用|perrow=，其值可以是一個單獨的數字，或者是由/分隔的一組數字。此功能可以和|total_width=組合使用，用於多行圖片相同的總寬度。

測量裝置。從左上角順時針：光學經緯儀、機器人全站儀、光學水準儀、即時運動學GPS基站。

{{multiple image|perrow = 2|total_width=300
| image1 = Kern_Theodolit_DKM2-A.jpg  |width1=319|height1=425
| image2 = Total-Robotic-Station.jpg  |width2=1728|height2=3072
| image3 = DumpyLevel.jpg  |width3=1600|height3=1200
| image4 = GPS_Survey_Equipment_at_Weir_Dyke_Bridge_-_geograph.org.uk_-_336908.jpg|width4=427|height4=640
| footer = 测量设备。从左上角顺时针：光学经纬仪、机器人全站仪、光学水准仪、实时运动学GPS基站。
}}

模板資料

以下是該模板的模板資料，適用於視覺化編輯器等工具。

Multiple image模板資料

建立一個帶有兩個或者多個水平或者豎直排行的圖像的框，並帶有整個框或者單獨的每個圖像的描述文字。

模板參數

此模板有自訂格式。

參數		描述	類型	狀態
對齊	align	設定圖像框周圍的文字環繞，其中「none」將框放置在不帶文字環繞的左邊緣，「center」將框放在不帶文字環繞的中心，「left」和「right」指的是帶文字環繞框在螢幕上的位置。 建議值 left center right none 預設 right 範例 left/right/center/none	字串	非必填
方向	direction	平鋪圖像的方向。 建議值 horizontal vertical 預設 horizontal 範例 horizontal/vertical	字串	建議
框寬度	total_width	用於將圖像縮放到相同的高度和總寬度。不要同時使用total_width和width。以像素為單位的整數寬度；沒有「px」字尾 範例 400	數值	建議
行布局	perrow	建立有多行的一系列圖像。值可以是單個數字，也可以是每行由「/」分隔的一組數字。可以與total_width組合使用以自動調整圖像大小。 範例 1 / 2 / 1	字串	非必填
圖像寬度	width	會覆蓋width1、width2、width3等，如果你需要為圖像設定不同的寬度，不要使用此參數。整數，單位為像素，但不帶「px」字尾。 範例 200	數值	非必填
背景顏色	background color	定義框的邊框和圖像之間的背景色。變更背景可能影響無障礙訪問，請儘可能避免。 範例 #EEFFGG或red	字串	非必填
描述文字的對齊	caption_align	沒有描述 建議值 left center right 預設 left 範例 left/right/center	字串	非必填
圖像1	image1	第1個圖像的名稱。僅檔案名稱，不帶「File:」或「Image:」字首。 範例 example.jpg	檔案	必填
寬度1	width1	第1個圖像的寬度。	數值	非必填
替代文字	alt1	第1個圖像的替代文字。	行	建議
描述1	caption1	第1個圖像的描述文字。	內容	建議
連結1	link1	第1個圖像連結至的頁面。如果沒有指定，則圖像連結至描述頁面。如果指定為空值，則沒有連結，根據[[WP:ALT]]，當圖像僅用途裝飾時適用於這種情況。	頁面名稱	非必填
訊框時間1	thumbtime1	如果第1個圖像是Ogg Theroa檔案，設定初始位置的時間。秒數，或者是「時:分:秒」形式。	字串	非必填
圖像2	image2	沒有描述 範例 example.jpg	檔案	建議
寬度2	width2	沒有描述	數值	非必填
替代文字2	alt2	沒有描述	行	建議
描述2	caption2	沒有描述	內容	建議
連結2	link2	沒有描述	頁面名稱	非必填
訊框時間2	thumbtime2	沒有描述	字串	非必填
圖像3	image3	沒有描述 範例 example.jpg	檔案	非必填
寬度3	width3	沒有描述	數值	非必填
替代文字3	alt3	沒有描述	行	非必填
描述3	caption3	沒有描述	內容	非必填
連結3	link3	沒有描述	頁面名稱	非必填
訊框時間3	thumbtime3	沒有描述	字串	非必填
圖像4	image4	沒有描述 範例 example.jpg	檔案	非必填
寬度4	width4	沒有描述	數值	非必填
替代文字4	alt4	沒有描述	行	非必填
描述4	caption4	沒有描述	內容	非必填
連結4	link4	沒有描述	頁面名稱	非必填
訊框時間4	thumbtime4	沒有描述	字串	非必填
圖像5	image5	沒有描述 範例 example.jpg	檔案	非必填
寬度5	width5	沒有描述	數值	非必填
替代文字5	alt5	沒有描述	行	非必填
描述5	caption5	沒有描述	內容	非必填
連結5	link5	沒有描述	頁面名稱	非必填
訊框時間5	thumbtime5	沒有描述	字串	非必填
圖像6	image6	沒有描述 範例 example.jpg	檔案	非必填
寬度6	width6	沒有描述	數值	非必填
替代文字6	alt6	沒有描述	行	非必填
描述6	caption6	沒有描述	內容	非必填
連結6	link6	沒有描述	頁面名稱	非必填
訊框時間6	thumbtime6	沒有描述	字串	非必填
圖像7	image7	沒有描述 範例 example.jpg	檔案	非必填
寬度7	width7	沒有描述	數值	非必填
替代文字7	alt7	沒有描述	行	非必填
描述7	caption7	沒有描述	內容	非必填
連結7	link7	沒有描述	頁面名稱	非必填
訊框時間7	thumbtime7	沒有描述	字串	非必填
圖像8	image8	沒有描述 範例 example.jpg	檔案	非必填
寬度8	width8	沒有描述	數值	非必填
替代文字8	alt8	沒有描述	行	非必填
描述8	caption8	沒有描述	內容	非必填
連結8	link8	沒有描述	頁面名稱	非必填
訊框時間8	thumbtime8	沒有描述	字串	非必填
圖像9	image9	沒有描述 範例 example.jpg	檔案	非必填
寬度9	width9	沒有描述	數值	非必填
替代文字9	alt9	沒有描述	行	非必填
描述9	caption9	沒有描述	內容	非必填
連結9	link9	沒有描述	頁面名稱	非必填
訊框時間9	thumbtime9	沒有描述	字串	非必填
圖像10	image10	沒有描述 範例 example.jpg	檔案	非必填
寬度10	width10	沒有描述	數值	非必填
替代文字10	alt10	沒有描述	行	非必填
描述10	caption10	沒有描述	內容	非必填
連結10	link10	沒有描述	頁面名稱	非必填
訊框時間10	thumbtime10	沒有描述	字串	非必填
圖像間隔	image_gap	設定相鄰的圖像之間的間隔。整數，單位為像素，沒有「px」字尾。 預設 5 範例 20	數值	非必填
圖像樣式	image_style	覆蓋圖像框的預設樣式。	字串	非必填
頂部	header	整個框上方的頂部文字。	內容	非必填
頂部背景	header_background	定義頂部文字的背景顏色。改變背景可能會影響無障礙訪問，請儘可能避免。 範例 #EEFFGG或red	字串	非必填
頂部對齊	header_align	沒有描述 預設 center 範例 left/right/center	字串	非必填
底部	footer	整個框範圍的描述文字，不同於獨立的圖像。如有可能，避免left和right，因為行動裝置可能會像圖像垂直顯示。	內容	非必填
底部背景	footer_background	定義底部文字的背景顏色。改變背景可能會影響無障礙訪問，請儘可能避免。 範例 #EEFFGG或red	字串	非必填
底部對齊	footer_align	沒有描述 建議值 left center right 預設 left 範例 left/right/center	字串	非必填
顯示或隱藏框	border	使用值「infobox」以在資訊框內使用時將邊框隱藏。 建議值 infobox	不明	非必填

參見

• {{Gallery}}
• {{Image array}}
• {{Image frame}}
• {{Photomontage}}