Template:Infobox/new/doc
模板页面
更多语言
更多操作
< Template:Infobox | new
此模板使用Lua語言：
条目里通常不需要直接调用这个模板
- 一般情况下，请使用下方与条目类型对应的封装模板。封装模板已预置好该类型的常用字段和中文参数名，空值字段与空横栏会自动隐藏。
- 直接调用原模板只在封装模板没有覆盖你的需求时使用，例如创建新的封装模板，或需要完全自定义字段。
封装模板
| 模板 | 适用条目 | 对应分类 |
|---|---|---|
| {{虚拟歌手信息栏}} | 虚拟歌手、声库 | 按音声合成软件分类的角色 |
| {{音声合成软件信息栏}} | 音声合成软件、编辑器、引擎 | 音声合成软件 |
| {{Album Infobox}} | 音乐专辑、单曲、同人专辑 | 音乐专辑 |
| {{出版物信息栏}} | 书籍、杂志、期刊、同人志 | 出版物 |
| {{组织信息栏}} | 公司、团体、同人社团、平台 | 组织 |
| 榜单相关 | ||
| 模板 | 适用榜单 | |
| {{VOCALOID Ranking}} | 周刊VOCALOID排行榜 | |
| {{UTAU Ranking}} | 周刊UTAU排行榜 | |
| {{VOCALOID & UTAU Ranking}} | 周刊VOCALOID & UTAU排行榜 | |
| {{VOCAL Character & UTAU Ranking}} | 周刊VOCAL Character & UTAU排行榜 | |
| {{月刊VOCALOID TOP30 Infobox}} | 月刊VOCALOID TOP30 | |
| {{周刊虚拟歌手外语排行榜}} | 虚拟歌手外语排行榜 | |
| {{Billboard}} | NICONICO VOCALOID SONGS TOP20 | |
| 完整列表见Category:信息模板。找不到合适的封装模板时，可以参照已有模板自行创建，或直接调用下方原模板。 | ||
说明
Infobox/new是新一代信息栏模板，基于Lua模块构建，旨在替代现有的Template:信息栏和Template:Infobox。
相比旧版，Infobox/new 的主要改进有：
- 无需手动
order，按书写顺序自动排列； - 横栏支持点击折叠/展开；
- 样式使用Codex变量，自动适配不同皮肤与明暗主题；
- 移动端自动全宽，桌面端侧浮；
- 空横栏自动隐藏。
从旧版信息栏迁移只需改名，参数完全兼容。
| 与旧版模板对比 | |||
|---|---|---|---|
| Infobox/new | Template:信息栏 | Template:Infobox | |
| 书写方式 | |字段名 = 值顺序即渲染顺序 |
|字段名 = 值顺序即渲染顺序 |
|Row 1 title = 标签|Row 1 info = 值需手动编号 |
| 自动排序 | ✅ 支持 按书写顺序自动排列 | ✅ 支持 按书写顺序自动排列 | ❌ 不支持 通过编号控制顺序 |
| 样式方式 | ✅ CSS 类名 + TemplateStyles 统一管理，皮肤适配 |
⚠ 内联 style 参数m-style、t-style、l-style……多达 20+ 个
|
⚠ 内联 style 参数Row 1 titlestyle、Row 1 infostyle……
|
| 颜色自定义 | ✅ 6 个语义化参数title-bg、header-bg、label-bg 等
|
⚠ 10+ 个分散参数top-bcolor、t-bcolor、l-bcolor……
|
⚠ 全局色 + 逐行色bg-color、left-column-color……
|
| 横栏写法 | |-横栏名 = 显示文本
|
|-横栏名 = 显示文本
|
|Row x1 = 显示文本
|
| 折叠功能 | ✅ 内置 横栏可点击折叠/展开 | ❌ 不支持 | ❌ 不支持 |
| 响应式 | ✅ 内置 移动端全宽 / 桌面端侧浮 | ❌ 需手动配置 | ❌ 需手动配置 |
| 实现 | Lua模块+TemplateStyles 代码简洁，易维护 |
纯wikitext嵌套模板 代码臃肿，难以维护 |
Lua模块+wikitext+全站样式表 |
迁移成本
原本使用 Template:信息栏 的条目，只需把模板名改成 Infobox/new 即可，参数无需修改（- 横栏与 _ 自由行语法完全兼容）。
原本使用 Template:Infobox 的条目，则需把 Row N title/Row N info 改写为 |字段 = 值 的形式。
用法
{{Infobox/new
|title = 信息栏标题
|image = 示例图片.png
|tabs = {{tabs|...}} （与 image 二选一）
|caption = 图片说明
|float = right （默认 right，可选 left/none）
|class = 额外CSS类名
|size = 300px （图片宽度，默认 300px）
|data-align = center （数据列对齐，可选 left/center/right）
<!-- 折叠控制（可选） -->
|collapsible = no （设为 no 禁用全部折叠）
|collapsed = 1,3 （默认折叠第 1、3 个横栏）
<!-- 颜色自定义（可选） -->
|title-bg = #36c 标题背景色
|title-color = #fff 标题文字色
|header-bg = #eaecf0 横栏背景色
|header-color = #202122 横栏文字色
|label-bg = #f8f9fa 标签背景色
|label-color = #202122 标签文字色
<!-- 横栏（分段标题） -->
|-横栏名 = 显示的横栏文本
<!-- 自由行（全宽单元格） -->
|_行名 = 自由文本内容
<!-- 普通数据行：按需书写，顺序即渲染顺序 -->
|字段1 = 值1
|字段2 = 值2
}}
参数
控制参数
| 参数名 | 别名 | 说明 | 默认值 |
|---|---|---|---|
title |
标题 | 信息栏顶部标题 | |
image |
图片 | 图片文件名（不含File:） |
|
tabs |
— | 标签页内容（如 image 二选一，同时存在时 tabs 优先 |
|
size |
图片大小 | 图片宽度 | 300px
|
caption |
图片说明、图片信息 | 图片下方说明文字 | |
data-align |
数据对齐 | 数据列文字对齐：left / center / right |
左对齐 |
collapsible |
— | 设为 no 禁用横栏折叠，默认开启 |
|
collapsed |
— | 默认折叠的横栏编号，如 1,3 |
|
float |
— | 浮动方向：right / left / none |
right
|
class |
— | 额外 CSS 类名 | |
order |
— | （可选）手动指定字段顺序，不填则按书写顺序自动排列 | |
title-bg |
标题背景色 | 标题栏背景色 | 皮肤主题色 |
title-color |
标题文字色 | 标题栏文字色 | 白色 |
header-bg |
横栏背景色 | 分段横栏背景色 | 浅灰 |
header-color |
横栏文字色 | 分段横栏文字色 | 黑色 |
label-bg |
标签背景色 | 标签列背景色 | 浅灰 |
label-color |
标签文字色 | 标签列文字色 | 黑色 |
数据行
- 普通行
- 直接书写
|字段名 = 值，渲染为“标签 + 数据”的键值对。
- 横栏（分段标题）
- 以
-开头，如|-角色信息 = 角色信息，渲染为跨两列的居中粗体标题行。 - 默认可点击折叠／展开其后的数据行，右侧显示折叠图标，可通过
collapsible=no禁用。 - 横栏文本默认为去除
-前缀的字段名，也可通过赋值自定义显示文本。 - 若横栏之后没有可见数据行，该横栏会自动隐藏。
- 自由行
- 以
_开头，如|_说明 = 这是说明文字，渲染为跨两列的自由文本行。
示例
渲染效果
以下为一个虚拟歌手信息栏的实际渲染效果：
| 雨衣 | |
|---|---|
 | |
