Template:Navbox

此模板使用Lua语言：

Navbox

本模板使用以下模板样式：

本模板可快速建立一个导航模板，配备了默认样式，能应付大多数导航模板。本模板也支持 {{Navbox subgroup}}、{{Navbox with collapsible groups}} 和 {{Navbox with columns}}。

用法

请移除置空不用的参数。

{{Navbox
| name       = {{subst:PAGENAME}}
| title      =
| listclass  = hlist
| state      = {{{state<includeonly>|autocollapse</includeonly>}}}

| above      =
| image      =

| group1     =
| list1      =

| group2     =
| list2      =

| group3     =
| list3      =

<!-- ... 最多 35 组 -->

| below      =
}}<noinclude>
{{navbox documentation}}
</noinclude>

参数列表

基本的和最常见的参数如下所示：

name – 模板的名称（"Template:" 后面的部分）
title – 标题栏的文字
listclass – list 单元格的 CSS 类，常设为 hlist（水平列表）或 plainlist（无符号列表）
state – 方框的折叠状态（autocollapse / collapsed / expanded / plain / off）
titlestyle – 标题栏的 CSS 样式
groupstyle – 分组单元格的 CSS 样式
above – 在 group/list 区段之上显示的文字
image – 可选的右侧图片
imageleft – 可选的左侧图片（可与 group 同时使用）
group_n – 左侧的文字，在 list-n 之前
list_n – 列出维基链接的文字（最多支持 35 组）
below – 在 group/list 区段之下显示的文字

参数描述

设置参数

name: 模板的名称，用于"查·论·编"链接正确工作。可以输入 {{subst:PAGENAME}} 作为快捷值。
state [autocollapse, collapsed, expanded, plain, off]: 默认为 autocollapse。如果页面上同时有两个或更多可折叠表格，则自动折叠。; collapsed – 始终折叠；expanded – 始终展开；plain – 展开且隐藏折叠按钮；off – 展开、无折叠按钮、无标题补白。
navbar: 设置为 plain 隐藏"查·论·编"链接但保持标题居中；off 隐藏链接但不加补白。
border [child, subgroup, none]: 设置为 child 或 subgroup 可将此导航框用作无边框的子导航框嵌入到另一个导航框中。

单元格参数

title: 显示在表格顶端一行的标题文字，通常是该模板的主题。
above: 标题栏与第一个 group/list 之间的全宽度单元格。
group_n: （group1～group35）显示在 list_n 左侧的抬头单元格。如果省略，list_n 占用表格全部宽度。
list_n: （list1～list35）模板的主体，每个导航框至少需要一个 list 参数。条目建议用 * 星号分行列出。
image: 标题下方、主体右侧的图片。需同时指定 list1。
imageleft: 标题下方、主体左侧的图片。需同时指定 list1。
below: 主体下方的全宽度单元格。

titlegroup: 【本站特有】在标题行左侧显示一个分组标签。需配合 titlegroupstyle 和 titlegroupclass 使用。

样式参数

bodystyle: 应用到模板主体的 CSS 样式。
basestyle: 同时应用到 title、above、below 和 group 单元格（不应用到 list）。
titlestyle: 应用到 title 的 CSS 样式。
groupstyle: 应用到所有 groupN 单元格的样式。
group_nstyle: 应用到特定 group 的样式。
groupwidth: group 单元格的统一宽度。
liststyle: 应用到所有 list 的样式。oddstyle/evenstyle 优先于此参数。
list_nstyle: 应用到特定 list 的样式。
listpadding: 每个 list 单元格的内边距。默认左右 0.25em。
list1padding: 第一个 list 的专用内边距，优先级高于 listpadding。
oddstyle / evenstyle: 奇／偶数行的样式。默认奇数透明、偶数浅灰。
style: 应用到外容器表格的整体 CSS（与 bodystyle 类似）。
innerstyle: 应用到内部表格的 CSS，仅在需要同时控制内外两层表格样式时使用。
evenodd [swap, even, odd, off]: 控制奇偶行条纹：swap 反转、even/odd 统一颜色、off 禁用。
abovestyle / belowstyle: above / below 单元格的样式。
imagestyle / imageleftstyle: 图片单元格的样式。
titlegroupstyle / titlegroupclass: 【本站特有】titlegroup 单元格的样式和 CSS 类。

