Template:Scroll gallery/doc

概要

本模板將數張圖片包成一個可左右切換的投影片式圖庫，外框樣式模仿一般的縮圖框（thumb），預設靠右浮動於正文旁。當同一主題有多張圖片、版面卻不足以並排陳列時適用。

模板實際上是 MediaWiki 內建的 <gallery mode="slideshow"> 的包裝，切換圖片的操作由 JavaScript 提供。一次最多可放入 40 張圖片，並可透過參數調整寬度、外框、底色與標題列。

參數及使用方法

位置參數兩個一組：奇數號為檔案名稱，緊接其後的偶數號為該張圖片的說明文字。

{{Scroll gallery
|檔名1.jpg|圖說一
|檔名2.jpg|圖說二
|檔名3.jpg|圖說三
}}

檔案名稱加不加 File: 前綴皆可，但不可寫成 [[File:……]] 的連結形式。具名參數（width 等）不佔用位置編號，寫在圖片清單之前或之後都可以。

參數一覽

參數	預設值	說明
1、3、5……79	無	各張圖片的檔案名稱，共 40 個位置。
2、4、6……80	無	對應前一個檔名的圖說，可使用內部連結等維基語法。
align	right	圖庫的浮動方向，可填 right 或 left。
width	200	圖片的顯示寬度，單位為像素，寫成 300 或 300px 皆可；外框寬度為此數值加 15 像素。
border	1px solid #BBB	外框的 CSS border 值，填 none 可取消外框。
background	transparent	圖庫的底色。
captiontext	inherit	圖說的文字顏色。
title	無	填寫後會在圖庫上方加上一列粗體標題，留空則不顯示標題列。
titletext	inherit	標題的文字顏色。
titlebackground	transparent	標題列的底色。
time1……time40	無	第 n 個檔案為影片時，指定用來擷取預覽畫格的時間點（即圖庫的 thumbtime），可寫秒數或 mm:ss。純圖片不需填寫。

範例

基本用法

{{Scroll gallery
|Example.jpg|一張示範圖片
|Commons-logo.svg|[[維基共享資源]]標誌
|Wiki letter w.svg|字母 W 的圖示
}}

• 
  一張示範圖片
• 
  維基共享資源標誌
• 
  字母 W 的圖示

加上標題與配色

{{Scroll gallery
|title=示範圖庫
|width=250px
|background=#F8F9FA
|titlebackground=#EAECF0
|Example.jpg|一張示範圖片
|Sunflower from Silesia2.jpg|向日葵
}}

示範圖庫

• 
  一張示範圖片
• 
  向日葵

靠左浮動並取消外框

{{Scroll gallery
|align=left
|border=none
|width=180
|Example.jpg|一張示範圖片
|Wikipedia-logo-v2.svg|維基百科標誌
}}

• 
  一張示範圖片
• 
  維基百科標誌

收錄影片

以 time1 指定第一個檔案的預覽畫格取自第 30 秒。

{{Scroll gallery
|time1=30
|Big Buck Bunny 4K.webm|動畫短片《大雄兔》
|Example.jpg|一張示範圖片
}}

• 動畫短片《大雄兔》
• 
  一張示範圖片

注意事项

• 位置參數必須成對出現。即使某張圖片不寫圖說，也要保留空的參數位（|檔名.jpg||），否則下一個檔名會被當成上一張的圖說，其後的圖片全部錯位。
• 圖說中若含有等號，該組參數會被誤判為具名參數，需改用 {{=}} 或明確寫出參數編號（如 |2=a=b）。
• 本模板只認得上表所列的參數。其他圖庫模板常見的 name、upright、heights、perrow 等寫了不會有任何作用。
• 圖片超過 40 張的部分不會顯示，此時宜改用 {{Gallery}} 或分成兩個圖庫。
• 圖庫為浮動元素，若後續的章節標題或表格被擠壓，可在其後加上 {{clear}}。
• 沒有填寫 time1……time40 時，模板會輸出未展開的參數字串，但 MediaWiki 會直接忽略這個無效的圖庫參數，不影響一般圖片的顯示。

重定向

• {{Scroll Gallery}}

模板编辑说明

• 模板依賴 {{replace}}（用於去除 width 參數中的 px）、{{!}}，以及解析器函數 #expr、#if、#tag。
• 40 組圖片參數是逐行硬寫在原始碼中的，要增減張數必須直接增刪對應的行。
• 外距只設定了 margin-left:1em，因此 align=left 時，圖庫右側與正文之間沒有留白。

模板数据

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

Scroll gallery模板数据

以投影片形式呈現的浮動圖庫，最多可放入 40 張圖片。位置參數兩個一組，奇數為檔名、偶數為圖說。

模板参数

此模板首选参数换行的代码块格式。

参数		描述	类型	状态
圖片1	1	第 1 張圖片的檔案名稱 示例值 Example.jpg	文件	必需
圖說1	2	第 1 張圖片的說明文字	内容	推荐
圖片2	3	第 2 張圖片的檔案名稱	文件	推荐
圖說2	4	第 2 張圖片的說明文字	内容	推荐
圖片3	5	第 3 張圖片的檔案名稱	文件	可选
圖說3	6	第 3 張圖片的說明文字	内容	可选
圖片4	7	第 4 張圖片的檔案名稱	文件	可选
圖說4	8	第 4 張圖片的說明文字	内容	可选
圖片5	9	第 5 張圖片的檔案名稱	文件	可选
圖說5	10	第 5 張圖片的說明文字	内容	可选
圖片6	11	第 6 張圖片的檔案名稱	文件	可选
圖說6	12	第 6 張圖片的說明文字	内容	可选
標題	title	顯示在圖庫上方的粗體標題，留空則不顯示標題列	字符串	可选
對齊	align	圖庫的浮動方向 推荐值 right left 默认值 right	字符串	推荐
寬度	width	圖片的顯示寬度（像素），可寫 300 或 300px 默认值 200 示例值 300px	字符串	可选
外框	border	外框的 CSS border 值，填 none 可取消外框 默认值 1px solid #BBB	字符串	可选
底色	background	圖庫的背景顏色 默认值 transparent 示例值 #F8F9FA	字符串	可选
圖說顏色	captiontext	圖說的文字顏色 默认值 inherit	字符串	可选
標題顏色	titletext	標題的文字顏色 默认值 inherit	字符串	可选
標題底色	titlebackground	標題列的背景顏色 默认值 transparent	字符串	可选
影片時間點1	time1	第 1 個檔案為影片時，用來擷取預覽畫格的時間點，可寫秒數或 mm:ss 示例值 30	字符串	可选
影片時間點2	time2	第 2 個檔案為影片時，用來擷取預覽畫格的時間點	字符串	可选
影片時間點3	time3	第 3 個檔案為影片時，用來擷取預覽畫格的時間點	字符串	可选
影片時間點4	time4	第 4 個檔案為影片時，用來擷取預覽畫格的時間點	字符串	可选
影片時間點5	time5	第 5 個檔案為影片時，用來擷取預覽畫格的時間點	字符串	可选
影片時間點6	time6	第 6 個檔案為影片時，用來擷取預覽畫格的時間點	字符串	可选

上表僅列出前 6 組圖片；第 7 組以後的位置參數（13 至 80）與 time7 至 time40 用法相同，在視覺化編輯器中可用「新增更多資訊」自行加入。

參見

• {{Gallery}}
• {{Multiple image}}
• {{Photomontage}}
• {{Stack}}
• Help:图像