模板:Multiple image

模板文件[檢視] [編輯] [歷史] [清除快取]

「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}}

上述文件嵌入自Template:Multiple image/doc。 (編輯 | 歷史)
編者可以在本模板的沙盒 (編輯 | 差異)和測試樣例 (編輯)頁面進行實驗。
請在/doc子頁面中添加分類。 本模板的子頁面。