nowrapitems: 【enwiki 特性】设为 yes 时，列表项中由 */:/#/; 开头的行将自动套用 <span class="nowrap">。

其他参数

bodyclass / listclass / groupclass / aboveclass / belowclass / titleclass / imageclass / navboxclass: 对应单元格的 CSS 类。
list_nclass: 每个 list 独立的 CSS 类（如 list1class、list2class 等）。
group_nstyle: 每个 group 独立的 CSS 样式（如 group1style、group2style 等）。
list_nstyle: 每个 list 独立的 CSS 样式（如 list1style、list2style 等）。
templatestyles / child templatestyles: 自定义 TemplateStyles 页面，用于覆盖或补充默认样式。
nocat: 设为 true 可禁用追踪分类。
tracking: 设为 no 可禁用水平列表追踪分类。

子导航框

可以在一个导航框中嵌入多个子导航框。将 list 参数的值设为 child 或 subgroup，然后以 子编号_参数名 的形式指定子导航框的参数：

{{Navbox
| name = {{subst:PAGENAME}}
| title = 标题

| group1 = 分组1
| list1  = list1 内容

| group2 = 分组2
| list2  = child
  | 2_group1 = 子分组2.1
  | 2_list1  = 子列表2.1
  | 2_group2 = 子分组2.2
  | 2_list2  = 子列表2.2
}}

也可以使用嵌套模板方式：

{{Navbox
| name = {{subst:PAGENAME}}
| title = 标题
| list1 = {{Navbox|child
   ...子导航框参数...
}}
}}

子导航框也支持 type = with columns 和 type = with collapsible groups 来使用其他布局。

示例

不带图片

{{Navbox
|listclass=hlist
|name  = Navbox 示例
|title = 多媒体超级走廊（马来西亚）

|group1 = 中心
| list1 = 赛柏再也

|group2 = 区域
| list2 = 巴生谷

|group3 = 主要地标
| list3 = 
* 双子塔
* 吉隆坡电讯高塔
* 吉隆坡中央车站
* 布城
* 赛柏再也

|group4 = 基础设施
| list4 = 
* 快速铁路
* 吉隆坡-布城高速公路

|group5 = 首要应用
| list5 = 
* 电子政务
* 大马卡
}}

带图片

{{Navbox
|listclass=hlist
|name  = Navbox 示例
|title = 多媒体超级走廊（马来西亚）
|image = [[File:Flag of Malaysia.svg|80px]]
|list1 = 
* 双子塔
* 吉隆坡电讯高塔
* 吉隆坡中央车站
* 布城
* 赛柏再也
* 吉隆坡国际机场
}}

技术细节

