Template:SwitchImage/doc：修订间差异

2026年5月3日 (日) 22:57的最新版本

核心功能

此模板专为 Citizen 皮肤优化，用于根据站点的浅色/深色（白天/黑夜）模式自动切换显示的图片。支持块状显示和行内嵌入两种模式。

使用方法

{{SwitchImage
| light = 浅色模式图片.png
| dark  = 深色模式图片.png
| size       = 200px
| alt        = 图片描述
| link       = 链接页面
| inline     = 1
}}

参数说明

参数名	描述	必填	默认值	示例
light	浅色模式下显示的图片文件名（不含 File: 前缀）。	是	-	Logo_light.png
dark	深色模式下显示的图片文件名（不含 File: 前缀）。	是	-	Logo_dark.png
size	图片尺寸。在非行内模式下建议填写。	否	-	250px
alt	图片的替代文本（鼠标悬停或图片加载失败时显示）。	否	-	站点标志
link	点击图片跳转的页面名称或外部链接。	否	-	Main Page
inline	行内模式开关。填入任何值（如 1）后，图片将与文字同高。	否	-	1

示例

1. 普通模式 (块状显示)

用于侧边栏、页眉或作为独立的插图。

{{SwitchImage|light=Ogas_light.png|dark=Ogas_dark.png|size=150px}}

2. 行内模式 (嵌入文本)

用于将图标像 Emoji 一样插入句子中，会自动对齐文字高度。

这里有一个 OGAS 图标 {{SwitchImage|light=Ogas_light.png|dark=Ogas_dark.png|inline=1}} 嵌入在文本中。

@@ 第1行： / 第1行： @@
-|content=
 == 核心功能 ==
 此模板专为 '''Citizen''' 皮肤优化，用于根据站点的浅色/深色（白天/黑夜）模式自动切换显示的图片。支持块状显示和行内嵌入两种模式。
@@ 第6行： / 第5行： @@
 <pre>
 {{SwitchImage
-| light_file = 浅色模式图片.png
+| light = 浅色模式图片.png
-| dark_file  = 深色模式图片.png
+| dark  = 深色模式图片.png
 | size       = 200px
 | alt        = 图片描述
@@ 第19行： / 第18行： @@
 ! 参数名 !! 描述 !! 必填 !! 默认值 !! 示例
 |-
-| '''light_file''' || 浅色模式下显示的图片文件名（不含 File: 前缀）。 || '''是''' || - || Logo_light.png
+| '''light''' || 浅色模式下显示的图片文件名（不含 File: 前缀）。 || '''是''' || - || Logo_light.png
 |-
-| '''dark_file''' || 深色模式下显示的图片文件名（不含 File: 前缀）。 || '''是''' || - || Logo_dark.png
+| '''dark''' || 深色模式下显示的图片文件名（不含 File: 前缀）。 || '''是''' || - || Logo_dark.png
 |-
 | '''size''' || 图片尺寸。在非行内模式下建议填写。 || 否 || - || 250px
@@ 第36行： / 第35行： @@
 用于侧边栏、页眉或作为独立的插图。
 <pre>
-{{SwitchImage|light_file=Ogas_light.png|dark_file=Ogas_dark.png|size=150px}}
+{{SwitchImage|light=Ogas_light.png|dark=Ogas_dark.png|size=150px}}
 </pre>
@@ 第42行： / 第41行： @@
 用于将图标像 Emoji 一样插入句子中，会自动对齐文字高度。
 <pre>
-这里有一个 OGAS 图标 {{SwitchImage|light_file=Ogas_light.png|dark_file=Ogas_dark.png|inline=1}} 嵌入在文本中。
+这里有一个 OGAS 图标 {{SwitchImage|light=Ogas_light.png|dark=Ogas_dark.png|inline=1}} 嵌入在文本中。
 </pre>
-== 注意事项 ==
-* 本模板依赖 [[Template:SwitchImage/style.css]]。
-* 必须在安装了 [[mw:Extension:TemplateStyles|TemplateStyles]] 扩展的 Wiki 上使用。
-* 在 '''Citizen''' 皮肤下，本模板支持“白天”、“黑夜”以及“跟随系统”三种设置的实时切换。
-[[Category:图片模板]]