模板:Video

模板介绍

本模板用于在 Wiki 中嵌入视频播放器（支持 Bilibili、YouTube 及原生链接），采用类 B 站 UI 设计，支持自动深色模式适配。

使用方法

Bilibili 版

{{Video
|title   = 视频标题
|bvid    = BV1cafnYUEYe
|p       = 1
|poster  = 封面图片URL（可选）
|width   = 600
|state   = mw-collapsed
}}

YouTube 版

{{Video
|title   = 视频标题
|youtube = P3n5VXqkuo8
|poster  = 封面图片URL（可选）
|width   = 600
|state   = mw-collapsed
}}

参数说明

核心参数 (Bilibili)

参数	说明	备注
title	视频标题文本	将自动包裹跳转至原片的链接。若含方括号，请见下方说明。
bvid	Bilibili 稿件 ID	必填。填入后优先启用 B 站 iframe 播放器。
p	分 P 编号	可选。默认为 1。

核心参数 (YouTube)

参数	说明	备注
title	视频标题文本	将自动包裹跳转至原片的链接。
youtube	YouTube 视频 ID	必填。填入后启用 YouTube 播放器。

通用可选参数

参数	说明	备注
url	视频文件直链	用于播放本地或远程服务器上的 MP4 文件（不推荐）。
poster	封面占位图	重要：若不填此参数，封面区域将保持完全透明。
width	播放器最大宽度	默认值为 600px。
state	初始显示状态	默认为 mw-collapsed（隐藏视频主体）。

特殊问题处理

标题含方括号 []

由于 MediaWiki 外部链接语法的限制，若标题参数中含有方括号（如：[蔚藍檔案]），会导致链接识别提前结束。

• 建议：使用 <nowiki> 包裹方括号。

封面透明逻辑

本模板 CSS 已将 .kr-video-bili-wrapper 的背景设为 transparent。

• 当你不传入 poster 参数时，视频在点击“显示”后、加载完成前，会透出 Wiki 页面背景色。
• 这样做避免了在视频加载前出现突兀的黑块，同时通过 CSS 预留了 16:9 的高度空间，保证了排版高度不塌陷。