Template:Scroll gallery
概要
[编辑]本模板將數張圖片包成一個可左右切換的投影片式圖庫，外框樣式模仿一般的縮圖框（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時，圖庫右側與正文之間沒有留白。
模板数据
[编辑]以投影片形式呈現的浮動圖庫，最多可放入 40 張圖片。位置參數兩個一組，奇數為檔名、偶數為圖說。
| 参数 | 描述 | 类型 | 状态 | |
|---|---|---|---|---|
| 圖片1 | 1 | 第 1 張圖片的檔案名稱
| 文件 | 必需 |
| 圖說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 | 圖庫的浮動方向
| 字符串 | 推荐 |
| 寬度 | width | 圖片的顯示寬度（像素），可寫 300 或 300px
| 字符串 | 可选 |
| 外框 | border | 外框的 CSS border 值，填 none 可取消外框
| 字符串 | 可选 |
| 底色 | background | 圖庫的背景顏色
| 字符串 | 可选 |
| 圖說顏色 | captiontext | 圖說的文字顏色
| 字符串 | 可选 |
| 標題顏色 | titletext | 標題的文字顏色
| 字符串 | 可选 |
| 標題底色 | titlebackground | 標題列的背景顏色
| 字符串 | 可选 |
| 影片時間點1 | time1 | 第 1 個檔案為影片時，用來擷取預覽畫格的時間點，可寫秒數或 mm:ss
| 字符串 | 可选 |
| 影片時間點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:图像