模板: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}}