Bản mẫu:Nhiều hình

Tài liệu bản mẫu[xem] [sửa] [lịch sử] [làm mới]

Bản mẫu này sử dụng Lua:

Mô đun:Multiple image (chỗ thử)

Bản mẫu này sử dụng TemplateStyles:

Bản mẫu:Multiple image/styles.css

Viết tắt

{{MI}}

This template creates a box with two to ten images arranged vertically or horizontally with captions for the entire box or for each image.

With the appropriate choice of parameters, the template can automatically resize images to a given total width with each image having the same height.

Be aware that this template does not respect users' default image size preferences. (Wikipedia:Image use policy states: "Except with very good reason, do not use px"... "which forces a fixed image width. In most cases upright=scaling factor should be used, thereby respecting the user's base preference (which may have been selected for that user's particular devices).")

If image size parameters are omitted, this template sets all images at 200px wide, regardless of whether the reader has set a preference for some other default image width. This causes multiple images to look out of scale to the other images in an article.

Cú pháp và các thông số

Không có tự động thay đổi kích thước của tất cả các hình ảnh để cùng một chiều cao

{{nhiều hình
<!-- Layout parameters -->
 | align             = <!-- right (default), left, center, none --> 
 | direction         = <!-- horizontal (default), vertical -->
 | background color  = <!-- box background -->
 | width             = <!-- displayed width of each image in pixels (an integer, omit "px" suffix); overrides "width[n]"s below -->
 | caption_align     = <!-- left (default), center, right --> 

<!-- Header -->
 | header_background = 
 | header_align      = <!-- center (default), left, right -->
 | header            = 

<!--image 1-->
 | image1            = <!-- filename only, i.e. without "Tập tin:" or "Hình:" prefix -->
 | width1            = <!-- displayed width of image; overridden by "width" above -->
 | alt1              = 
 | link1             = 
 | caption1          = 
<!--image 2-->
 | image2            = <!-- filename only, i.e. without "Tập tin:" or "Hình:" prefix -->
 | width2            = <!-- displayed width of image; overridden by "width" above -->
 | alt2              = 
 | link2             = 
 | caption2          = 
<!-- and so on, to a maximum of 10 images (image10) -->

<!-- Footer -->
 | footer_background = 
 | footer_align      = <!-- left (default), center, right -->
 | footer            = 
}}

Tự động thay đổi kích thước của tất cả các hình ảnh để cùng một chiều cao và tổng chiều rộng cho

{{nhiều hình
<!-- Layout -->
 | align             = <!-- right (default), left, center, none --> 
 | direction         = <!-- horizontal (default), vertical -->
 | background color  = <!-- box background -->
 | total_width       = <!-- total width of all the displayed images in pixels (an integer, omit "px" suffix) -->
 | caption_align     = <!-- left (default), center, right --> 

<!-- Header -->
 | header_background = 
 | header_align      = <!-- center (default), left, right -->
 | header            = 

<!--image 1-->
 | image1            = <!-- filename only, i.e. without "Tập tin:" or "Hình:" prefix -->
 | width1            = <!-- full width of the ORIGINAL UNSCALED image -->
 | height1           = <!-- full height of the ORIGINAL UNSCALED image -->
 | alt1              = 
 | link1             = 
 | caption1          = 
<!--image 2-->
 | image2            = <!-- filename only, i.e. without "Tập tin:" or "Hình:" prefix -->
 | width2            = <!-- full width of the ORIGINAL UNSCALED image -->
 | height2           = <!-- full height of the ORIGINAL UNSCALED image -->
 | alt2              = 
 | link2             = 
 | caption2          = 
<!-- and so on, to a maximum of 10 images (image10) -->

<!-- Footer -->
 | footer_background = 
 | footer_align      = <!-- left (default), center, right -->
 | footer            = 
}}

Tham số	Miêu tả
align	right (default), left, center
direction	horizontal (default), vertical
background color	To set the background color of the box in which the images appear.
header_background
header_align	center (default), left, right
header
width	Use to set the same width for each image (i.e. overrides any width[n] below). Do not include if different image widths intended, including if images are to be resized to a fixed total width.
total_width	Use to scale the images to the same height and this total width. Do not use both total_width and width.
image[n]	(where [n] = 1 to 10) Filename of [n]th image.
width[n]	(as above) Two meanings: (1) The width (in pixels, integer, omit "px") of [n]th image. Overridden by width (if set). (2) The full width of the original [n]th image if total_width is given in order to resize all images to the same height and a given total width.
height[n]	(as above) The full height of the original [n]th image if total_width is given in order to resize all images to the same height and a given total width. Ignored otherwise.
alt[n]	(as above) Alt description for [n]th image.
link[n]	(as above) To specify the page to which the [n]th image is linked (i.e. the page that is loaded when the image is clicked). If set as empty (e.g. ...\|alt1=... \|link1= \|caption1=...), linking is disabled (even to the standard Wikipedia image description page); consider WP:ALT. Note: This parameter must not be used with images that have been given free licenses (such as the GDFL or a free CC license) as these licenses require images to be linked to a declaration of the license under which they are being used.
caption[n]	(as above) Caption for the [n]th image.
caption_align	left (default), center, right
footer_background
footer_align	left (default), center, right
footer	Caption that spans the entire box, as opposed to individual images.

Các ví dụ

Các cầu thủ chơi được khuyến cáo với một thẻ vàng và bị đuổi khỏi sân với một thẻ đỏ.

{{nhiều hình
 | width = 60
 | image1 = Yellow card.svg
 | alt1 = Hình ô van màu vàng
 | image2 = Red card.svg
 | alt2 = Hình ô van màu đỏ
 | footer = Các cầu thủ đang chơi bị cảnh cáo với một thẻ vàng và bị đuổi khỏi sân với một thẻ đỏ.
}}

Trưng bày trong suốt PNG

Một hình ảnh PNG với một lớp 8-bit trong suốt...

...Ở đây bao phủ một nền màu trong suốt.

{{nhiều hình
 | align = left
 | direction = vertical
 | width = 200
 | header = Trưng bày trong suốt [[Mạng di động đồ họa|PNG]]
 | image1 = PNG transparency demonstration 1.png
 | alt1 = Xúc xắc màu với nền màu trắng
 | caption1 = Một hình ảnh PNG với một lớp 8-bit trong suốt...
 | image2 = PNG transparency demonstration 2.png
 | alt2 = Xúc xắc màu với nền màu trong suốt
 | caption2 = ...Ở đây bao phủ một nền màu trong suốt.
}}

Khi một thành viên có rất nhiều loại của barnstar, họ có thể đại diện cho họ với ruy băng và các chữ số để cho biết số đếm.

{{nhiều hình
 | width = 60
 | image1=Ribbon numeral 2.png | alt1=2
 | image2=Ribbon numeral 3.png | alt2=3
 | image3=Ribbon numeral 4.png | alt3=4
 | footer = Khi một thành viên có rất nhiều loại của [[WP:BARN|barnstar]], họ có thể đại diện cho họ với [[WP:RIBBON|ruy băng]] và các chữ số để cho biết số đếm.
}}

Với màu nền (background color)

Adoxa (Adoxa moschatellina)

{{nhiều hình
 | background color = #BBDD99
 | width = 160
 | image1 = Adoxa_moschatellina_210406.jpg
 | alt1 = Thảo mộc màu xanh lá cây với một vài bông hoa nhỏ xíu, màu vàng-trắng
 | image2 = Adoxa_moschatellina_210406a.jpg
 | alt2 = Ba hoa nhỏ màu trắng và màu vàng trước khi nền màu xanh lá cây
 | image3 = adoxa_moschatellina_blatt.jpeg
 | alt3 = Lá của một trồng cây, trong mỗi nhóm ba với ba thùy
 | footer_background = #BBDD99
 | footer_align = center
 | footer = [[Adoxa]] (''Adoxa moschatellina'')
}}

Với các liên kết (link[n])

Một con la
(骡子 luózi)

Một con lừa
(驴子 lǘzi)

Một con cá
(鱼 yú)

Hình ảnh con la liên kết đến Con la; hình ảnh con lừa không liên kết bất cứ nơi nào; hình ảnh cá hồi liên kết đến một trang miêu tả hình ảnh chuẩn.

{{nhiều hình
 | align = left

 | image1 = Frecklesmule.jpg
 | width1 = 143
 | alt1 = Một con la
 | link1 = Con la
 | caption1 = Một con la<br />(骡子 ''luózi'')

 | image2 = Donkey 1 arp 750px.jpg
 | width2 = 150
 | alt2 = Một con lừa
 | link2 = 
 | caption2  = Một con lừa<br />(驴子 ''lǘzi'')</center>

 | image3 = Rainbow_trout.png
 | width3 = 91
 | alt3 = Một con cá hồi
 | caption3  = Một con cá<br />({{lang|zh|2=鱼}} ''yú'')</center>

 | footer = Hình ảnh con la liên kết đến [[Con la]]; hình ảnh con lừa không liên kết bất cứ nơi nào; hình ảnh cá hồi liên kết đến một [[Trang miêu tả hình ảnh|trang miêu tả hình ảnh chuẩn]].
}}

Sử dụng direction

Theo mặc định, các hình ảnh được bản mẫu sắp xếp theo chiều ngang, thành hàng (xem bên trái; tương đương với thiết lập |direction=horizontal). Để trình bày chúng theo chiều dọc, nghĩa là thành cột, thiết lập |direction=vertical (xem bên phải).

(horizontal)

(vertical)

Để phù hợp với chiều cao hình ảnh

Decide on a total width for all the images, say 320px
Examine the individual image pages to obtain the full resolution. For example:
- Tập tin:Donkey 1 arp 750px.jpg shows "Donkey_1_arp_750px.jpg (750 × 536 pixels, file size: 125 KB, MIME type: image/jpeg)"
- Tập tin:Rainbow trout.png shows "Rainbow_trout.png (300 × 300 pixels, file size: 158 KB, MIME type: image/png)"
Specify the full width and height for each image, of the form:
- |width1= |height1= |width2= |height2=
Set the total width using |total_width=

Hình ảnh hình chữ nhật của một con lừa, ban đầu được 536 điểm ảnh chiều cao.

Hình ảnh hình vuông của một con cá hồi, ban đầu được 300 điểm ảnh chiều cao.

Cả hai hình ảnh đã được trả lại với cùng một chiều cao, và một tổng chiều rộng 320px

{{nhiều hình
 | align = right
 | total_width = 320

 | image1 = Donkey 1 arp 750px.jpg
 | width1 = 750 | height1 = 536
 | alt1 = Một con lừa
 | caption1 = Hình ảnh hình chữ nhật của một con lừa, ban đầu được 536 điểm ảnh chiều cao.

 | image2 = Rainbow_trout.png
 | width2 = 300 | height2 = 300
 | alt2 = Một con cá hồi
 | caption2 = Hình ảnh hình vuông của một con cá hồi, ban đầu được 300 điểm ảnh chiều cao.

 | footer = Cả hai hình ảnh đã được trả lại với cùng một chiều cao, và một tổng chiều rộng 320px
}}

Nhiều hàng

To create an array of images, with multiple rows, use |perrow=. The value passed to |perrow= may be a single number, or a list of numbers delimited by /. This feature may also be combined with |total_width= for multiple rows of images with the same total width.

Thiết bị khảo sát. Chiều kim đồng hồ từ phía trên bên trái: máy kinh vĩ quang, tổng số trạm robotic, mức độ quang học, trạm RTK căn cứ GPS.

{{nhiều hình|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 = Thiết bị khảo sát. Chiều kim đồng hồ từ phía trên bên trái: máy kinh vĩ quang, tổng số trạm robotic, mức độ quang học, trạm [[Thời gian thực động học|RTK]] căn cứ GPS.
}}

Dữ liệu bản mẫu

Đây là tài liệu Dữ liệu bản mẫu cho bản mẫu này được sử dụng bởi Trình soạn thảo trực quan và các công cụ khác; xem báo cáo sử dụng tham số hàng tháng cho bản mẫu này.

Dữ liệu bản mẫu cho Nhiều hình

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.

Tham số		Miêu tả	Kiểu	Trạng thái
Alignment	`align`	Sets text-wrapping around image box, where "none" places the box on the left edge with no text-wrapping, "center" places the box at center with no text-wrapping and "left" and "right" refer to position of box on screen with text-wrapping. Mặc định right Ví dụ left/right/center/none	Chuỗi dài	khuyên dùng
Direction	`direction`	Direction in which to tile the images. Mặc định horizontal Ví dụ horizontal/vertical	Chuỗi dài	khuyên dùng
Width	`width`	Width overrides Width 1, Width 2, Width 3, etc. If you want the images to be different sizes, do not provide the width parameter. Integer width in pixels; no "px" suffix Ví dụ 200	Chuỗi dài	khuyên dùng
Background color	`background color`	Defines the background color between the border of the box and the images.	Chuỗi dài	tùy chọn
Caption alignment	`caption_align`	Mặc định left Ví dụ left/right/center	Chuỗi dài	tùy chọn
Header background	`header_background`		Chuỗi dài	tùy chọn
Header alignment	`header_align`	Mặc định center Ví dụ left/right/center	Chuỗi dài	tùy chọn
Header	`header`		Chuỗi dài	tùy chọn
Image 1	`image1`	Image 1 is name of first image. Similarly for Image 2, etc. File name only; no "File:" or "Image:" prefix. Ví dụ example.jpg	Chuỗi dài	khuyên dùng
Width 1	`width1`	width 1 is width of first image. Similarly for Width 2, etc.	Số	tùy chọn
Alt text 1	`alt1`	The alt text of first image (see WP:ALT). Similarly for Alt text 2, etc.	Chuỗi dài	tùy chọn
Caption 1	`caption1`	Caption 1 is caption of first image. Similarly for Caption 2, etc.	Chuỗi dài	khuyên dùng
Link 1	`link1`	Where the first page links to. Similarly for Link 2, 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.	Tên trang	tùy chọn
Thumbtime 1	`thumbtime1`	If image1 is an Ogg Theora file, sets the time within the video that is used for the initial display. Either a number of seconds or hours:minutes:seconds. Similarly for Thumb time 2, etc.	Chuỗi dài	tùy chọn
Image 2	`image2`	Ví dụ example.jpg	Chuỗi dài	khuyên dùng
Width 2	`width2`		Số	tùy chọn
Alt text 2	`alt2`		Chuỗi dài	tùy chọn
Caption 2	`caption2`		Chuỗi dài	khuyên dùng
Link 2	`link2`		Tên trang	tùy chọn
Thumbtime 2	`thumbtime2`		Chuỗi dài	tùy chọn
Image 3	`image3`	Ví dụ example.jpg	Chuỗi dài	tùy chọn
Width 3	`width3`		Số	tùy chọn
Alt text 3	`alt3`		Chuỗi dài	tùy chọn
Caption 3	`caption3`		Chuỗi dài	tùy chọn
Link 3	`link3`		Tên trang	tùy chọn
Thumbtime 3	`thumbtime3`		Chuỗi dài	tùy chọn
Footer background	`footer_background`		Chuỗi dài	tùy chọn
Footer alignment	`footer_align`	Mặc định left Ví dụ left/right/center	Chuỗi dài	tùy chọn
Footer	`footer`		Chuỗi dài	tùy chọn

Định dạng: block

Thử nghiệm của đầu ra Dữ liệu bản mẫu raw:

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.

Tham số bản mẫu
Nên dùng bản mẫu này với các tham số đặt thành khối.
Tham số		Miêu tả	Kiểu	Trạng thái
Alignment	`align`	Sets text-wrapping around image box, where "none" places the box on the left edge with no text-wrapping, "center" places the box at center with no text-wrapping and "left" and "right" refer to position of box on screen with text-wrapping. Mặc định right Ví dụ left/right/center/none	Chuỗi dài	khuyên dùng
Direction	`direction`	Direction in which to tile the images. Mặc định horizontal Ví dụ horizontal/vertical	Chuỗi dài	khuyên dùng
Width	`width`	Width overrides Width 1, Width 2, Width 3, etc. If you want the images to be different sizes, do not provide the width parameter. Integer width in pixels; no "px" suffix Ví dụ 200	Chuỗi dài	khuyên dùng
Background color	`background color`	Defines the background color between the border of the box and the images.	Chuỗi dài	tùy chọn
Caption alignment	`caption_align`	không có miêu tả Mặc định left Ví dụ left/right/center	Chuỗi dài	tùy chọn
Header background	`header_background`	không có miêu tả	Chuỗi dài	tùy chọn
Header alignment	`header_align`	không có miêu tả Mặc định center Ví dụ left/right/center	Chuỗi dài	tùy chọn
Header	`header`	không có miêu tả	Chuỗi dài	tùy chọn
Image 1	`image1`	Image 1 is name of first image. Similarly for Image 2, etc. File name only; no "File:" or "Image:" prefix. Ví dụ example.jpg	Chuỗi dài	khuyên dùng
Width 1	`width1`	width 1 is width of first image. Similarly for Width 2, etc.	Số	tùy chọn
Alt text 1	`alt1`	The alt text of first image (see WP:ALT). Similarly for Alt text 2, etc.	Chuỗi dài	tùy chọn
Caption 1	`caption1`	Caption 1 is caption of first image. Similarly for Caption 2, etc.	Chuỗi dài	khuyên dùng
Link 1	`link1`	Where the first page links to. Similarly for Link 2, 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.	Tên trang	tùy chọn
Thumbtime 1	`thumbtime1`	If image1 is an Ogg Theora file, sets the time within the video that is used for the initial display. Either a number of seconds or hours:minutes:seconds. Similarly for Thumb time 2, etc.	Chuỗi dài	tùy chọn
Image 2	`image2`	không có miêu tả Ví dụ example.jpg	Chuỗi dài	khuyên dùng
Width 2	`width2`	không có miêu tả	Số	tùy chọn
Alt text 2	`alt2`	không có miêu tả	Chuỗi dài	tùy chọn
Caption 2	`caption2`	không có miêu tả	Chuỗi dài	khuyên dùng
Link 2	`link2`	không có miêu tả	Tên trang	tùy chọn
Thumbtime 2	`thumbtime2`	không có miêu tả	Chuỗi dài	tùy chọn
Image 3	`image3`	không có miêu tả Ví dụ example.jpg	Chuỗi dài	tùy chọn
Width 3	`width3`	không có miêu tả	Số	tùy chọn
Alt text 3	`alt3`	không có miêu tả	Chuỗi dài	tùy chọn
Caption 3	`caption3`	không có miêu tả	Chuỗi dài	tùy chọn
Link 3	`link3`	không có miêu tả	Tên trang	tùy chọn
Thumbtime 3	`thumbtime3`	không có miêu tả	Chuỗi dài	tùy chọn
Footer background	`footer_background`	không có miêu tả	Chuỗi dài	tùy chọn
Footer alignment	`footer_align`	không có miêu tả Mặc định left Ví dụ left/right/center	Chuỗi dài	tùy chọn
Footer	`footer`	không có miêu tả	Chuỗi dài	tùy chọn

Xem thêm

Tài liệu bên trên được truyền tải từ Bản mẫu:Nhiều hình/doc.
Biên tập viên sửa đổi có thể thử nghiệm trong các trang chỗ thử và trường hợp kiểm thử của bản mẫu này.
Xin hãy bổ sung các thể loại vào trang con /doc. Các trang con của bản mẫu này.