跳转到内容

Template:Navbox/doc

勤求古训，博采众方

本模板可快速建立一个导航模板，配备了默认样式，能应付大多数导航模板。本模板也支持 {{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 同时使用）
  • groupn – 左侧的文字，在 list-n 之前
  • listn – 列出维基链接的文字（最多支持 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 之间的全宽度单元格。
groupn
（group1～group35）显示在 listn 左侧的抬头单元格。如果省略，listn 占用表格全部宽度。
listn
（list1～list35）模板的主体，每个导航框至少需要一个 list 参数。条目建议用 * 星号分行列出。
image
标题下方、主体右侧的图片。需同时指定 list1。
imageleft
标题下方、主体左侧的图片。需同时指定 list1。
below
主体下方的全宽度单元格。
titlegroup
【本站特有】在标题行左侧显示一个分组标签。需配合 titlegroupstyle 和 titlegroupclass 使用。

样式参数

bodystyle
应用到模板主体的 CSS 样式。
basestyle
同时应用到 title、above、below 和 group 单元格（不应用到 list）。
titlestyle
应用到 title 的 CSS 样式。
groupstyle
应用到所有 groupN 单元格的样式。
groupnstyle
应用到特定 group 的样式。
groupwidth
group 单元格的统一宽度。
liststyle
应用到所有 list 的样式。oddstyle/evenstyle 优先于此参数。
listnstyle
应用到特定 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 类。
listnclass
每个 list 独立的 CSS 类（如 list1class、list2class 等）。
groupnstyle
每个 group 独立的 CSS 样式（如 group1style、group2style 等）。
listnstyle
每个 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
未知可选
分组1group1

显示在list1左侧的标签

未知推荐
列表1list1

导航框的主体内容，至少需要一个list参数

未知必需
分组2group2

无描述

未知可选
列表2list2

无描述

未知可选
分组3group3

无描述

未知可选
列表3list3

无描述

未知可选
分组4group4

无描述

未知可选
列表4list4

无描述

未知可选
分组5group5

无描述

未知可选
列表5list5

无描述

未知可选
上方内容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 禁用水平列表追踪

未知可选

追蹤分類

参见


检索自“https://test.zybkcn.com/w/index.php?title=Template:Navbox/doc&oldid=817”