跳至內容

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

加上標題與配色

[編輯]
{{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 會直接忽略這個無效的圖庫參數,不影響一般圖片的顯示。

重新導向

[編輯]

模板編輯說明

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

模板資料

[編輯]
以下是該模板的模板資料,適用於視覺化編輯器等工具。

Scroll gallery模板資料

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

模板參數

此模板以參數區塊格式為優先。

參數描述類型狀態
圖片11

第 1 張圖片的檔案名稱

範例
Example.jpg
檔案必填
圖說12

第 1 張圖片的說明文字

內容建議
圖片23

第 2 張圖片的檔案名稱

檔案建議
圖說24

第 2 張圖片的說明文字

內容建議
圖片35

第 3 張圖片的檔案名稱

檔案非必填
圖說36

第 3 張圖片的說明文字

內容非必填
圖片47

第 4 張圖片的檔案名稱

檔案非必填
圖說48

第 4 張圖片的說明文字

內容非必填
圖片59

第 5 張圖片的檔案名稱

檔案非必填
圖說510

第 5 張圖片的說明文字

內容非必填
圖片611

第 6 張圖片的檔案名稱

檔案非必填
圖說612

第 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
字串非必填
影片時間點1time1

第 1 個檔案為影片時,用來擷取預覽畫格的時間點,可寫秒數或 mm:ss

範例
30
字串非必填
影片時間點2time2

第 2 個檔案為影片時,用來擷取預覽畫格的時間點

字串非必填
影片時間點3time3

第 3 個檔案為影片時,用來擷取預覽畫格的時間點

字串非必填
影片時間點4time4

第 4 個檔案為影片時,用來擷取預覽畫格的時間點

字串非必填
影片時間點5time5

第 5 個檔案為影片時,用來擷取預覽畫格的時間點

字串非必填
影片時間點6time6

第 6 個檔案為影片時,用來擷取預覽畫格的時間點

字串非必填

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

參見

[編輯]