| VoiSona立绘 |
| 角色信息 |
|---|
| 本名 | |
| 译名 | 雨衣 |
| 别名 | Ui、Uiroid |
| 性别 | 女 |
| 年龄 | 14岁 |
| 身高 | 149cm |
| 生日 | 5月30日 |
| 代表色 | #25489C |
| 代表物 | 雨伞 |
| 声库信息 |
|---|
| 引擎 | VoiSona、VoiSona Talk |
| 语言 | 日语 |
| 声源 | 时雨羽衣 |
| 开发 | Techno-Speech |
| 发行 | INCOLORE |
| 首次发售 | 2025年5月30日 |
| 付费 | 是 |
基础用法
{{Infobox/new
|标题 = 初音未来
|图片 = Hatsune_miku_v4x.png
|图片信息 = 初音未来 V4X
|开发商 = Crypton Future Media
|首发 = 2007年8月31日
|语言 = 日语
}}
带横栏
{{Infobox/new
|标题 = 示例角色
|图片 = Example.png
|-横栏1 = 角色信息
|本名 = 示例
|年龄 = 16岁
|-横栏2 = 声库信息
|引擎 = VOCALOID4
|语言 = 日语
}}
自定义颜色
{{Infobox/new
|标题 = 自定义样式
|标题背景色 = #e91e63
|标题文字色 = #fff
|横栏背景色 = #fce4ec
|标签背景色 = #f8bbd0
|类型 = 示例
|发行日期 = 2024年
}}
手动指定顺序
当自动顺序不满足需求时，可用 order 手动控制，字段名以逗号分隔，- 开头的表示横栏：
{{Infobox/new
|order = 发行日期, -制作团队, 作曲, 作词
|发行日期 = 2024-01-01
|作曲 = 某某
|作词 = 某某
|-制作团队 = 制作团队
}}
参见
- Module:Infobox/new —— 底层 Lua 模块
- Template:信息栏 —— 旧版通用信息栏（已逐步弃用）
- Template:Infobox —— 更早的信息栏模板
- Category:信息模板 —— 全部信息栏模板