"查·论·编"链接由 Module:Navbar 生成。
分组与列表之间 2px 宽的边框使用列表单元格的左边框（border-left）绘制。如果改变模板背景色，需同步调整边框颜色。
相邻导航框之间仅有 1px 边框。设置 bodystyle 的上下外边距会破坏此特性。
最多支持 35 组 group/list（group1～group35、list1～list35）。
直接调用 {{#invoke:Navbox|navbox}} 可替代 {{Navbox}}，减少模板展开大小。

模板数据

以下是该模板的模板数据，适用于可视化编辑器等工具。

Navbox模板数据

创建一个导航框，用于在页面底部显示相关页面的链接。

模板参数
参数		描述	类型	状态
模板名称	`name`	模板的名称，用于"查·论·编"链接正确工作默认值 {{subst:PAGENAME}}	未知	推荐
标题	`title`	标题栏的文字，通常是导航模板的主题	未知	推荐
折叠状态	`state`	控制导航框的折叠行为推荐值 `autocollapse` `collapsed` `expanded` `plain` `off` 默认值 autocollapse	未知	推荐
列表CSS类	`listclass`	list单元格的CSS类，常设为 hlist 使用水平列表示例值 hlist	未知	可选
分组1	`group1`	显示在list1左侧的标签	未知	推荐
列表1	`list1`	导航框的主体内容，至少需要一个list参数	未知	必需
分组2	`group2`	无描述	未知	可选
列表2	`list2`	无描述	未知	可选
分组3	`group3`	无描述	未知	可选
列表3	`list3`	无描述	未知	可选
分组4	`group4`	无描述	未知	可选
列表4	`list4`	无描述	未知	可选
分组5	`group5`	无描述	未知	可选
列表5	`list5`	无描述	未知	可选
上方内容	`above`	标题栏与第一个group/list之间的全宽度单元格	未知	可选
下方内容	`below`	主体下方的全宽度单元格	未知	可选
右侧图片	`image`	标题下方、主体右侧的图片	文件	可选
左侧图片	`imageleft`	标题下方、主体左侧的图片	文件	可选
标题分组	`titlegroup`	在标题行左侧显示一个分组标签	未知	可选
标题分组CSS类	`titlegroupclass`	无描述	未知	可选
标题分组CSS样式	`titlegroupstyle`	无描述	未知	可选
不换行项目	`nowrapitems`	设为 yes 时列表项自动套用 nowrap 示例值 yes	未知	可选
导航栏状态	`navbar`	控制"查·论·编"链接的显示示例值 plain, off	未知	可选
边框模式	`border`	设为 child 或 subgroup 可嵌入到另一个导航框中示例值 child, subgroup, none	未知	可选
主体样式	`bodystyle`	无描述	未知	可选
基础样式	`basestyle`	无描述	未知	可选
标题样式	`titlestyle`	无描述	未知	可选
分组样式	`groupstyle`	无描述	未知	可选
列表样式	`liststyle`	无描述	未知	可选
分组宽度	`groupwidth`	无描述	未知	可选
列表内边距	`listpadding`	无描述	未知	可选
奇数行样式	`oddstyle`	无描述	未知	可选
偶数行样式	`evenstyle`	无描述	未知	可选
奇偶行控制	`evenodd`	无描述推荐值 `swap` `even` `odd` `off`	未知	可选
上方样式	`abovestyle`	无描述	未知	可选
下方样式	`belowstyle`	无描述	未知	可选
图片样式	`imagestyle`	无描述	未知	可选
左侧图片样式	`imageleftstyle`	无描述	未知	可选
外容器样式	`style`	应用到外容器表格的整体 CSS	未知	可选
内部表格样式	`innerstyle`	应用到内部表格的 CSS	未知	可选
列表1内边距	`list1padding`	第一个 list 的专用内边距，优先级高于 listpadding	未知	可选
主体CSS类	`bodyclass`	无描述	未知	可选
分组CSS类	`groupclass`	无描述	未知	可选
上方CSS类	`aboveclass`	无描述	未知	可选
下方CSS类	`belowclass`	无描述	未知	可选
标题CSS类	`titleclass`	无描述	未知	可选
图片CSS类	`imageclass`	无描述	未知	可选
导航框CSS类	`navboxclass`	无描述	未知	可选
自定义样式页	`templatestyles`	无描述	未知	可选
子导航框样式页	`child templatestyles`	无描述	未知	可选
禁用分类	`nocat`	设为 true 禁用追踪分类	未知	可选
追踪控制	`tracking`	设为 no 禁用水平列表追踪	未知	可选

追蹤分類

参见

{{Navbox with collapsible groups}} – 可折叠分组导航框
{{Navbox with columns}} – 多列导航框
{{Navbox subgroup}} – 子导航框
{{Navboxes}} – 将多个导航框收纳在一起
{{Navboxes top}}

上述文档嵌入自Template:Navbox/doc。
编者可以在本模板的沙盒和测试样例页面进行实验。
请将分类添加至/doc子页面。本模板的子页面。