Template:Gallery/doc

此頁面是Template:Gallery的模板文档。
此頁面可能包含了模板的使用說明、分類和其他内容。

此模板文档被引用於約5,000個頁面。
為了避免造成大規模的影響，所有對此模板文档的編輯應先於沙盒、測試樣例或您的沙盒上測試。实施修改前，建议先在討論頁發起討論。

模板引用數量會自動更新。

此模板使用Lua语言：

Module:Gallery

本模板使用以下模板样式：

模板:Gallery/styles.css（沙盒）

本模板用於建立進階型圖片陣列。如果只是生成普通的圖片陣列，建議使用畫廊。

本模板會將圖片以表格方式由左至右列陣。全域參數|width=和|height=可控制圖片大小。每列顯示的圖片數量會因圖片寬度及螢幕寬度（包括瀏覽器窗口大小等）而不同。

使用方法

{{Gallery
| title        = 
| align        =
| footer       =
| style        =
| state        =
| height       =
| width        =
| perrow       =
| mode         = 
| whitebg      = 
| noborder     =
| captionstyle =
| File:
 | （圖片説明）
 | class1=
 | alt1=
| File:
 | （圖片説明）
 | class2=
 | alt2=
| File:
 | （圖片説明）
 | class3=
 | alt3=
| File:
 | （圖片説明）
 | class4=
 | alt4=
| File:
 | （圖片説明）
 | class5=
 | alt5=
}}

選填參數

適用於整個圖片陣列的的參數

|title=：圖片陣列的標題

|align=：圖片的對齊方式，預設居左，可選居中或居右；填寫|state=時將會被忽略

|footer=：在圖片陣列的右下角顯示的註腳文字

|style=：為整個圖片陣列指定CSS樣式（參見Help:层叠样式表）

|state=：可摺叠圖片陣列的預設狀態，請填寫|state=expanded或|state=collapsed。可摺叠圖片陣列將會占用頁面的全部寬度

|mode=：内嵌畫廊的模式。常見使用|mode=packed或|mode=nolines（參見畫廊）

適用於圖片陣列中所有圖片的參數

|noborder=：取消圖片的邊框，請使用|noborder=yes

|whitebg=：取消圖片的白色背景，請使用|whitebg=no

|height=：設定圖片顯示的高度，預設是180（px）。不需要填寫「px」字樣

|width=：設定圖片顯示的寬度，預設是180（px）。不需要填寫「px」字樣

|perrow=：每排顯示的圖片數量

|captionstyle=：指定圖片説明的CSS樣式（參見Help:层叠样式表）

范例

{{Gallery
|title=Cultural depictions of George Washington
|width=160 | height=170 |noborder=yes
|align=center
|footer=Example 1
|File:Federal Hall NYC 27.JPG 
 |Statue of Washington outside [[Federal Hall National Memorial]] in [[New York City]], overlooking [[Wall Street]]
 |alt1=Statue facing a city building with Greek columns and huge U.S. flag
|File:Mount Rushmore2.jpg 
 |Construction of Washington portrait at [[Mount Rushmore]], c. 1932
 |alt2=Profile of stone face on mountainside, with 3 workers.
|File:2006 Quarter Proof.png 
 |Washington is commemorated on a [[Quarter (United States coin)|quarter]].
 |class3=bg-transparent
 |alt3=Shiny silver coin with profile of Washington bust. 
|File:George Washington Presidential $1 Coin obverse.png 
 |Washington on a [[dollar coin (United States)|dollar coin]]
 |class4=bg-transparent
 |alt4=Gold coin with bust of Washington facing slightly left
}}

Cultural depictions of George Washington

Statue of Washington outside Federal Hall National Memorial in New York City, overlooking Wall Street
Construction of Washington portrait at Mount Rushmore, c. 1932
Washington is commemorated on a quarter.
Washington on a dollar coin

模板数据

以下是该模板的模板数据，适用于可视化编辑器等工具。

Gallery模板数据

将此模板放置在条目或用户页上，即可在该页面上创建带标题的图库。

模板参数
此模板首选参数换行的代码块格式。
参数		描述	类型	状态
标题	`title`	整个图库的标题	字符串	推荐
对齐方式	`align`	图库在页面上的对齐方式；可选值包括：left、right、center 推荐值 `left` `center` `right` 默认值 left 示例值 center	字符串	可选
脚注	`footer`	创建一个页脚，以小字体显示在整个图库的右下角	字符串	可选
CSS样式	`style`	Allows custom Cascading Style Sheets styling to be added to the gallery block. 示例值 border: 1px solid black;	字符串	可选
标题样式	`captionstyle`	This parameter allows an editor to utilize Cascading Style Sheet code for caption	未知	可选
状态	`state`	This parameter allows the editor to determine whether or not the gallery will initially appear as either expanded or collapsed for readers 推荐值 `expanded` `collapsed` 默认值 expanded 示例值 collapsed	字符串	可选
高度	`height`	determines the maximum height for any image within the gallery 默认值 180 示例值 100	数字	可选
宽度	`width`	Analogous to height parameter; sets maximum width for any image in the gallery 默认值 180 示例值 120	数字	可选
模式	`mode`	Sets the mode used by the inner gallery tag, see [[Help:Gallery tag]] for more options 推荐值 `traditional` `nolines` `packed` `packed-overlay` `packed-hover` `slideshow` 默认值 traditional	字符串	可选
禁用边框	`noborder`	Cancel the border surrounding the images 默认值 no 示例值 yes	字符串	可选
禁用白色背景	`whitebg`	Used to disable the white background in the inner gallery tag 默认值 yes 示例值 no	布尔	可选

追蹤分類

參見

Help:Gallery
{{Cleanup gallery}}，以標記非百科圖像的圖片陣列
{{Image array}}
{{Multiple image}}
{{Photomontage}}
{{Image frame}}
{{Gallery items}}，將圖庫樣式佈局應用於任意內容區段（如模板輸出）
{{Stack}}，圖像等可以在右側堆疊，避免間距和浮動問題