「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>