模板: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 的圖示
}}
加上标题与配色
[编辑]{{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:图像