Template:Spoiler/doc：修订间差异

帮助

2025年4月21日 (一) 14:20的最新版本

黑幕，用黑色背景覆盖文本，使用场景包括但不限于整活，遮盖抽象或不可言说 (?) 之内容。

用法[编辑源代码]

{{Spoiler|内容|悬浮标题|type=设置揭开行为}}

1 — 内容，被黑幕遮盖的文本。
2 — 悬浮标题，光标悬浮或触摸屏点击后显示的提示框内容。
type — 类名，设置黑幕的揭开方式。
- uncover — 光标悬浮或触摸屏点击后将黑色背景揭开。
- dark — 黑色背景始终存在，光标悬浮或触摸屏点击后文本变为白色。（默认）

源代码	效果预览
`{{Spoiler\|内容\|type=uncover}}`	内容
`{{Spoiler\|内容\|type=dark}}`	内容
`{{Spoiler\|{{I\|波兰}} [[波兰球]]是一个国家球\|你应该知道这个角色\|type=uncover}}`	波兰球是一个国家球

技术[编辑源代码]

模板设置了两层span元素，分别是“黑幕”和“内容”。实际操作是在“黑幕”上设置一个黑色背景，然后用css属性 opacity 使“内容”透明——因为黑色背景的图层实际低于显示的内容。由于是通过 opacity 在父元素上实现，它不会出现部分内容未被隐藏的问题。

模板数据[编辑源代码]

黑幕，用黑色背景覆盖文本

模板参数
参数		描述	类型	状态
内容	`1`	被黑幕遮盖的内容	内容	可选
悬浮标题	`2`	class属性，光标悬浮或触摸屏点击后显示的提示框内容	内容	可选
类型	`type`	设置黑幕应该如何揭开（uncover、dark）默认值 dark	单行文本	可选

@@ 第5行： / 第5行： @@
 {{Spoiler|内容|悬浮标题|type=设置揭开行为}}
 </syntaxhighlight>
-*<code>1</code> — 内容，被黑色背景覆盖的文本。
+*<code>1</code> — 内容，被黑幕遮盖的文本。
-*<code>2</code> — 悬浮标题，光标悬浮或点击后显示的提示框内容。
+*<code>2</code> — 悬浮标题，光标悬浮或触摸屏点击后显示的提示框内容。
-*<code>type</code> — 类名，设置揭开行为。
+*<code>type</code> — 类名，设置黑幕的揭开方式。
-**<code>uncover</code> — 光标悬浮或点击后将黑色背景揭开。（默认）
+**<code>uncover</code> — 光标悬浮或触摸屏点击后将黑色背景揭开。
-**<code>dark</code> — 黑色背景始终存在，光标悬浮或点击后文本变为白色。
+**<code>dark</code> — 黑色背景始终存在，光标悬浮或触摸屏点击后文本变为白色。（默认）
 {| class="wikitable"
 ! 源代码 !! 效果预览
@@ 第17行： / 第17行： @@
 | <code><nowiki>{{Spoiler|内容|type=dark}}</nowiki></code> || {{Spoiler|内容|type=dark}}
 |-
-| <code><nowiki>{{Spoiler|{{I|波兰}} [[波兰球]]是一个国家球|你应该知道这个角色}}</nowiki></code> || {{Spoiler|{{I|波兰}} [[波兰球]]是一个国家球|你应该知道这个角色}}
+| <code><nowiki>{{Spoiler|{{I|波兰}} [[波兰球]]是一个国家球|你应该知道这个角色|type=uncover}}</nowiki></code> || {{Spoiler|{{I|波兰}} [[波兰球]]是一个国家球|你应该知道这个角色|type=uncover}}
 |}
 ==技术==
 模板设置了两层span元素，分别是“黑幕”和“内容”。实际操作是在“黑幕”上设置一个黑色背景，然后用css属性 <code>opacity</code> 使“内容”透明——因为黑色背景的图层实际低于显示的内容。由于是通过 <code>opacity</code> 在父元素上实现，它不会出现部分内容未被隐藏的问题。
+==模板数据==
+<templatedata>
+{
+	"params": {
+		"1": {
+			"label": "内容",
+			"description": "被黑幕遮盖的内容",
+			"type": "content"
+		},
+		"2": {
+			"label": "悬浮标题",
+			"description": "class属性，光标悬浮或触摸屏点击后显示的提示框内容",
+			"type": "content"
+		},
+		"type": {
+			"label": "类型",
+			"description": "设置黑幕应该如何揭开（uncover、dark）",
+			"type": "line",
+			"default": "dark"
+		}
+	},
+	"description": "黑幕，用黑色背景覆盖文本"
+}
+</templatedata>