打开/关闭菜单
打开/关闭外观设置菜单
打开/关闭个人菜单
未登录
未登录用户的IP地址会在进行任意编辑后公开展示。

目前wiki关闭了自行注册账号的功能,如需注册账号,请查阅Help:注册账号

模板:Navbox/doc:修订间差异

来自RIA | Wiki
Aunst留言 | 贡献
删除不必要的模板
Aunst留言 | 贡献
更新文档
第1行: 第1行:
本模板允许通过提供一个或多个链接列表相对快速地创建一个导航模板。它配备了缺省样式, 这些样式应能对付大多数导航模板。不建议改变缺省样式,尽管这是可以的。为了导航模板的标准化, 也为了便于使用, 强烈建议使用这个模板, 或者它的 "Navbox系列" 姊妹模板中的某一个。
Navbox模板是wiki标准的导航模板。在模板中填入链接列表可相对快速地创建导航盒。模板附带了通用的默认样式,也可以更改默认样式。创建导航盒时,强烈推荐使用此模板来创建易于修改、使用的标准导航盒。


== 参数 ==
== 简单导航盒模板 ==
=== 基本参数 ===
下方代码是一个导航盒模板的初始源码,留空的参数应移除。
<pre>
<pre>
{{Navbox
{{Navbox
  | name       = {{subst:PAGENAME}}<!-- Don't change anything on this line. It will change itself when you save. -->
| name = {{subst:PAGENAME}}{{subst:void|不要更改此行。在保存编辑时,它会自动修改}}
  | title     =
| title =
  | listclass  = hlist
| state = {{{state|}}}
  | state     = {{{state|}}}


  | above      =
| listclass = hlist
  | image      =


  | group1    =
| above =
  | list1      =
| image =


  | group2     =
| group1 =
  | list2     =
| list1 =
| group2 =
| list2 =
| group3 =
| list3 =


  | group3    =
<!-- ... -->
  | list3      =


  <!-- ... -->
| below =
}}<noinclude>
{{documentation}}
</noinclude>
</pre>
 
== 常用参数 ==
{{Navbox
  | name = Template:Navbox/doc
  | title = 标题 title
  | state = expanded
 
  | above = 顶栏 above
 
  | group1 = 组1 group1
  | list1 = 列表1 list1
  | group2 = 组2 group2
  | list2 = 列表2 list2
  | group3 = 组3 group3
  | list3 = 列表3 list3
  | group4 = 组4 group4
  | list4 = 列表4 list4


   | below     =
   | below = 底栏 below
}}
}}
</pre>
模板使用小写参数名。“'''name'''”和“'''title'''”参数是必需的,如果没有另外设置参数,就会创建一个单行的盒子。
 
“'''group<var>n</var>'''”(等)和“'''above'''”/“'''below'''”是可选的。
 
常用参数如下(后面有完整的参数列表):
* '''name'''——模板名。
* '''title'''——标题栏的标题。
* '''state'''——控制导航盒折叠状态。
* '''listclass'''——列表单元格的CSS类,一般填“hlist”,以此创建水平列表。
* '''above'''——导航盒顶栏,即链接列表前面一行的文本。(可以放概览链接啥的)
* '''image'''——导航盒右侧的可选图像,使用完整的wikitext图像语法,例如:<code><nowiki>[[File:Example.png|80px|alt=替代文本]]</nowiki></code>
* '''imageleft'''——导航盒左侧的可选图像,用法和image参数相同。
* '''group<var>n</var>'''——链接列表的标题,显示在list-n前的文本。如果不给list-n设置对应的group-n,list-n单元格会扩展到导航盒边缘,并且文本会居中对齐。
* '''list<var>n</var>'''——相关链接列表,使用标准wikitext列表语法。
* '''below'''——导航盒底栏,即链接列表后面一行的文本。(可以放相关链接啥的)
 
== 所有参数 ==
下方列出了Navbox模板的完整参数列表。多数情况下,只有'''name'''、'''title'''和'''list1'''是必需的,子导航盒中,name和title也不是必需的。
 
=== 初始化参数 ===
==== name ====
模板名,用来设置“查论编”链接所对应的页面。可以使用<code><nowiki>{{subst:PAGENAME}}</nowiki></code>作为参数值。只有在设置了title参数,未设置border参数,未使用navbar参数禁用此链接时,此参数才有作用。
 
==== state ====
设置导航盒折叠状态。可用的值有'''autocollapse'''、'''collapsed'''、'''expanded'''、'''plain'''、'''off'''。
 
默认值为'''autocollapse'''。如果页面内有多于1个可折叠元素,那么导航盒默认折叠。否则默认展开。
 
如果设置为'''collapsed''',导航盒默认折叠。
 
如果设置为'''expanded''',导航盒默认展开。
 
如果设置为'''plain''',导航盒默认展开,标题栏右侧不会有“[隐藏]”链接。
 
如果设置为'''off''',导航盒默认展开,标题栏右侧不会有“[隐藏]”链接。不同于plain,此时不会给标题添加保持标题居中的边距。这是高级用法。一般情况下,如果不想显示“[隐藏]”链接,用plain就可以了。


=== 基本参数列表 ===
如果要在模板页保持展开(用于展示),但在使用导航盒时让它自动调整折叠状态,可将expanded包含在{{tag|noinclude}}标签中:
Navbox使用小写的参数名称, 如上面框中所示。如果省略其他参数, 必需的name和title会创建一个单行方框。


请注意 "group1" (等等) 是可选的,命名为 "above/below" 的部分也是可选的。
<pre>| state = <noinclude>expanded</noinclude></pre>


基本的和最常见的参数如下所示 (参见下方查看完整的列表) :
很多时候编者希望设置默认折叠状态,使用模板时又可以覆写默认状态。可以将state参数传递给用户,并设置默认值:
: {{Para|name}} – 模板的名称
: {{Para|title}} – 标题栏显示的文字, 例如: <code><nowiki>[[Widget stuff]]</nowiki></code>.
: {{Para|listclass}} – list 栏的 CSS class, 通常是 hlist for horizontal lists. Alternatively, 使用 {{Para|bodyclass}} for the whole box.
: {{Para|state}} – 控制 Navbar 一开始是折叠的还是展开的.
: {{Para|titlestyle}} – 标题栏的 CSS 样式, 例如: background: gray;
: {{Para|groupstyle}} – 分组单元格的 CSS 样式, 例如: background: #eee;
: {{Para|above}} – 在group/list区块之上显示的文字 (可能是一栏综合的维基链接) .
: {{Para|image}} – 一个可选的右侧图像, coded as the whole image. 以完整的 image 语法编码, 如: <code><nowiki>[[File:XX.jpg|80px|link=|alt=]]</nowiki></code>.
: {{Para|imageleft}} – 一个可选的右侧图像 (与 image 参数的编码格式相同).
: {{Para|group<sub>n</sub>}} – 左侧的文字, 在 list-n 之前 (如果 group-n 被省略, list-n 将开始于方框的左侧) .
: {{Para|list<sub>n</sub>}} – 以列表形式列出的维基链接.
: {{Para|below}} – 在 group/list 区块下方列出的可选文字.


进一步的细节,以及复杂的约定,在下方参数描述章节作了解释。
<pre>| state = {{{state|collapsed}}}</pre>


=== 所有参数 ===
==== navbar ====
下面是用于{{tl|Navbox}}的参数的一个完整清单。在大多数情况下, 只要有参数 <code>name</code>, <code>title</code> 和 <code>list1</code> 就可以了.
设置导航栏(“查·论·编”链接)显示状态。如果设置为'''plain''',标题栏左侧“查论编”链接不会显示。设置为'''off'''也会移除导航栏,但不会给标题添加保持标题居中的边距。这是高级用法。一般情况下,隐藏导航栏用plain就可以了。不建议隐藏导航栏,便于用户编辑模板。


==== 参数设置 ====
==== border ====
; ''name''
设置导航栏边框状态。如果设置为'''child''''''subgroup''',导航盒会使用无边框的,适用于嵌入到另一个导航盒内的变体。边框隐藏,盒子两侧不会有边距,这样就适合放在导航盒的list部分。如果设置为'''none''',就会变成适合嵌入到其他容器的变体。只在'''嵌入到其他导航盒时'''使用subgroup选项,none选项适用于其他情况。默认情况下(不设置或设置为其他值),导航盒会有1像素的边框。参数的另一种设置风格(使用不具名参数代替border参数):
: 模板的名称。为了在所有使用了所生成模板的页面上, "V•T•E" 链接都能正确地工作, 就需要设置这个参数。你可以输入<code><nowiki>{{subst:PAGENAME}}</nowiki></code>作为这个参数的值, 这也是个快捷的方法。此参数是必需的。
; ''state'' <span style="font-weight: normal;">[<code><nowiki>autocollapse, uncollapsed, collapsed, plain, off</nowiki></code>]
:* 缺省为 <code>autocollapse</code>。如果在使用了其他可折叠表格的同一个页面上有两个或更多表格, 那么该页面上的带 <code>autocollapse</code> 的导航框一开始就会折叠起来。否则, 该导航框会被展开。要了解技术上的实现, 请参见  [[MediaWiki:Common.js]]。
:* 如果设置为 <code>collapsed</code> , 该导航框总会在开始时以折叠起来的状态展现。
:* 如果设置为 <code>plain</code> , 该导航框总会在被展开时不带右侧的 "隐藏" 链接,并且标题会保持居中 (通过使用补白来偏移 V•T•E  链接) 。
:* 如果设置为<code>off</code> , 该导航框总会在被展开时不带右侧的 "隐藏" 链接, 但是没有补白会被用来保持标题居中。这只是为了高级用法; "plain" 选项应能满足大多数需要将 "显示"/"隐藏" 按钮隐藏起来的应用。
:* 如果设置为除<code>autocollapse</code>, <code>collapsed</code>, <code>plain</code>或<code>off</code>之外的其他值 (像 "<code>uncollapsed</code>" ), 该导航框总会在开始时以展开的状态出现, 但是带有“隐藏”按钮。
: 若要在独处 (未被包含) 时显示框体,而在一个条目中时自动隐藏内容,可以将 "<code>uncollapsed</code>" 置于<nowiki><noinclude></nowiki>标签之内:
:* <nowiki>state = <noinclude>uncollapsed</noinclude></nowiki>
:* 如此设置会强制框体在单独出现时 (甚至是后面有其他导航框时) 展开, 显示 "隐藏" 按钮, 而当被堆叠在一个条目中时自动折叠框体。
; ''navbar''
:* 缺省为Navbar。如果设置为<code>plain</code>,在标题栏左侧的 V•T•E 链接不会显示出来, 而且补白会被自动应用以保持标题居中。设置为off可以移除 V•T•E 链接, 但是不会应用补白 (这只是为了高级用法; "plain" 选项应能满足大多数不想要导航栏的应用。) 强烈建议用户不要隐藏导航栏, 为的是使用户编辑该模板更加容易, 并且可以贯穿各个页面都有一个标准的风格。
; ''border''
:* ''关于如何在Navbox内使用Navbox的有关示例和更完整的说明, 请参阅后面的部分。''如果设置为 <code>child</code> 或 <code>subgroup</code>, Navbox可以用作一个无边框的子代, 它可以恰好适合另一个Navbox。边框是隐藏的且没有两边的内边距, 因此适合其父Navbox的列表区域。如果设置为 <code>none</code>, 则边框将会隐藏、内边距将会被移除, Navbox可以被使用于其他容器的子项 (不要在Navbox位于另一个Navbox中时使用 <code>none</code> 选项; 同样的, 只在Navbox位于另一个Navbox中时使用 <code>child</code>/<code>subgroup</code> 选项) 。如果设置成其他任何项 (默认) , 会显示为有1px边框的常规Navbox。将边框指定为子组样式的另一种方法是这样的 (即: 使用第一个未命名参数代替已命名的 ''border'' 参数) :
<pre>
<pre>
{{Navbox|child
{{Navbox|child
……
}}
</pre>
=== 内容参数 ===
==== title ====
导航盒的标题,居中显示在第一行的文本。标题一般需要描述导航盒是关于啥的。导航盒应该有个标题,除非它嵌入到了其他模板中。
==== above ====
导航盒的顶栏,即标题和主体(group、list、……)的间的一行内容。
==== group ====
参数名:group<var>n</var>,即group1、group2、……
导航盒的组,是作为表头显示在对应列表(list)左侧的文本。没有对应group的list会占用一整行空间。
==== list ====
参数名:list<var>n</var>,即list1、list2、……
导航盒的列表,主要内容放在这里面,通常是链接列表。一般是一行,但使用{{tag|div}}包裹不同内容可以实现多行。导航盒至少要有一个list(即list1);每个list都会显示在不同行中。可以每个list设置相关的group,group会作为表头显示在list前。
list使用wikitext无序列表语法,每一项都应占一行,并以星号(*)打头。使用多个星号打头时,项会显示在括号内。只有一项时就可以不用列表,直接写链接。
将参数设置为child或subgroup,可指示此list是用于内联的[[#子导航盒]]。
==== image ====
显示在导航盒内容右侧的图像。参数接受标准的wikitext图像语法。例如:
<pre>[[File:Example.png|80px|link=|alt=]]</pre>
==== imageleft ====
显示在导航盒内容左侧的图像。参数接受标准的wikitext图像语法。例如:
==== below ====
导航盒底栏,即显示在导航盒主体(group、list、……)下的一行内容。
=== 样式参数 ===
不推荐style类参数更改样式(主要是导航盒配色)。使用[[#模板样式|模板样式]]能够更灵活地调整样式,并提供多皮肤支持。
==== bodystyle ====
应用到整个导航盒的CSS样式。此参数可能会导致视觉上的不一致,请小心使用。例子:
* <code>bodystyle = background-color: #<var>rrggbb</var>;</code>
* <code>bodystyle = clear: both;</code>
==== innerstyle ====
应用到导航盒内部表格区域的CSS样式。导航盒最外侧有个包裹层,边框、基本背景色都在这里设置。包裹层内部是个表格,内容都位于表格中。“bodystyle”设置的是包裹层的样式,一般表格会继承包裹层样式。复杂导航盒可能需要单独更改表格区域的CSS样式,于是有了这个参数。
==== basestyle ====
应用到标题、顶栏、组和底栏区域的CSS样式,不会应用到list单元格。使用此样式可以方便地更改导航盒的基础颜色,不必再重复设置导航盒各部分的颜色。例如:<code>basestyle = background-color: lightskyblue;</code>
==== titlestyle ====
应用到标题一行的CSS样式,一般用来调整背景色:<code>basestyle = background-color: navy; color: white;</code>
==== groupstyle ====
应用到组区域的CSS样式。会覆盖先前为整个导航盒设置的样式。
==== groupnstyle ====
参数名:group<var>n</var>style,即group1style、group2style……
应用到指定组的CSS样式。不会替换先前为所有组设置的样式(groupstyle)。使用场景很少。
==== groupwidth ====
“groupwidth”可为组设置统一的宽度。如果组的宽度很奇怪,可以调整此参数。会被“group<var>n</var>style”覆盖。
==== liststyle ====
应用到列表区域的CSS样式。


    ...
==== listnstyle ====
参数名:list<var>n</var>style,即list1style、list2style……


}}
应用到指定列表的CSS样式。不会替换先前为所有列表设置的样式(liststyle)。使用场景很少。
</pre>
 
==== listpadding ====
所有列表单元格的内边距,是一个带长度单位的数组。列表默认有0.25em的左右内边距,没有上下内边距。由于复杂的技术原因,像“listpadding = 0.5em”这样的值是无效的。例子:
* <code>bodystyle = 0.5em 0</code>——将上下内边距设置为0.5em,左右内边距设置为0。
* <code>listpadding = 0</code>——移除内边距。
 
==== oddstyle、evenstyle ====
设置应用到奇数行(oddstyle)/偶数行(evenstyle)列表区域的CSS样式。不会替换先前为所有列表设置的样式(liststyle)。导航盒列表背景色默认是条纹色的(透明和浅灰,由于导航盒背景是白色的,所以透明色会是白色),这样易认性更好。


==== 单元格 ====
==== evenodd ====
; ''title''
设置列表的奇偶行处理方式,可用值有“swap”“odd”“even”“off”。
: 显示在表格顶端一行居中位置的文字。它通常是该模板的主题也就是主体内容的一个简要描述。这应该是单独的一行, 但是如果需要第二行, 请使用 {{tl|-}} 来保证正确的居中。本参数从技术上来说不是必需的, 但是使用 {{tl|Navbox}} 而不带标题是相当没有意义的。
; ''group<sub>n</sub>''
: (即<code>group1</code>, <code>group2</code>等等) 如果被指定, 文字会显示在位于 <code>list<sub>n</sub></code> 左侧的抬头单元格中。如果被省略, <code>list<sub>n</sub></code> 占用表格的全部宽度。
; ''list<sub>n</sub>''
: (即<code>list1</code>、<code>list2</code>等等) 该模板的主体, 通常为一栏链接。格式为内联; 然而, 如果整个列表被装入<code><nowiki><div> </div></nowiki></code>之内,文字能够被输入到不同的行中。最少需要一个 <code>list</code> 参数; 每个附加的 <code>list</code> 被显示在一个单独的表格行中。每个 <code>list<sub>n</sub></code> 可能在其前面有一个相对应的 <code>group<sub>n</sub></code> 参数, 如果提供了的话 (参见下方) 。
; ''image''
:* 一张图片, 会显示在标题 (title) 之下、主体 (group/list) 之右侧的一个单元格中。为使图片能正确地显示, 必须指定 <code>list1</code> 参数。<code>image</code> 参数接受标准的维基代码来显示图片, 即:
:: {{Para|image|<nowiki>[[File:Example.jpg|100px]]</nowiki>}}
; ''imageleft''
: 一张图片, 会显示在标题 (title) 之下, 主体 (list) 之左侧的一个单元格中。为使图片能正确显示, 必须指定<code>list1</code> 参数,而且不能指定分组 (group) 。<code>imageleft</code> 参数接受标准的维基代码来显示图片, 即:
:: {{Para|imageleft|<nowiki>[[File:Example.jpg|100px]]</nowiki>}}
; ''above''
: 一个全宽度单元格, 显示在标题栏与第一个 group/list 之间, 也就是位于该模板的主体 (<code>group</code>、<code>list</code> 和 <code>image</code>) 之上。在一个不带图片的模板中, <code>above</code> 与不带 <code>group1</code> 参数的 <code>list1</code> 参数以同样的方式运作。
; ''below''
: 一个全宽度单元格, 显示在该模板主体 (<code>group</code>、<code>list</code> 和 <code>image</code>) 的下方。在一个不带图片的模板中, <code>below</code> 与该模板最后面的不带 <code>groupn</code> 参数的 <code>listn</code>  参数以同样的方式运作。


==== 样式参数 ====
奇数行列表默认背景色是透明,偶数行是浅灰。如果设置为“swap”,会翻转奇偶行的背景色:奇数行是浅灰,偶数行是透明。设置“odd”(奇)或“even”(偶)会让所有列表单元格都使用对应类型的背景色,设置为“off”会停用颜色翻转。
一般不建议更改样式, 以保持维基百科中模板和网页的一致性。然而, 修改样式的选项还是有的。


; ''bodystyle''
==== abovestyle、belowstyle ====
: 指定应用到模板主体的 CSS 样式。此选项应谨慎使用, 因为它可以导致视觉上的不一致。举例:
应用到顶栏(above)或底栏(below)的CSS样式。
:: <code>bodystyle = background: #nnnnnn;</code>
:: <code>bodystyle = width: N [em/%/px or width: auto];</code>
:: <code>bodystyle = float: [left/right/none];</code>
:: <code>bodystyle = clear: [right/left/both/none];</code>
; ''basestyle''
: 应用于 <code>title</code>, <code>above</code>, <code>below</code> 和 <code>group</code> 单元格的 CSS 样式。该样式不会应用于 <code>list</code> 单元格。这可以方便、容易地改变导航框的基本颜色, 而不必重复导航框的不同部分的样式规范。例子:
: <code>basestyle = background: lightskyblue;</code>
; ''titlestyle''
: 应用于 <code>tltle</code> 单元格的 CSS 样式, 最常见的有导航栏的背景颜色:
:: <code>titlestyle = background: #nnnnnn;</code>
:: <code>titlestyle = background: name;</code>
:: <code>titlestyle = background: none;</code> — 无背景色
; ''groupstyle''
: 应用到 ''group<sub>n</sub>'' 单元格的CSS样式。该选项覆写应用于整个表格的任何样式。举例:
:: <code>groupstyle = background: #nnnnnn;</code>
:: <code>groupstyle = text-align: [left/center/right];</code>
:: <code>groupstyle = vertical-align: [top/middle/bottom];</code>
; ''group<sub>n</sub>style''
: 应用于特定 <code>group</code> 单元格 的 CSS 样式, 只应在必要情况下使用该参数, 如:
: <code>group3style = background: red; color: white;</code>
; ''groupwidth''
: 为 ''group'' 单元格指定统一宽度的数字和单位, 在列表单元格中内容很少可能导致组单元格太宽的情况下。不是默认的。但是, 可能会被 ''group(n)style'' 参数覆盖。例如:
:: <code>groupwidth = 9em</code>
; ''liststyle''
: 应用到所有 <code>list</code> 单元格的CSS样式。若指定了下面的 <code>oddstyle</code> 和 <code>evenstyle</code> 参数, 则它们的优先级高于本参数。
; ''list<sub>n</sub>style''
: 应用于特定 <code>list</code> 单元格 的 CSS 样式, 只应在必要情况下使用该参数, 如:
:: <code>list5style = background: #ddddff;</code>
; ''listpadding''*
: 定义每个列表单元格内边距的数字和单位。列表单元格的左右侧默认内边距是0.25em, 上下默认内边距是0。由于复杂的技术原因, 简单的设置为 "<code>liststyle = padding: 0.5em;</code>" (或其他任何内边距设定) 将不会起作用<sup>[需要测试]</sup>。例如: 
: <code>listpadding = 0.5em 0;</code> (设置上下内边距为0.5em, 左右内边距为0。)
: <code>listpadding = 0;</code> (移除全部内边距。)
; ''oddstyle''
; ''evenstyle''
: 做用于奇 (oddstyle) /偶 (evenstyle) 列表编号。覆盖由 ''liststyle'' 定义的样式。默认是将条纹颜色 (白色和浅灰色) 分别添加到奇数/偶数行以提高可读性。
; ''evenodd'' <span style="font-weight: normal;"><code>[swap, even, odd, off]</code></span>
: 如果设置为 <code>swap</code>, 则偶数和奇数行的颜色将被反转。通常, 偶数行都会有浅灰色的背景条纹; 当此参数被使用时, 奇数行将收到浅灰色条纹, 而不是偶数行。设置为 <code>even</code> 或 <code>odd</code> 会将所有行设置为具有条纹颜色, 设置为 <code>off</code> 将会禁用自动行条带化.
; ''abovestyle''*
; ''belowstyle''*
: 应用于顶部单元格 (在 ''above'' 参数中定义) 和底部单元格 (在 ''below'' 参数中定义) 的CSS样式。通常用于设置背景颜色或文本对齐方式:
:: <code>abovestyle = background: #''nnnnnn'';</code>
:: <code>abovestyle = text-align: [''left/center/right''];</code>
:: <code>belowstyle = background: #''nnnnnn'';</code>
:: <code>belowstyle = text-align: [''left/center/right''];</code>


; ''imagestyle''*
==== imagestyle、imageleftstyle ====
; ''imageleftstyle''*
应用到图像(image)或左侧图像(imageleft)区域的CSS样式。通常用来修复图像过大的问题。例子:<code>iamgestyle = max-width: 80px;</code>
: 应用于右/左侧图像的CSS样式。这些样式仅应在特殊情况小使用, 通常是在设置组的宽度并且图像单元格的宽度变得太大时解决宽度问题。例子:
:: <code>imagestyle = width:5em;</code>


==== 默认样式 ====
==== 默认样式 ====
此处列出的样式设定是使用Navbox的编辑者最经常更改的是在。为了保持简单, 其他更复杂的样式设置被排除在此列表之外。大多数样式都在[[Module:Navbox/styles.css]]中设置。
下面是编者经常会更改的CSS样式。其他复杂样式已被略去。大部分样式放在[[Module:Navbox/styles.css]]里。
<pre>
.navbox { /* bodystyle */
  width: 100%;
  background-color: #fdfdfd;
  vertical-align: center;
}


<pre>
.navbox-title { /* titlestyle */
bodystyle = background: #fdfdfd; width: 100%; vertical-align: middle;
  padding-left: 1em;
titlestyle = background: #ccccff; padding-left: 1em; padding-right: 1em; text-align: center;
  padding-right: 1em;
abovestyle = background: #ddddff; padding-left: 1em; padding-right: 1em; text-align: center;
  background-color: #ccccff;
belowstyle = background: #ddddff; padding-left: 1em; padding-right: 1em; text-align: center;
  text-align: center;
groupstyle = background: #ddddff; padding-left: 1em; padding-right: 1em; text-align: right;
}
liststyle = background: transparent; text-align: left/center;
 
oddstyle = background: transparent;
.navbox-abovebelow { /* abovestyle, belowstyle */
evenstyle = background: #f7f7f7;
  padding-left: 1em;
</pre>
  padding-right: 1em;
由于 ''liststyle'' 和 ''oddstyle'' 是透明的, 因此奇数行使用 ''bodystyle'' 的颜色, 默认为 <span style="background-color: black; color: #fdfdfd; font-family: monospace;">#fdfdfd (rgb(253,253,253))</span> (白色, 带有灰色提示) 。如果列表具有组, 则默认为<code>text-align:left;</code>, 否则, 默认为 <code>text-align:center;</code>。由于只有 ''bodystyle'' 具有垂直对齐, 所有其他样式都继承其垂直对齐样式: <code>vertical-align:middle;</code>。
  background-color: #ddddff;
  text-align: center;
}


=== 高级参数 ===
.navbox-group { /* groupstyle */
; ''bodyclass''
  padding-left: 1em;
; ''aboveclass''
  padding-right: 1em;
; ''groupclass''
  background-color: #ddddff;
; ''listclass''
}
; ''belowclass''
: 这些参数可以将CSS类填加到组或列单元格. ''listclass'' 的最常见用途是为其赋予 <code>hlist</code> 类, 将使得列表水平显示。所有这些参数都接受 <code>hlist</code> 类, 如果要设置多个类, 请使用 {{Para|bodyclass|hlist}} 代替.
; ''titlegroup''
: 这会在标题区域放置一个组, 其默认样式与 ''group<sub>n</sub>'' 相同。仅应在特殊情况下使用它 (通常是高级元模板) , 并且使用它需要对{{tl|Navbox}}的内部代码有一定了解;  您应该已经准备好手动设置CSS样式, 以使一切都可以正常使用 (如果您希望使用它) 。如果您认为有此参数的应用程序, 则最好改变主意, 或先咨询讨论页<s>, 反正应该也没人用</s>。
; ''titlegroupstyle''
: 标题组单元格的样式。
; ''innerstyle''
: 非常高级的参数, 仅用于使用navbox的高级元模板。在内部, 导航框使用外部表格绘制边框, 然后使用内部表格进行其他所有操作 (标题/上方/组/列表/下方/图像等) 。''style''/''bodystyle'' 设置内部表格继承外部表格的样式, 是在高级情况下 (元模板) , 可能有必要直接设置内部表格的样式。此参数提供对内部表格的访问, 因此可以应用样式。使用风险自负<s>。大概也没人用</s>。
; ''nowrapitems''
: 设置为 {{Para|nowarpitems|yes}} 会将nowarp应用于列表项中的每一行, 以及任何 <code>above</code> 或 <code>below</code> 项。
; ''orphan''
: 在子Navbox中设置为 {{Para|orphan|yes}}可修复奇/偶条带并将其从[[:Category:Navbox orphans]]中移除。


==== 微格式 ====
.navbox-list { /* liststyle */
; ''bodyclass''
  text-align: center;
: 此参数作为一个整体插入到导航盒的 "class" 属性中。
}
; ''titleclass''
: 此参数将插入到Navbox标题的 "class" 属性中。
该模板支持添加微格式信息, 以指示其中包含的信息类型。这是通过向各种数据单元添加 "class" 属性来完成的。例如, 要将Navbox标记为包含有关某人的[[Wikipedia:hCard|hCard]]信息, 请添加以下参数:
<pre>
| bodyclass = vcard
</pre>


''和''
.navbox-list-with-group { /* 有对应组的列表 */
  text-align: left;
}


<pre>
.navbox-even { /* evenstyle */
| titleclass = fn
  background-color: #f7f7f7;
}
 
.navbox-odd { /* oddstyle */
  background-color: transparent;
}
</pre>
</pre>


''或'' (例子):
=== HTML类参数 ===
包括“navboxclass”整个导航盒、“bodyclass”表格区域、“titleclass”标题栏、“aboveclass”顶栏、“groupclass”组、“listclass”列表、“belowclass”底栏。这些参数可以为导航盒及其特定区域附加HTML类。最常用的参数是“listclass”和“navboxclass”。


<pre><nowiki>
“listclass”一般设置为“hlist”,使列表以水平模式显示。如果其他区域也需要使用水平列表,可以将bodyclass设置为“hlist”。
| title = The books of <span class="fn">[[Iain Banks]]</span>
</nowiki></pre>


...等等。
“navboxclass”用来给整个导航盒添加类,需要设置一个模板中独一无二的类,如此,使用模板样式附加CSS样式时,模板样式就不会应用到导航盒外的区域。


有关将微格式信息添加到Wikipedia的更多信息, 请参见[[Wikipedia:Wikipedia:WikiProject Microformats]], 有关总体上有关微格式的更多信息, 请参见[[Wikipedia:microformat|microformat]]
==== 微格式 ====
导航盒支持[https://microformats.org/ 微格式]。通过为各区域附加特殊的HTML类可以创建微格式结构。如果希望给模板附加微格式,官方网站上有[https://microformats.org/2014/03/05/getting-started-with-microformats2 微格式入门],相关类可以参考[https://microformats.org/wiki/microformats2#v2_vocabularies 词汇表]。例子:


== 表格格式 ==
<pre>
=== 不带有图像、顶部和底部单元格 ===
由 {{tl|Navbox}} 生成的表格且'''未指定''' ''image'', ''above'' 和 。''below'' 参数 (添加灰色列表背景色仅用于说明) :
{{Navbox
{{Navbox
   | name = Navbox/doc
   | name = 零洲共鸣地标
   | state = uncollapsed
   | navboxclass = template-zth_landmarks h-card
  | liststyle = background: silver;
 
   | title = {{{title}}}
   | title = <span class="p-name">零洲</span>共鸣地标列表
  | group1 = {{{group1}}}
   ……
  | list1  = {{{list1}}}
   | group2 = {{{group2}}}
  | list2  = {{{list2}}}
  | list3  = {{{list3}}} ''没有 {{{group3}}}''
  | group4 = {{{group4}}}
  | list4  = {{{list4}}}
}}
}}
</pre>


=== 带有图像、顶部和底部单元格 ===
{{Anchor|模板样式}}
由 {{tl|Navbox}} 生成的表格且'''指定''' ''image'', ''above'' 和 。''below'' 参数 (添加灰色列表背景色仅用于说明) :
=== 模板样式参数 ===
模板样式参数用来设置附加到导航盒的模板样式表。比起使用style类参数,模板样式更为灵活,并能提供多皮肤支持。


“templatestyles”是应用到当前导航盒的样式表。“chlid templatestyles”参数可传递给衍生出的导航盒,衍生导航盒可用此参数设置自己的样式表。
==== 模板样式使用示例 ====
下面的代码将为导航盒附加样式表“Template:导航盒模板样式示例/styles.css”:
<pre>
{{Navbox
{{Navbox
   | name = Navbox/doc
   | name = {{subst:PAGENAME}}
  | state = uncollapsed
   | title = 导航盒模板样式示例
  | liststyle = background: silver;
   | navboxclass = template-navbox_doc_exts1 <!-- 设置独一无二的HTML类,确保模板样式不会作用于导航盒以外的部分 -->
  | image  = {{{image}}}
   | templatestyles = Template:导航盒模板样式示例/styles.css
   | title = {{{title}}}
   | above  = {{{above}}}
   | group1 = {{{group1}}}
  | list1  = {{{list1}}}
  | group2 = {{{group2}}}
  | list2  = {{{list2}}}
  | list3  = {{{list3}}} ''没有 {{{group3}}}''
  | group4 = {{{group4}}}
  | list4  = {{{list4}}}
  | below  = {{{below}}}
}}


=== 带有图像、不带有组单元格 ===
   内容部分……
由 {{tl|Navbox}} 生成的表格且'''指定''',  ''image'', ''imageleft'', ''lists'' '''不指定''' ''groups'', ''above'', ''below'' 参数 (添加灰色列表背景色仅用于说明) :
{{Navbox
   | name = Navbox/doc
  | state = uncollapsed
  | liststyle = background: silver;
  | image = {{{image}}}
  | imageleft = {{{imageleft}}}
  | title = {{{title}}}
  | list1 = {{{list1}}}
  | list2 = {{{list2}}}
  | list3 = {{{list3}}}
  | list4 = {{{list4}}}
}}
}}
</pre>


== 示例 ==
“child templatestyles”使用示例:
<!-- Please do not encourage folks to use <div> within Navboxes as (unless handled carefully) they can negate liststyles/groupstyles/etc. settings. -->


=== 无图像 ===
原导航盒,名为“VV列表”:
<pre>
<pre>
{{Navbox
{{Navbox
   | name = Navbox/doc
   | name = {{{name|{{subst:PAGENAME}}}}}
   | title = [[Wikipedia:MSC Malaysia|多媒体超级走廊]]
   | title = {{{title|VV列表}}}
   | listclass = hlist
  | navboxclass = template-vv_list {{{navboxclass|}}}
  | templatestyles = Template:VV列表/styles.css
   | child templatestyles = {{{child templatestyles|}}}


   | group1 = 总部
   内容部分……
  | list1  =
}}
* [[Wikipedia:Cyberjaya|赛城]]
</pre>


   | group2 = 涵盖区域
衍生导航盒,名为“扩展VV列表”:
   | list2  =
<pre>
* [[Wikipedia:Klang Valley|巴生谷]]
{{VV列表
  | name = {{subst:PAGENAME}}
   | title = VV列表
   | navboxclass = template-vv_list_expanded
  | child templatestyles = Template:扩展VV列表/styles.css


   | group3 = 主要地标
   内容部分……
  | list3  =
}}
* [[Wikipedia:Petronas Twin Towers|双峰塔]]
</pre>
* [[Wikipedia:Kuala Lumpur Tower|吉隆坡塔]]
* [[Wikipedia:Kuala Lumpur Sentral|吉隆坡中央车站]]
* [[Wikipedia:Technology Park Malaysia|马来西亚科技园]]
* [[Wikipedia:Putrajaya|布城]]
* [[Wikipedia:Cyberjaya|赛城]]
* [[Wikipedia:Kuala Lumpur International Airport|吉隆坡国际机场]]


  | group4 = 基础设施
“扩展VV列表”在挂载“Template:VV列表/styles.css”外,也会挂载“Template:扩展VV列表/styles.css”。后一样式表位于后面,于是可以[https://developer.mozilla.org/zh-CN/docs/Learn_web_development/Core/Styling_basics/Handling_conflicts#%E5%B1%82%E5%8F%A0 层叠]
  | list4  =
* [[Wikipedia:Express Rail Link|吉隆坡机场大道]]
* [[Wikipedia:KL-KLIA Dedicated Expressway|隆布大道]]


  | group5 = 主要应用
==== 导航盒样式表 ====
  | list5  =
零洲共鸣地标的[[Template:零洲共鸣地标/styles.css|样式表]],更改了标题、顶底栏、组、条纹背景色:
* [[Wikipedia:E-Government|电子政务]]
* [[Wikipedia:MyKad|大马卡]]
}}
</pre>


{{Navbox
<pre>
  | name  = Navbox/doc
.template-zth_landmarks .navbox-title { /* 标题 */
   | title = [[Wikipedia:MSC Malaysia|多媒体超级走廊]]
   background-color: rgb(255, 175, 175);
  | listclass = hlist
}


  | group1 = 总部
.template-zth_landmarks .navbox-group { /* 组 */
   | list1  =
   background-color: rgb(255, 207, 207);
* [[Wikipedia:Cyberjaya|赛城]]
}


  | group2 = 涵盖区域
.template-zth_landmarks .navbox-abovebelow { /* 顶/底栏 */
   | list2  =
   background-color: rgb(255, 207, 207);
* [[Wikipedia:Klang Valley|巴生谷]]
}


  | group3 = 主要地标
.template-zth_landmarks .navbox-even { /* 偶数行 */
  | list3  =
  background-color: rgb(255, 240, 240);
* [[Wikipedia:Petronas Twin Towers|双峰塔]]
}
* [[Wikipedia:Kuala Lumpur Tower|吉隆坡塔]]
</pre>
* [[Wikipedia:Kuala Lumpur Sentral|吉隆坡中央车站]]
* [[Wikipedia:Technology Park Malaysia|马来西亚科技园]]
* [[Wikipedia:Putrajaya|布城]]
* [[Wikipedia:Cyberjaya|赛城]]
* [[Wikipedia:Kuala Lumpur International Airport|吉隆坡国际机场]]


  | group4 = 基础设施
=== 高级参数 ===
  | list4  =
==== nowraplinks ====
* [[Wikipedia:Express Rail Link|吉隆坡机场大道]]
将“nowraplinks”设置为“yes”将为列表区域和顶底栏的每个列表项添加“nowrap”类,用来阻止链接内断行。可能有链接过长,一般链接是要断行的。
* [[Wikipedia:KL-KLIA Dedicated Expressway|隆布大道]]


  | group5 = 主要应用
==== orphan ====
  | list5  =
在子导航盒中将“orphan”设置为“yes”对于修复条纹背景色可能有帮助。此外,设置此参数还会将导航盒从[[:Category:孤立导航盒]]中移除。
* [[Wikipedia:E-Government|电子政务]]
* [[Wikipedia:MyKad|大马卡]]
}}


=== 有图像, 无组 ===
== 示例 ==
=== 一般导航盒 ===
组/列表成对。
<pre>
<pre>
{{Navbox
{{Navbox
   | name = Navbox/doc
   | name = Navbox/doc
   | title = [[Wikipedia:MSC Malaysia|多媒体超级走廊]]
   | state = {{{state|}}}
  | navboxclass = template-navbox_doc_ex1
   | listclass = hlist
   | listclass = hlist
  | image = [[File:Flag of Malaysia.svg|80px|link=|alt=马来西亚国旗]]


  | title = 零洲共鸣地标(1—21号)
  | group1 = 1—5
   | list1 =
   | list1 =
* [[Wikipedia:Petronas Twin Towers|双峰塔]]
* [[鳕鱼贫鸟居]]
* [[Wikipedia:Kuala Lumpur Tower|吉隆坡塔]]
* [[鳕鱼神社]]
* [[Wikipedia:Kuala Lumpur Sentral station|吉隆坡中央车站]]
* [[南海鸟居]]
* [[Wikipedia:Technology Park Malaysia|马来西亚科技园]]
* [[星海镇]]
* [[Wikipedia:Putrajaya|布城]]
* [[光圈科技]]
* [[Wikipedia:Cyberjaya|赛城]]
  | group2 = 6—10
* [[Wikipedia:Kuala Lumpur International Airport|吉隆坡国际机场]]
  | list2 =
* [[幽灵岛]]
* [[Sigma]]
* [[莉亚匹克]]
* [[七宫]]
* [[云之彼端]]
  | group3 = 11—15
  | list3 =
* [[冰与火刷怪装置]]
* [[海央末地岛]]
* [[北溟神社]]
* [[水结冰]]
* [[ChinaMobby ELT.|ChinaMobby]]
  | group4 = 16—20
  | list4 =
* [[双子湖神社]]
* [[萝萝村]]
* [[神海阁]]
* [[赤朱之心]]
* [[紫金山庄]]
  | group5 = 21号及以上
  | list5 = [[风吟之地]](一行只有一个链接时无需使用无序列表,即标前面的星号“*”)
}}
}}
</pre>
</pre>
{{Navbox
{{Navbox
   | name = Navbox/doc
   | name = Navbox/doc
   | title = [[Wikipedia:MSC Malaysia|多媒体超级走廊]]
   | state = {{{state|}}}
  | navboxclass = template-navbox_doc_ex1
   | listclass = hlist
   | listclass = hlist
  | image = [[File:Flag of Malaysia.svg|80px|link=|alt=马来西亚国旗]]


  | title = 零洲共鸣地标(1—21号)
  | group1 = 1—5
   | list1 =
   | list1 =
* [[Wikipedia:Petronas Twin Towers|双峰塔]]
* [[鳕鱼贫鸟居]]
* [[Wikipedia:Kuala Lumpur Tower|吉隆坡塔]]
* [[鳕鱼神社]]
* [[Wikipedia:Kuala Lumpur Sentral station|吉隆坡中央车站]]
* [[南海鸟居]]
* [[Wikipedia:Technology Park Malaysia|马来西亚科技园]]
* [[星海镇]]
* [[Wikipedia:Putrajaya|布城]]
* [[光圈科技]]
* [[Wikipedia:Cyberjaya|赛城]]
  | group2 = 6—10
* [[Wikipedia:Kuala Lumpur International Airport|吉隆坡国际机场]]
  | list2 =
* [[幽灵岛]]
* [[Sigma]]
* [[莉亚匹克]]
* [[七宫]]
* [[云之彼端]]
  | group3 = 11—15
  | list3 =
* [[冰与火刷怪装置]]
* [[海央末地岛]]
* [[北溟神社]]
* [[水结冰]]
* [[ChinaMobby ELT.|ChinaMobby]]
  | group4 = 16—20
  | list4 =
* [[双子湖神社]]
* [[萝萝村]]
* [[神海阁]]
* [[赤朱之心]]
* [[紫金山庄]]
  | group5 = 21号及以上
  | list5 = [[风吟之地]]
}}
}}


=== 有两张图像, 无组, 多个列表 ===
=== 有图像、顶栏和底栏 ===
图像显示在右侧,宽度过时低会隐藏。
<pre>
<pre>
{{Navbox
{{Navbox
   | name = Navbox/doc
   | name = Navbox/doc
   | title = [[Wikipedia:MSC Malaysia|多媒体超级走廊]]
   | state = {{{state|}}}
   | listclass = hlist
  | navboxclass = template-navbox_doc_ex2
   | image = [[File:Flag of Malaysia.svg|80px|link=|alt=马来西亚国旗]]
   | bodyclass = hlist
  | imageleft = [[File:Flag of Malaysia.svg|80px]]
 
  | title = 零洲共鸣地标(1—21号)
  | above = 共鸣地标实质上是服务器中的传送点
 
   | image   = [[File:鸟居图标新.png|80px|link=|alt=]]


  | group1 = 1—5
   | list1 =
   | list1 =
* [[Wikipedia:Petronas Twin Towers|双峰塔]]
* [[鳕鱼贫鸟居]]
* [[Wikipedia:Kuala Lumpur Tower|吉隆坡塔]]
* [[鳕鱼神社]]
* [[Wikipedia:Kuala Lumpur Sentral station|吉隆坡中央车站]]
* [[南海鸟居]]
 
* [[星海镇]]
* [[光圈科技]]
  | group2 = 6—10
   | list2 =
   | list2 =
* [[Wikipedia:Express Rail Link|吉隆坡机场快铁]]
* [[幽灵岛]]
* [[Wikipedia:KL-KLIA Dedicated Expressway|隆布大道]]
* [[Sigma]]
 
* [[莉亚匹克]]
* [[七宫]]
* [[云之彼端]]
  | group3 = 11—15
   | list3 =
   | list3 =
* [[Wikipedia:E-Government|电子政务]]
* [[冰与火刷怪装置]]
* [[Wikipedia:MyKad|大马卡]]
* [[海央末地岛]]
* [[北溟神社]]
* [[水结冰]]
* [[ChinaMobby ELT.|ChinaMobby]]
  | group4 = 16—20
  | list4 =
* [[双子湖神社]]
* [[萝萝村]]
* [[神海阁]]
* [[赤朱之心]]
* [[紫金山庄]]
  | group5 = 21号及以上
  | list5 =
[[风吟之地]]


   | list4 =
   | below =
* [[Wikipedia:Klang Valley|巴生谷]]
* 我是相关链接
* [[Template:零洲共鸣地标|]]
** [[Template:零洲共鸣地标|21—40]]
** [[Template:零洲共鸣地标|41—60]]
** ……
}}
}}
</pre>
</pre>
{{Navbox
  | name = Navbox/doc
  | state = {{{state|}}}
  | navboxclass = template-navbox_doc_ex2
  | bodyclass = hlist


{{Navbox
   | title = 零洲共鸣地标(1—21号)
   | name  = Navbox/doc
   | above = 共鸣地标实质上是服务器中的传送点
   | title = [[Wikipedia:MSC Malaysia|多媒体超级走廊]]
 
  | listclass = hlist
   | image   = [[File:鸟居图标新.png|80px|link=|alt=]]
   | image = [[File:Flag of Malaysia.svg|80px|link=|alt=马来西亚国旗]]
  | imageleft = [[File:Flag of Malaysia.svg|80px]]


  | group1 = 1—5
   | list1 =
   | list1 =
* [[Wikipedia:Petronas Twin Towers|双峰塔]]
* [[鳕鱼贫鸟居]]
* [[Wikipedia:Kuala Lumpur Tower|吉隆坡塔]]
* [[鳕鱼神社]]
* [[Wikipedia:Kuala Lumpur Sentral station|吉隆坡中央车站]]
* [[南海鸟居]]
 
* [[星海镇]]
* [[光圈科技]]
  | group2 = 6—10
   | list2 =
   | list2 =
* [[Wikipedia:Express Rail Link|吉隆坡机场快铁]]
* [[幽灵岛]]
* [[Wikipedia:KL-KLIA Dedicated Expressway|隆布大道]]
* [[Sigma]]
 
* [[莉亚匹克]]
* [[七宫]]
* [[云之彼端]]
  | group3 = 11—15
   | list3 =
   | list3 =
* [[Wikipedia:E-Government|电子政务]]
* [[冰与火刷怪装置]]
* [[Wikipedia:MyKad|大马卡]]
* [[海央末地岛]]
* [[北溟神社]]
* [[水结冰]]
* [[ChinaMobby ELT.|ChinaMobby]]
  | group4 = 16—20
  | list4 =
* [[双子湖神社]]
* [[萝萝村]]
* [[神海阁]]
* [[赤朱之心]]
* [[紫金山庄]]
  | group5 = 21号及以上
  | list5 =
[[风吟之地]]


   | list4 =
   | below =
* [[Wikipedia:Klang Valley|巴生谷]]
* 我是相关链接
* [[Template:零洲共鸣地标|零洲共鸣地标]]
** [[Template:零洲共鸣地标|21—40]]
** [[Template:零洲共鸣地标|41—60]]
** ……
}}
}}


=== 有图像、组、顶部和底部单元格 ===
=== 很简单的导航盒 ===
在只有几个链接时,可以使用这种导航盒。
 
<pre>
<pre>
{{Navbox
{{Navbox
   | name = Navbox/doc
   | name = Navbox/doc
   | title = [[Wikipedia:MSC Malaysia|多媒体超级走廊]]
   | state = {{{state|}}}
  | navboxclass = template-navbox_doc_ex3
   | listclass = hlist
   | listclass = hlist
  | above = 顶部文字在此
  | image = [[File:Flag of Malaysia.svg|80px|link=|alt=]]


   | group1 = 总部
   | title = 莉亚迷你社博
  | list1  =
* [[Wikipedia:Cyberjaya|赛城]]


   | group2 = 涵盖区域
   | list1 =
  | list2  =
* [[第一届莉亚迷你社博·莱茵|莱茵 #1]]
* [[Wikipedia:Klang Valley|巴生谷]]
* [[第二届莉亚迷你社博·湛蓝の遥阔★|湛蓝の遥阔★ #2]]
* [[第三届莉亚迷你社博·佛蒙特-秋山|佛蒙特-秋山 #3]]
* [[第四届莉亚迷你社博·滨海新区|滨海新区 #4]]


   | group3 = 主要地标
   | below = 我是相关链接
  | list3  =
* [[Wikipedia:Petronas Twin Towers|双峰塔]]
* [[Wikipedia:Kuala Lumpur Tower|吉隆坡塔]]
* [[Wikipedia:Kuala Lumpur Sentral station|吉隆坡中央车站]]
* [[Wikipedia:Technology Park Malaysia|马来西亚科技园]]
* [[Wikipedia:Putrajaya|布城]]
* [[Wikipedia:Cyberjaya|赛城]]
 
  | group4 = 基础设施
  | list4  =
* [[Wikipedia:Express Rail Link|吉隆坡机场快铁]]
* [[Wikipedia:KL-KLIA Dedicated Expressway|隆布大道]]
 
  | group5 = 应用
  | list5  =
* [[Wikipedia:E-Government|电子政务]]
* [[Wikipedia:MyKad|大马卡]]
 
| below = 底部文字在此
}}
}}
</pre>
</pre>


{{Navbox
{{Navbox
   | name = Navbox/doc
   | name = Navbox/doc
   | title = [[Wikipedia:MSC Malaysia|多媒体超级走廊]]
   | state = {{{state|}}}
  | navboxclass = template-navbox_doc_ex3
   | listclass = hlist
   | listclass = hlist
  | above = 顶部文字在此
  | image = [[File:Flag of Malaysia.svg|80px|link=|alt=]]


   | group1 = 总部
   | title = 莉亚迷你社博
  | list1  =
* [[Wikipedia:Cyberjaya|赛城]]


   | group2 = 涵盖区域
   | list1 =
  | list2  =
* [[第一届莉亚迷你社博·莱茵|莱茵 #1]]
* [[Wikipedia:Klang Valley|巴生谷]]
* [[第二届莉亚迷你社博·湛蓝の遥阔★|湛蓝の遥阔★ #2]]
* [[第三届莉亚迷你社博·佛蒙特-秋山|佛蒙特-秋山 #3]]
* [[第四届莉亚迷你社博·滨海新区|滨海新区 #4]]


   | group3 = 主要地标
   | below = 我是相关链接
  | list3  =
}}
* [[Wikipedia:Petronas Twin Towers|双峰塔]]
* [[Wikipedia:Kuala Lumpur Tower|吉隆坡塔]]
* [[Wikipedia:Kuala Lumpur Sentral station|吉隆坡中央车站]]
* [[Wikipedia:Technology Park Malaysia|马来西亚科技园]]
* [[Wikipedia:Putrajaya|布城]]
* [[Wikipedia:Cyberjaya|赛城]]
 
  | group4 = 基础设施
  | list4  =
* [[Wikipedia:Express Rail Link|吉隆坡机场快铁]]
* [[Wikipedia:KL-KLIA Dedicated Expressway|隆布大道]]


  | group5 = 应用
== 子导航盒 ==
  | list5  =
可以在导航盒中放子导航盒。子导航盒可以由特殊代码生成,也可以直接嵌套标准导航盒代码。使用后一种方法的话,模板展开后长度会大很多。
* [[Wikipedia:E-Government|电子政务]]
* [[Wikipedia:MyKad|大马卡]]


| below  = 底部文字在此
如果选用特殊代码,需要将“list<var>n</var>”设置为“child”或“subgroup”。子导航盒元素可以通过在普通参数名前添加“child<var>n</var>_”“subgroup<var>n</var>_”<var>n</var>_”设置(例如“child1_list1”或“1_list1”)。在这些参数名前继续附加前缀可继续嵌套导航盒(例如“child1_child1_list1”或“1_1_list1”)。下面是基本示例代码(子导航盒位于第1个组/列表区域):
}}


== 子导航框 ==
通过使用 "child" 作为第一个参数, 或者通过设置 "border" 参数, 可以在单个边框内放置多个导航框。这样做的基本代码如下 (为第一个组/列表区域添加一个子组) :
<pre>
<pre>
{{Navbox
{{Navbox
| name = {{subst:PAGENAME}}
  | name = {{subst:PAGENAME}}
| title = 标题
  | title = 子导航盒示例
  | class = template-navbox_doc_ex4


| group1 = [可选]
  | group1 = 组1
| list1 = {{Navbox|child
  | list1 = child
  ...子导航框参数...
    | 1_title = 子盒1
}}


...
    | 1_group1 = 组1.1
    | 1_list1 = child
      | 1_1_group1 = 组1.1.1
      | 1_1_list1 = 列表1.1.1
      ……
    | 1_group2 = 组1.2
    | 1_list2 = 列表1.2
    ……
  | group2 = 组2
  | list2 = 列表2
  ……
}}
}}
</pre>
</pre>


=== 子组示例 ===
如果选用嵌套导航盒,需要将子导航盒的第1个不具名参数或“border”参数设置为“child”或“subgroup”。下面是基本示例代码(子导航盒位于第1个组/列表区域):
此示例显示了使用 <code>child</code> 作为第一个未命名参数创建的两个子组。条带将自动交替显示。要完全删除该条带, 可以在每个导航框中设置 <code>liststyle = background:transparent;</code>。


<pre>
{{Navbox
{{Navbox
   | name = Navbox/doc
   | name = {{subst:PAGENAME}}
  | image = [[File:Flag of the United States.svg|100px|link=|alt=]]
   | title = 子导航盒示例
  | state = uncollapsed
   | class = template-navbox_doc_ex5
   | title = 多子组示例
 
 
   | group1 = [optional]
   | above = 顶部
   | list1  = {{Navbox|child
  | below = 底部
     子导航盒参数……
   | group1 = 组 1
   | list1  = 列表 1
  | group2 = 组 2
  | list2  =
  {{Navbox|child
     | group1 = 组 2.1
    | list1  = 列表 1
    | group2 = 组 2.2
    | list2  = 列表 2
    | group3 = 组 2.3
    | list3  = 列表 3
  }}
  | group3 = 组 3
  | list3 = 列表 3
  | group4 = 组 4
  | list4 =
  {{Navbox|child
    | group1 = 组 4.1
    | list1  = 列表 1
    | group2 = 组 4.2
    | list2  = 列表 2
    | group3 = 组 4.3
    | list3  = 列表 3
   }}
   }}
  ……
}}
}}
</pre>


=== 在单个容器中实现多个显示/隐藏 ===
=== 子导航盒示例 ===
下面的示例使用主容器的常规导航框生成, 然后其list1, list2和list3参数每个都包含另一个导航框, 并设置了 {{Para|1|child}} 。查看 (v) , 讨论 (t) , 编辑 (e) 导航栏链接均使用 {{Para|navbar|plain}} 隐藏, 或者可以通过省略 ''name'' 参数来隐藏 (与常规导航框不同, 子导航框不需要设置 name 参数)
下例导航盒有两个子导航盒和一个孙导航盒,由关键字“child”和“subgroup”(可互换)创建。条纹是自动生成的。如需移除所有条纹,可将<code>.navbox-subgroup</code>的<code>background-color</code>CSS属性设置为<code>initial</code>


{{Navbox
{{Navbox
   | name = Navbox/doc
   | name = Navbox/doc
  | title = [[File:Blason France moderne.svg|x17px|link=|alt=]] [[File:Flag of France.svg|x17px|link=|alt=]] [[Wikipedia:French colonial empire|法兰西殖民帝国]]
   | state = uncollapsed
   | state = uncollapsed
   | list1 = {{Navbox|child
   | title = 多子组示例
    | navbar    = plain
  | class = template-navbox_doc_ex6
    | title    = 位于[[Wikipedia:Africa|非洲]]和[[Wikipedia:Indian Ocean|印度洋]]的[[Wikipedia:French colonial empire|前法兰西殖民地]]
 
    | listclass = hlist
  | above = 顶栏
    | group1 = [[Wikipedia:Mahgreb|马格里布]]
 
    | list1  =
  | group1 = 组1
* [[Wikipedia:French rule in Algeria|阿尔及利亚]]
  | list1  = 列表
* [[Wikipedia:French Morocco|摩洛哥]] <small>([[Wikipedia:Arguin|阿尔金岛]])</small>
  | group2 = 组2
* [[Wikipedia:History of Tunisia|突尼斯]]
  | list2  = child
    | group2 = [[Wikipedia:French West Africa|法属西非]]
     | child2_group1 = 组2.1
    | list2  =
     | child2_list1 = 列表
* [[Wikipedia:History of Côte d'Ivoire#French Period|象牙海岸]]
     | child2_group2 = 组2.2
* [[Wikipedia:French Dahomey|达荷美]]
     | child2_list2 = 列表
* [[Wikipedia:French Sudan|法属苏丹]]
     | child2_group3 = 组2.3
* [[Wikipedia:French Guinea|几内亚]]
     | child2_list3  = 列表
* [[Wikipedia:History of Mauritania#French colonization and post-colonial history|毛里塔尼亚]]
  | group3 = 组3
* [[Wikipedia:History of Niger#Colonization|尼日尔]]
  | list3 = 列表
* [[Wikipedia:History of Senegal|塞内加尔]]
  | group4 = 组4
* [[Wikipedia:French Upper Volta|上沃尔特]]
   | list4 = subgroup
* [[Wikipedia:French Togoland|法属多哥兰]]
     | subgroup4_group1 = 组4.1
* [[Wikipedia:James Island (The Gambia)|詹姆斯岛]]
     | subgroup4_list1 = 列表
     | group3 = [[Wikipedia:French Equatorial Africa|法属赤道非洲]]
     | subgroup4_group2 = 组4.2
     | list3 =
     | subgroup4_list2 = 列表
* [[Wikipedia:Colonial Chad|乍得]]
     | subgroup4_group3 = 组4.3
* [[Wikipedia:History of Gabon|加蓬]]
     | subgroup4_list3 = child
* [[Wikipedia:History of the Republic of the Congo|中刚果]]
      | subgroup4_child3_group1 = 组4.3.1
* [[Wikipedia:Oubangui-Chari|乌班吉沙立]]
      | subgroup4_child3_list1 = 列表
     | group4 = [[Wikipedia:Comoros|科摩罗]]
      | subgroup4_child3_group2 = 组4.3.2
     | list4 =
      | subgroup4_child3_list2 = 列表
* [[Wikipedia:Anjouan|昂儒昂岛]]
* [[Wikipedia:Grande Comore|大科摩罗岛]]
* [[Wikipedia:Mohéli|莫埃利岛]]
* [[Wikipedia:History of Djibouti#French Interest|法属索马里兰 (吉布提)]]
* [[Wikipedia:History of Madagascar#French control|马达加斯加]]
* [[Wikipedia:Mauritius|法兰西岛]]
* [[Wikipedia:Seychelles|塞舌尔]]
}}
  | list2 = {{Navbox|child
     | navbar    = plain
     | title    = 位于[[Wikipedia:Americas|美洲]]的[[Wikipedia:French colonial empire|前法兰西殖民地]]
    | listclass = hlist
    | list1 =
* [[Wikipedia:New France|新法兰西]]{{spaces|2}}<small>[[Wikipedia:Acadia|阿卡迪亚]], [[Wikipedia:Louisiana (New France)|路易斯安纳]], [[Wikipedia:Canada, New France|加拿大]], [[Wikipedia:Newfoundland (island)|纽芬兰岛]] 1655–1763 </small>
    | list2 =
* [[Wikipedia:Inini|Inini]]
* [[Wikipedia:Berbice|Berbice]]
* [[Wikipedia:Saint-Domingue|法属圣多明戈]]
* <small>[[Wikipedia:Haiti|海地]]</small>
* [[Wikipedia:Tobago|多巴哥岛]]
* [[Wikipedia:History of the British Virgin Islands|维尔京群岛]]
* [[Wikipedia:France Antarctique|France Antarctique]]
* [[Wikipedia:France Équinoxiale|France Équinoxiale]]
    | below      = [[Wikipedia:French West India Company|法属西印度公司]]
  }}
   | list3 = {{Navbox|child
     | navbar    = plain
     | title      = 位于[[Wikipedia:Asia|亚洲]]和[[Wikipedia:Oceania|大洋洲]]的[[Wikipedia:French colonial empire|前法兰西殖民地]]
    | listclass = hlist
     | group1 = [[Wikipedia:French India|法属印度]]
     | list1 =
* [[Wikipedia:Chandernagor|金德讷格尔]]
* [[Wikipedia:Coromandel Coast|乌木海岸]]
* [[Wikipedia:History of Chennai|马德拉斯]]
* [[Wikipedia:Mahé, India|马埃]]
* [[Wikipedia:History of Pondicherry|本地治里]]
* [[Wikipedia:Karaikal|卡来卡]]
* [[Wikipedia:Yanam (India)|亚南]]
     | group2 = [[Wikipedia:French Indochina|法属印度支那]]
     | list2 =
* [[Wikipedia:Colonial Cambodia|柬埔寨]]
* [[Wikipedia:History of Laos to 1945#French Laos|老挝]]
* [[Wikipedia:French Indochina|越南]] <small>([[Wikipedia:Annam (French colony)|安南]], [[Wikipedia:Cochinchina|交趾支那]], [[Wikipedia:Tonkin|东京 (越南)]])</small>
    | group3 = 亚洲其他部分
    | list3  =
* [[Wikipedia:Alawite State|Alaouites]]
* [[Wikipedia:Republic of Hatay|Alexandretta-Hatay]]
* [[Wikipedia:Sri Lanka|锡兰]]
* [[Wikipedia:Kwangchowan|广州湾]]
    | group4 = [[Wikipedia:Oceania|大洋洲]]
    | list4  =
* [[Wikipedia:New Hebrides|新赫布里底群岛]]
** [[Wikipedia:History of Vanuatu|瓦努阿图]]
    | below      = [[Wikipedia:French East India Company|法属东印度公司]]
  }}
}}
}}


== 技术细节 ==
== 技术细节 ==
* 该模板的大部分外观都使用CSS类, 因此完全可皮肤化。
* “查·论·编”链接由[[Template:Navbar]]生成。
* 在内部,此元模板使用HTML标记而不是表代码的Wiki标记。这是我们制作元模板的常用方法, 因为Wiki标记有几个缺点。例如, 它使得在参数中使用[[mw:Help:ParserFunctions|解析器函数]]和特殊字符变得困难。
* 组与列表间2px宽的间隙是用列表单元格的“border-left”CSS属性生成的。如果希望更改导航盒背景色(如<code>bodystyle = background-color: coral;</code>),则可能需让“border-left-color”与其匹配(即<code>liststyle = border-left-color: coral;</code>)。如果希望给列表区域添加边框,间隙会消失,请自行探索解决办法(或者不要那个间隙了)。
* 更多技术细节可参见其[[Wikipedia:Template:Navbox/talk|原讨论页]], CSS类定义于[[Module:Navbox/styles.css]], 用于隐藏框的可折叠表格在[[MediaWiki:Common.js]]里。
* 相邻导航盒间的边框会合并,上下导航盒间只有1px宽边框。如果设置了外边距,边框就不能合并了。
* 导航盒最外层容器的左右外边距默认为“auto”。如果希望以浮动形式显示导航盒,则需手动设置“margin-left”和“margin-right”,因为默认的“auto”会影响浮动。下例是浮动导航盒样式代码的示例:<br /><code>bodystyle = max-width: 22em; float: right; margin-left: 1em; margin-right: 0;</code>
* 导航盒模板大大增加了页面的模板展开后长度,严重时可导致页面超过大小限制,影响内容显示。有一些改善方法:
** 可将{{tlc|Navbox}}替换为<code><nowiki>{{#invoke:Navbox|navbox}}</nowiki></code>,大概可以将展开后长度减半。
** 在导航盒中嵌套模板可使展开后长度增加数倍。使用[[#子导航盒]]一节所述的行内子盒语法可在一定程度上降低影响。


=== 复杂 ===
=== 复制到其他wiki ===
* 组和列表之间的2px宽边框是使用列表单元格的border-left属性绘制的。因此, 如果您希望更改模板的背景颜色 (例如<code>bodystyle = background: purple;</code>),则需要使border-left-color与背景颜色匹配 (即 <code>liststyle = border-left-color: purple;</code>)。如果您希望每个列表单元格周围都有边框, 那么列表单元格和组单元格之间的2px边框将消失; 您必须想出自己的解决方案。
如果希望在其他wiki上使用Navbox模板,需要有以下前提:
* 列表单元格宽度被设置为100%。因此, 如果你想手动设置组单元格的宽度, 你也需要定义列表样式, 以使其含有 <code>width: auto;</code>。如果你想同时设置组宽度和使用图像, 则需要由CSS确定groupstyle, liststyle, imagestyle和imageleftstyle参数中的CSS, 才能使所有功能正常工作。设置组宽度的示例:  
* 必须安装[[mw:Extension:Scribunto|Extension:Scribunto]]和[[mw:Extension:TemplateStyles|Extension:TemplateStyles]]扩展。
*: <code>groupstyle = width: 10em;</code>
* [[Module:Navbox]]及其模板样式依赖必须复制到wiki中,这些依赖已在[[Module:Navbox/doc]]中列出。
*: <code>liststyle = width: auto;</code>
* 如果希望使用自动折叠功能,则需复制[[MediaWiki:Common.js]]的“Add support to mw-collapsible for autocollapse, innercollapse and outercollapse”部分。
: 相邻的导航框之间只有1px的边界 (<abbr title="Internet Explorer">IE</abbr> 6 除外,IE 6 不支持必要的CSS) 。如果您设置 <code>style / bodystyle</code>的顶部或底部边距, 则此方法将失效。
* 外部导航框的默认 <code>margin-left</code> 和 <code>margin-right</code> 被设置为 "auto;"。如果你想以浮动形式使用导航框, 你需要为 <code>margin-left</code> 和 <code>margin-right</code> 设定一个值, 因为自动边距会干扰float选项。例如,添加以下代码以将以浮动形式使用导航框:
*: <code>bodystyle = width: 22em; float: right; margin-left: 1em; margin-right: 0;</code>
 
=== 复制到其他计划或wiki? ===
关于复制{{tl|Navbox}}至其他wiki的更详细的信息可以在[[Wikipedia:Template talk:Navbox|原讨论页]]找到。
 
=== 已知问题 ===
# 如果导航框的标题跨越多行, 则第二行将显示在中心右侧。通过使用 <code><nowiki><br style="clear: both;"></nowiki></code> 对换行符进行硬编码可以避免这种情况。
# 在IE8和9, 在使用 <code>hlist</code> 时有个bog; 如果列表项以图像开头, 则导航框将无法将列表包装到下一行, 从而导致导航框将其宽度扩展到屏幕之外。可以通过在图像前面添加 <code><nowiki>&amp;nbsp;</nowiki></code> 来解决此问题。<!--
# Excessive use of the '''unsubstituted''' {{tl|•}} template as a delimiter, can in extreme cases cause the wiki page rendering to fail&nbsp;— there is a limit to the number of templates that can be used on a page (example [[Ketamine]] where the inclusion of eleven Navboxes with hundreds of bullets caused the page load not to complete, only the substitution of the bullets in those navboxes cured the problem). Use of the <code>hlist</code> class avoids the delimiter transclusion issue altogether, as the delimiters are rendered via CSS. -->
# 当页面连续包含多个导航框时, 每个导航框应放在其自己的行上, 位于编辑窗口的左边缘。将多个导航框放在一行上会导致第二个及后续导航框中的格式化问题。


== 模板数据 ==
== 模板数据 ==
{{TemplateData header}}
{{TemplateData header}}
<templatedata>
<templatedata>
{
{
  "description": "本模板允许通过提供一个或多个链接列表相对快速地创建一个导航模板。",
"description": "本模板可以通过提供链接列表相对快速地创建导航盒。",
  "format": "{{_\n  | _ = _\n}}\n",
"format": "block",
  "params": {
"params": {
    "name": {
"border": {
      "label": "模板名称",
"label": "边框样式",
      "description": "模板的名称。使 \"V•T•E\" 链接都能正确地工作。你可以输入{{subst:PAGENAME}}作为这个参数的值。",
"description": "设置为“child”(等同于“subgroup”)会调整导航盒,使其适合作为子组嵌入到其他导航盒中;设置为“none”则适合嵌入到其他非导航盒模板中。",
      "type": "wiki-page-name",
"type": "line",
      "default": "{{subst:PAGENAME}}",
"suggestedvalues": [
      "required": true
"child",
    },
"subgroup",
    "state": {
"off"
      "label": "折叠状态",
],
      "description": "[autocollapse, uncollapsed, collapsed, plain, off] 参见模板页面",
"aliases": [
      "type": "string",
"1"
      "default": "autocollapse"
]
    },
},
    "navbar": {
"name": {
      "label": "导航栏显示状态",
"label": "模板名",
      "description": "如果设置为plain,在标题栏左侧的 V•T•E 链接不会显示出来, 而且补白会被自动应用以保持标题居中。",
"description": "模板页面名,用来设置“查·论·编”链接。可以使用{{subst:PAGENAME}}作为参数值。",
      "type": "string"
"type": "wiki-page-name",
    },
"default": "{{subst:PAGENAME}}",
    "border": {
"suggested": true
      "label": "边框",
},
      "description": "[(child/subgroup), off] 如果设置为 child 或 subgroup, Navbox可以用作一个无边框的子代, 它可以恰好适合另一个Navbox; 如果设置为 none, 则边框将会隐藏、内边距将会被移除, Navbox可以被使用于其他容器的子项。",
"state": {
      "type": "string"
"label": "折叠状态",
    },
"description": "导航框的折叠状态。默认为根据页面中折叠元素数量自动判断,“expanded”为默认展开,“collapsed”为默认折叠。",
    "title": {
"type": "line",
      "label": "标题",
"default": "autocollapse",
      "description": "显示在表格顶端一行居中位置的文字",
"suggestedvalues": [
      "type": "unbalanced-wikitext",
"autocollapse",
      "suggested": true
"expanded",
    },
"collapsed",
    "group1": {
"plain",
      "label": "组 1",
"off"
      "description": "第1组, 如果被指定, 文字会显示在位于 listn 左侧的抬头单元格中; 如果被省略, listn 占用表格的全部宽度。",
]
      "type": "unbalanced-wikitext"
},
    },
"navbar": {
    "list1": {
"label": "导航栏显示状态",
      "label": "列表单元格 1",
"description": "[plain | none] 如果设置为“plain”,标题栏左侧的“查·论·编”导航栏不会显示,导航盒标题保持居中。为便于用户编辑,一般不建议隐藏导航栏。",
      "description": "第1个列表单元格, 该模板的主体, 通常为一栏链接。",
"type": "line",
      "type": "unbalanced-wikitext"
"suggestedvalues": [
    },
"plain",
    "group2": {
"off"
      "label": "组 2",
]
      "description": "同 \"组 1\"",
},
      "type": "unbalanced-wikitext"
"nowrapitems": {
    },
"label": "项不断行",
    "list2": {
"description": "“yes”会为列表项应用“nowrap”类,以阻止断行。",
      "label": "列表单元格 2",
"type": "boolean"
      "description": "同 \"列表单元格 1\"",
},
      "type": "unbalanced-wikitext"
"orphan": {
    },
"type": "boolean"
    "group3": {
},
      "label": "组 3",
"templatestyles": {
      "description": "同 \"组 1\"",
"label": "模板样式",
      "type": "unbalanced-wikitext"
"description": "附加到导航和的模板样式表",
    },
"type": "wiki-page-name",
    "list3": {
"suggestedvalues": [
      "label": "列表单元格 3",
"Template:{{subst:ROOTPAGENAME}}/styles.css"
      "description": "同 \"列表单元格 1\"",
]
      "type": "unbalanced-wikitext"
},
    },
"child templatestyles": {
    "group4": {
"label": "子模板样式",
      "label": "组 4",
"description": "传递给衍生导航盒的模板样式。衍生导航盒可以使用此参数来在本体外附加自己的样式表。",
      "description": "同 \"组 1\", 注意数字可以一直延伸下去",
"type": "line",
      "type": "unbalanced-wikitext"
"suggestedvalues": [
    },
"{{{child templatestyles|}}}",
    "list4": {
"Template:{{subst:ROOTPAGENAME}}/styles.css"
      "label": "列表单元格 4",
]
      "description": "同 \"列表单元格 1\", 注意数字可以一直延伸下去",
},
      "type": "unbalanced-wikitext"
"navboxclass": {
    },
"label": "导航盒类",
    "image": {
"description": "附加到导航盒最外部元素的HTML类",
      "label": "右侧图像",
"type": "line",
      "description": "显示在标题 (title) 之下、主体 (group/list) 之右侧的一个单元格中的一张图像, 使用标准Wikitext语法",
"suggested": true
      "example": "[[File:Exaple.png|80px]]",
},
      "type": "unbalanced-wikitext"
"bodyclass": {
    },
"label": "主体类",
    "imageleft": {
"description": "附加到导航盒表格元素的HTML类",
      "label": "左侧图像",
"type": "line"
      "description": "显示在标题 (title) 之下、主体 (list) 之左侧的一个单元格中的一张图像, 使用标准Wikitext语法",
},
      "example": "[[File:Example.png|80px]]",
"titleclass": {
      "type": "unbalanced-wikitext"
"label": "标题类",
    },
"description": "附加到标题栏的HTML类",
    "above": {
"type": "line"
      "label": "顶部单元格",
},
      "description": "一个全宽度单元格, 显示在标题栏与第一个 group/list 之间",
"aboveclass": {
      "type": "unbalanced-wikitext"
"label": "顶栏类",
    },
"description": "附加到顶栏的HTML类",
    "below": {
"type": "line"
      "label": "底部单元格",
},
      "description": "一个全宽度单元格, 显示在该模板主体 (group、list 和 image) 的下方。",
"belowclass": {
      "type": "unbalanced-wikitext"
"label": "底栏类",
    },
"description": "附加到底栏的HTML类",
    "bodystyle": {
"type": "line"
      "label": "主体CSS样式",
},
      "description": "指定应用到模板主体的 CSS 样式",
"groupclass": {
      "type": "string"
"label": "组类",
    },
"description": "附加到所有组的HTML类",
    "basestyle": {
"type": "line"
      "label": "基本CSS样式",
},
      "description": "应用于 title, above, below 和 group 单元格的 CSS 样式",
"listclass": {
      "type": "string"
"label": "列表类",
    },
"description": "附加到所有列表区域的HTML类,一般包含“hlist”,用来设置水平列表。",
    "titlestyle": {
"type": "line",
      "label": "标题栏CSS样式",
"suggestedvalues": [
      "description": "应用于 tltle 单元格的 CSS 样式",
"hlist"
      "type": "string"
],
    },
"suggested": true
    "groupstyle": {
},
      "label": "组CSS样式",
"bodystyle": {
      "description": "应用到所有 group 单元格的CSS样式",
"label": "主体CSS样式",
      "type": "string"
"description": "指定应用到导航盒主体的CSS样式",
    },
"type": "line"
    "groupwidth": {
},
      "label": "组单元格宽度",
"basestyle": {
      "description": "为 group 单元格指定统一宽度的数字和单位",
"label": "基本CSS样式",
      "type": "string"
"description": "应用到标题、顶/底栏、组的CSS样式",
    },
"type": "line"
    "liststyle": {
},
      "label": "列表CSS样式",
"titlestyle": {
      "description": "应用到所有 list 单元格的CSS样式",
"label": "标题栏CSS样式",
      "type": "string"
"type": "line"
    },
},
    "listpadding": {
"abovestyle": {
      "label": "列表单元格内边距",
"label": "顶栏CSS样式",
      "description": "定义每个列表单元格内边距的数字和单位",
"type": "line"
      "type": "string"
},
    },
"belowstyle": {
    "oddstyle": {
"label": "底栏CSS样式",
      "label": "奇数列表行CSS样式",
"type": "line"
      "description": "作用于奇数列表行的CSS样式。覆盖由 liststyle 定义的样式。",
},
      "type": "string"
"groupstyle": {
    },
"label": "组CSS样式",
    "evenstyle": {
"description": "应用到所有组区域的CSS样式",
      "label": "偶数列表行CSS样式",
"type": "line"
      "description": "作用于偶数列表行的CSS样式。覆盖由 liststyle 定义的样式。",
},
      "type": "string"
"groupwidth": {
    },
"label": "组单元格宽度",
    "evenodd": {
"description": "设置组区域的宽度,要带单位",
      "description": "[swap, even, odd, off] 如果设置为 swap, 则偶数和奇数行的颜色将被反转; 设置为 even 或 odd 会将所有行设置为具有条纹颜色; 设置为 off 将会禁用自动行条带化.",
"type": "line",
      "type": "string"
"example": "8em"
    },
},
    "imagestyle": {
"liststyle": {
      "label": "右侧图像单元格CSS样式",
"label": "列表区域CSS样式",
      "description": "应用于右侧图像单元格的CSS样式",
"description": "应用到所有列表区域的CSS样式",
      "type": "string"
"type": "line"
    },
},
    "imageleftstyle": {
"listpadding": {
      "label": "左侧图像单元格的CSS样式",
"label": "列表区域内边距",
      "description": "应用于左侧图像单元格的CSS样式",
"description": "设置所有列表区域的内边距,使用标准CSS边距值。",
      "type": "string"
"type": "line"
    },
},
    "group1style": {
"oddstyle": {
      "label": "组 1 CSS样式",
"label": "奇数列表行CSS样式",
      "description": "应用于 组 1 的CSS样式",
"description": "作用于奇数列表行的CSS样式。覆盖由“liststyle”定义的样式。",
      "type": "string"
"type": "line"
    },
},
    "group2style": {
"evenstyle": {
      "label": "组 2 CSS样式",
"label": "偶数列表行CSS样式",
      "description": "应用于 组 2 的CSS样式",
"description": "作用于偶数列表行的CSS样式。覆盖由“liststyle”定义的样式。",
      "type": "string"
"type": "line"
    },
},
    "group3style": {
"evenodd": {
      "label": "组 3 CSS样式",
"description": "“swap”会翻转奇偶行的条纹背景色;“even”和“odd”会使所有行使用相对应的背景颜色(全用偶行背景色或奇行背景色);“off”会禁用条纹背景色。",
      "description": "应用于 组 3 的CSS样式",
"type": "line",
      "type": "string"
"suggestedvalues": [
    },
"swap",
    "group4style": {
"even",
      "label": "组 4 CSS样式",
"odd",
      "description": "应用于 组 4 的CSS样式, 注意数字可以一直延伸下去",
"off"
      "type": "string"
]
    },
},
    "item1style": {
"imagestyle": {
      "label": "列表单元格 1 CSS样式",
"label": "图像区域CSS样式",
      "description": "应用于 列表单元格 1 的CSS样式",
"description": "应用于右侧图像区域的CSS样式",
      "type": "string"
"type": "line"
    },
},
    "item2style": {
"imageleftstyle": {
      "label": "列表单元格 2 CSS样式",
"label": "左侧图像单元格的CSS样式",
      "description": "应用于 列表单元格 2 的CSS样式",
"type": "line"
      "type": "string"
},
    },
"title": {
    "item3style": {
"label": "标题",
      "label": "列表单元格 3 CSS样式",
"description": "居中显示在导航盒首行的标题",
      "description": "应用于 列表单元格 3 的CSS样式",
"type": "line",
      "type": "string"
"suggested": true
    },
},
    "item4style": {
"group1style": {
      "label": "列表单元格 4 CSS样式",
"label": "组1CSS样式",
      "description": "作用于 列表单元格 4 的CSS样式, 注意数字可以一直延伸下去",
"type": "line"
      "type": "string"
},
    },
"list1style": {
    "bodyclass": {
"label": "列表1CSS样式",
      "label": "导航框CSS类",
"type": "line"
      "description": "应用到整个导航框的CSS类",
},
      "type": "string"
"group1": {
    },
"label": "组1",
    "groupclass": {
"description": "显示在对应列表区域(listn)左侧,作为其描述/标题的文本。",
      "label": "组单元格CSS类",
"type": "line"
      "description": "应用到所有组单元格的CSS类",
},
      "type": "string"
"list1": {
    },
"label": "列表1",
    "listclass": {
"description": "导航盒的列表区域,一般是一些链接。如果包含两个以上链接,则应使用wikitext无序列表来列出每个链接。如果没有对应的组(groupn),列表区域会使用整个导航盒的宽度,文本会居中显示。",
      "label": "列表单元格CSS类",
"type": "content",
      "description": "应用到所有列表单元格的CSS类, 一般的说必须包含 hlist",
"suggested": true
      "type": "string",
},
      "default": "hlist"
"group2style": {
    },
"label": "组2CSS样式",
    "aboveclass": {
"inherits": "group1style"
      "label": "顶部单元格CSS类",
},
      "description": "应用到顶部单元格的CSS类",
"list2style": {
      "type": "string"
"label": "列表2CSS样式",
    },
"inherits": "list1style"
    "belowclass": {
},
      "label": "底部单元格CSS类",
"group2": {
      "description": "应用到底部单元格的CSS类",
"label": "组2",
      "type": "string"
"inherits": "group1"
    },
},
    "titlegroup": {
"list2": {
      "description": "(高级参数) 这会在标题区域放置一个组, 其默认样式与 groupn 相同。仅应在特殊情况下使用它。",
"label": "列表2",
      "type": "string"
"inherits": "list1"
    },
},
    "titlegroupstyle": {
"group3style": {
      "description": "标题组单元格的样式。",
"label": "组3CSS样式",
      "type": "string"
"inherits": "group1style"
    },
},
    "innerstyle": {
"list3style": {
      "description": "(高级参数, 详细信息见模板页面) 暂缺"
"label": "列表3CSS样式",
    },
"inherits": "list1style"
    "nowrapitems": {
},
      "description": "设置为 |nowarpitems=yes 会将nowarp应用于列表项中的每一行, 以及任何 above 或 below 项。",
"group3": {
      "type": "boolean"
"label": "组3",
    },
"inherits": "group1"
    "orphan": {
},
      "description": "在子Navbox中设置为 |orphan=yes可修复奇/偶条带并将其从Category:Navbox orphans中移除。",
"list3": {
      "type": "boolean"
"label": "列表3",
    }
"inherits": "list1"
  }
},
"group4style": {
"label": "组4CSS样式",
"inherits": "group1style",
"description": "数值可以一直延伸"
},
"list4style": {
"label": "列表4CSS样式",
"inherits": "list1style",
"description": "数值可以一直延伸。"
},
"group4": {
"label": "组4",
"inherits": "group1",
"description": "显示在对应列表区域(listn)左侧,作为其描述/标题的文本。数值可以一直延伸。"
},
"list4": {
"label": "列表4",
"inherits": "list1",
"description": "导航盒的列表区域,一般是一些链接。如果包含两个以上链接,则应使用wikitext无序列表来列出每个链接。如果没有对应的组(groupn),列表区域会使用整个导航盒的宽度,文本会居中显示。数值可以一直延伸。"
},
"image": {
"label": "图像",
"description": "显示在组/列表区域右侧的图像,使用标准wikitext图像语法",
"example": "[[File:Exaple.png|80px]]",
"type": "line"
},
"imageleft": {
"label": "左侧图像",
"inherits": "image",
"description": "显示在组/列表区域左侧的图像,使用标准wikitext图像语法。"
},
"above": {
"label": "顶栏",
"description": "标题下的一整行内容,可以放导航盒信息、相关链接之类的。",
"type": "content"
},
"below": {
"label": "底栏",
"description": "导航盒最底部的一行内容,可以放相关链接啥的。",
"type": "content"
}
}
}
}
</templatedata>
</templatedata>
== 脚注 ==

2025年2月21日 (五) 21:19的版本

Navbox模板是wiki标准的导航模板。在模板中填入链接列表可相对快速地创建导航盒。模板附带了通用的默认样式,也可以更改默认样式。创建导航盒时,强烈推荐使用此模板来创建易于修改、使用的标准导航盒。

简单导航盒模板

下方代码是一个导航盒模板的初始源码,留空的参数应移除。

{{Navbox
| name = {{subst:PAGENAME}}{{subst:void|不要更改此行。在保存编辑时,它会自动修改}}
| title =
| state = {{{state|}}}

| listclass = hlist

| above =
| image =

| group1 =
| list1 =
| group2 =
| list2 =
| group3 =
| list3 =

<!-- ... -->

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

常用参数

模板使用小写参数名。“name”和“title”参数是必需的,如果没有另外设置参数,就会创建一个单行的盒子。

groupn”(等)和“above”/“below”是可选的。

常用参数如下(后面有完整的参数列表):

  • name——模板名。
  • title——标题栏的标题。
  • state——控制导航盒折叠状态。
  • listclass——列表单元格的CSS类,一般填“hlist”,以此创建水平列表。
  • above——导航盒顶栏,即链接列表前面一行的文本。(可以放概览链接啥的)
  • image——导航盒右侧的可选图像,使用完整的wikitext图像语法,例如:[[File:Example.png|80px|alt=替代文本]]
  • imageleft——导航盒左侧的可选图像,用法和image参数相同。
  • groupn——链接列表的标题,显示在list-n前的文本。如果不给list-n设置对应的group-n,list-n单元格会扩展到导航盒边缘,并且文本会居中对齐。
  • listn——相关链接列表,使用标准wikitext列表语法。
  • below——导航盒底栏,即链接列表后面一行的文本。(可以放相关链接啥的)

所有参数

下方列出了Navbox模板的完整参数列表。多数情况下,只有nametitlelist1是必需的,子导航盒中,name和title也不是必需的。

初始化参数

name

模板名,用来设置“查论编”链接所对应的页面。可以使用{{subst:PAGENAME}}作为参数值。只有在设置了title参数,未设置border参数,未使用navbar参数禁用此链接时,此参数才有作用。

state

设置导航盒折叠状态。可用的值有autocollapsecollapsedexpandedplainoff

默认值为autocollapse。如果页面内有多于1个可折叠元素,那么导航盒默认折叠。否则默认展开。

如果设置为collapsed,导航盒默认折叠。

如果设置为expanded,导航盒默认展开。

如果设置为plain,导航盒默认展开,标题栏右侧不会有“[隐藏]”链接。

如果设置为off,导航盒默认展开,标题栏右侧不会有“[隐藏]”链接。不同于plain,此时不会给标题添加保持标题居中的边距。这是高级用法。一般情况下,如果不想显示“[隐藏]”链接,用plain就可以了。

如果要在模板页保持展开(用于展示),但在使用导航盒时让它自动调整折叠状态,可将expanded包含在<noinclude>…</noinclude>标签中:

| state = <noinclude>expanded</noinclude>

很多时候编者希望设置默认折叠状态,使用模板时又可以覆写默认状态。可以将state参数传递给用户,并设置默认值:

| state = {{{state|collapsed}}}

设置导航栏(“查·论·编”链接)显示状态。如果设置为plain,标题栏左侧“查论编”链接不会显示。设置为off也会移除导航栏,但不会给标题添加保持标题居中的边距。这是高级用法。一般情况下,隐藏导航栏用plain就可以了。不建议隐藏导航栏,便于用户编辑模板。

border

设置导航栏边框状态。如果设置为childsubgroup,导航盒会使用无边框的,适用于嵌入到另一个导航盒内的变体。边框隐藏,盒子两侧不会有边距,这样就适合放在导航盒的list部分。如果设置为none,就会变成适合嵌入到其他容器的变体。只在嵌入到其他导航盒时使用subgroup选项,none选项适用于其他情况。默认情况下(不设置或设置为其他值),导航盒会有1像素的边框。参数的另一种设置风格(使用不具名参数代替border参数):

{{Navbox|child
……
}}

内容参数

title

导航盒的标题,居中显示在第一行的文本。标题一般需要描述导航盒是关于啥的。导航盒应该有个标题,除非它嵌入到了其他模板中。

above

导航盒的顶栏,即标题和主体(group、list、……)的间的一行内容。

group

参数名:groupn,即group1、group2、……

导航盒的组,是作为表头显示在对应列表(list)左侧的文本。没有对应group的list会占用一整行空间。

list

参数名:listn,即list1、list2、……

导航盒的列表,主要内容放在这里面,通常是链接列表。一般是一行,但使用<div>…</div>包裹不同内容可以实现多行。导航盒至少要有一个list(即list1);每个list都会显示在不同行中。可以每个list设置相关的group,group会作为表头显示在list前。

list使用wikitext无序列表语法,每一项都应占一行,并以星号(*)打头。使用多个星号打头时,项会显示在括号内。只有一项时就可以不用列表,直接写链接。

将参数设置为child或subgroup,可指示此list是用于内联的#子导航盒

image

显示在导航盒内容右侧的图像。参数接受标准的wikitext图像语法。例如:

[[File:Example.png|80px|link=|alt=]]

imageleft

显示在导航盒内容左侧的图像。参数接受标准的wikitext图像语法。例如:

below

导航盒底栏,即显示在导航盒主体(group、list、……)下的一行内容。

样式参数

不推荐style类参数更改样式(主要是导航盒配色)。使用模板样式能够更灵活地调整样式,并提供多皮肤支持。

bodystyle

应用到整个导航盒的CSS样式。此参数可能会导致视觉上的不一致,请小心使用。例子:

  • bodystyle = background-color: #rrggbb;
  • bodystyle = clear: both;

innerstyle

应用到导航盒内部表格区域的CSS样式。导航盒最外侧有个包裹层,边框、基本背景色都在这里设置。包裹层内部是个表格,内容都位于表格中。“bodystyle”设置的是包裹层的样式,一般表格会继承包裹层样式。复杂导航盒可能需要单独更改表格区域的CSS样式,于是有了这个参数。

basestyle

应用到标题、顶栏、组和底栏区域的CSS样式,不会应用到list单元格。使用此样式可以方便地更改导航盒的基础颜色,不必再重复设置导航盒各部分的颜色。例如:basestyle = background-color: lightskyblue;

titlestyle

应用到标题一行的CSS样式,一般用来调整背景色:basestyle = background-color: navy; color: white;

groupstyle

应用到组区域的CSS样式。会覆盖先前为整个导航盒设置的样式。

groupnstyle

参数名:groupnstyle,即group1style、group2style……

应用到指定组的CSS样式。不会替换先前为所有组设置的样式(groupstyle)。使用场景很少。

groupwidth

“groupwidth”可为组设置统一的宽度。如果组的宽度很奇怪,可以调整此参数。会被“groupnstyle”覆盖。

liststyle

应用到列表区域的CSS样式。

listnstyle

参数名:listnstyle,即list1style、list2style……

应用到指定列表的CSS样式。不会替换先前为所有列表设置的样式(liststyle)。使用场景很少。

listpadding

所有列表单元格的内边距,是一个带长度单位的数组。列表默认有0.25em的左右内边距,没有上下内边距。由于复杂的技术原因,像“listpadding = 0.5em”这样的值是无效的。例子:

  • bodystyle = 0.5em 0——将上下内边距设置为0.5em,左右内边距设置为0。
  • listpadding = 0——移除内边距。

oddstyle、evenstyle

设置应用到奇数行(oddstyle)/偶数行(evenstyle)列表区域的CSS样式。不会替换先前为所有列表设置的样式(liststyle)。导航盒列表背景色默认是条纹色的(透明和浅灰,由于导航盒背景是白色的,所以透明色会是白色),这样易认性更好。

evenodd

设置列表的奇偶行处理方式,可用值有“swap”“odd”“even”“off”。

奇数行列表默认背景色是透明,偶数行是浅灰。如果设置为“swap”,会翻转奇偶行的背景色:奇数行是浅灰,偶数行是透明。设置“odd”(奇)或“even”(偶)会让所有列表单元格都使用对应类型的背景色,设置为“off”会停用颜色翻转。

abovestyle、belowstyle

应用到顶栏(above)或底栏(below)的CSS样式。

imagestyle、imageleftstyle

应用到图像(image)或左侧图像(imageleft)区域的CSS样式。通常用来修复图像过大的问题。例子:iamgestyle = max-width: 80px;

默认样式

下面是编者经常会更改的CSS样式。其他复杂样式已被略去。大部分样式放在Module:Navbox/styles.css里。

.navbox { /* bodystyle */
  width: 100%;
  background-color: #fdfdfd;
  vertical-align: center;
}

.navbox-title { /* titlestyle */
  padding-left: 1em;
  padding-right: 1em;
  background-color: #ccccff;
  text-align: center;
}

.navbox-abovebelow { /* abovestyle, belowstyle */
  padding-left: 1em;
  padding-right: 1em;
  background-color: #ddddff;
  text-align: center;
}

.navbox-group { /* groupstyle */
  padding-left: 1em;
  padding-right: 1em;
  background-color: #ddddff;
}

.navbox-list { /* liststyle */
  text-align: center;
}

.navbox-list-with-group { /* 有对应组的列表 */
  text-align: left;
}

.navbox-even { /* evenstyle */
  background-color: #f7f7f7;
}

.navbox-odd { /* oddstyle */
  background-color: transparent;
}

HTML类参数

包括“navboxclass”整个导航盒、“bodyclass”表格区域、“titleclass”标题栏、“aboveclass”顶栏、“groupclass”组、“listclass”列表、“belowclass”底栏。这些参数可以为导航盒及其特定区域附加HTML类。最常用的参数是“listclass”和“navboxclass”。

“listclass”一般设置为“hlist”,使列表以水平模式显示。如果其他区域也需要使用水平列表,可以将bodyclass设置为“hlist”。

“navboxclass”用来给整个导航盒添加类,需要设置一个模板中独一无二的类,如此,使用模板样式附加CSS样式时,模板样式就不会应用到导航盒外的区域。

微格式

导航盒支持微格式。通过为各区域附加特殊的HTML类可以创建微格式结构。如果希望给模板附加微格式,官方网站上有微格式入门,相关类可以参考词汇表。例子:

{{Navbox
  | name = 零洲共鸣地标
  | navboxclass = template-zth_landmarks h-card

  | title = <span class="p-name">零洲</span>共鸣地标列表
  ……
}}

模板样式参数

模板样式参数用来设置附加到导航盒的模板样式表。比起使用style类参数,模板样式更为灵活,并能提供多皮肤支持。

“templatestyles”是应用到当前导航盒的样式表。“chlid templatestyles”参数可传递给衍生出的导航盒,衍生导航盒可用此参数设置自己的样式表。

模板样式使用示例

下面的代码将为导航盒附加样式表“Template:导航盒模板样式示例/styles.css”:

{{Navbox
  | name = {{subst:PAGENAME}}
  | title = 导航盒模板样式示例
  | navboxclass = template-navbox_doc_exts1 <!-- 设置独一无二的HTML类,确保模板样式不会作用于导航盒以外的部分 -->
  | templatestyles = Template:导航盒模板样式示例/styles.css

  内容部分……
}}

“child templatestyles”使用示例:

原导航盒,名为“VV列表”:

{{Navbox
  | name = {{{name|{{subst:PAGENAME}}}}}
  | title = {{{title|VV列表}}}
  | navboxclass = template-vv_list {{{navboxclass|}}}
  | templatestyles = Template:VV列表/styles.css
  | child templatestyles = {{{child templatestyles|}}}

  内容部分……
}}

衍生导航盒,名为“扩展VV列表”:

{{VV列表
  | name = {{subst:PAGENAME}}
  | title = VV列表
  | navboxclass = template-vv_list_expanded
  | child templatestyles = Template:扩展VV列表/styles.css

  内容部分……
}}

“扩展VV列表”在挂载“Template:VV列表/styles.css”外,也会挂载“Template:扩展VV列表/styles.css”。后一样式表位于后面,于是可以层叠

导航盒样式表

零洲共鸣地标的样式表,更改了标题、顶底栏、组、条纹背景色:

.template-zth_landmarks .navbox-title { /* 标题 */
  background-color: rgb(255, 175, 175);
}

.template-zth_landmarks .navbox-group { /* 组 */
  background-color: rgb(255, 207, 207);
}

.template-zth_landmarks .navbox-abovebelow { /* 顶/底栏 */
  background-color: rgb(255, 207, 207);
}

.template-zth_landmarks .navbox-even { /* 偶数行 */
  background-color: rgb(255, 240, 240);
}

高级参数

将“nowraplinks”设置为“yes”将为列表区域和顶底栏的每个列表项添加“nowrap”类,用来阻止链接内断行。可能有链接过长,一般链接是要断行的。

orphan

在子导航盒中将“orphan”设置为“yes”对于修复条纹背景色可能有帮助。此外,设置此参数还会将导航盒从Category:孤立导航盒中移除。

示例

一般导航盒

组/列表成对。

{{Navbox
  | name = Navbox/doc
  | state = {{{state|}}}
  | navboxclass = template-navbox_doc_ex1
  | listclass = hlist

  | title = 零洲共鸣地标(1—21号)

  | group1 = 1—5
  | list1 =
* [[鳕鱼贫鸟居]]
* [[鳕鱼神社]]
* [[南海鸟居]]
* [[星海镇]]
* [[光圈科技]]
  | group2 = 6—10
  | list2 =
* [[幽灵岛]]
* [[Sigma]]
* [[莉亚匹克]]
* [[七宫]]
* [[云之彼端]]
  | group3 = 11—15
  | list3 =
* [[冰与火刷怪装置]]
* [[海央末地岛]]
* [[北溟神社]]
* [[水结冰]]
* [[ChinaMobby ELT.|ChinaMobby]]
  | group4 = 16—20
  | list4 =
* [[双子湖神社]]
* [[萝萝村]]
* [[神海阁]]
* [[赤朱之心]]
* [[紫金山庄]]
  | group5 = 21号及以上
  | list5 = [[风吟之地]](一行只有一个链接时无需使用无序列表,即标前面的星号“*”)
}}

有图像、顶栏和底栏

图像显示在右侧,宽度过时低会隐藏。

{{Navbox
  | name = Navbox/doc
  | state = {{{state|}}}
  | navboxclass = template-navbox_doc_ex2
  | bodyclass = hlist

  | title = 零洲共鸣地标(1—21号)
  | above = 共鸣地标实质上是服务器中的传送点

  | image   = [[File:鸟居图标新.png|80px|link=|alt=]]

  | group1 = 1—5
  | list1 =
* [[鳕鱼贫鸟居]]
* [[鳕鱼神社]]
* [[南海鸟居]]
* [[星海镇]]
* [[光圈科技]]
  | group2 = 6—10
  | list2 =
* [[幽灵岛]]
* [[Sigma]]
* [[莉亚匹克]]
* [[七宫]]
* [[云之彼端]]
  | group3 = 11—15
  | list3 =
* [[冰与火刷怪装置]]
* [[海央末地岛]]
* [[北溟神社]]
* [[水结冰]]
* [[ChinaMobby ELT.|ChinaMobby]]
  | group4 = 16—20
  | list4 =
* [[双子湖神社]]
* [[萝萝村]]
* [[神海阁]]
* [[赤朱之心]]
* [[紫金山庄]]
  | group5 = 21号及以上
  | list5 =
[[风吟之地]]

  | below =
* 我是相关链接
* [[Template:零洲共鸣地标|]]
** [[Template:零洲共鸣地标|21—40]]
** [[Template:零洲共鸣地标|41—60]]
** ……
}}

很简单的导航盒

在只有几个链接时,可以使用这种导航盒。

{{Navbox
  | name = Navbox/doc
  | state = {{{state|}}}
  | navboxclass = template-navbox_doc_ex3
  | listclass = hlist

  | title = 莉亚迷你社博

  | list1 =
* [[第一届莉亚迷你社博·莱茵|莱茵 #1]]
* [[第二届莉亚迷你社博·湛蓝の遥阔★|湛蓝の遥阔★ #2]]
* [[第三届莉亚迷你社博·佛蒙特-秋山|佛蒙特-秋山 #3]]
* [[第四届莉亚迷你社博·滨海新区|滨海新区 #4]]

  | below = 我是相关链接
}}

子导航盒

可以在导航盒中放子导航盒。子导航盒可以由特殊代码生成,也可以直接嵌套标准导航盒代码。使用后一种方法的话,模板展开后长度会大很多。

如果选用特殊代码,需要将“listn”设置为“child”或“subgroup”。子导航盒元素可以通过在普通参数名前添加“childn_”“subgroupn_”n_”设置(例如“child1_list1”或“1_list1”)。在这些参数名前继续附加前缀可继续嵌套导航盒(例如“child1_child1_list1”或“1_1_list1”)。下面是基本示例代码(子导航盒位于第1个组/列表区域):

{{Navbox
  | name = {{subst:PAGENAME}}
  | title = 子导航盒示例
  | class = template-navbox_doc_ex4

  | group1 = 组1
  | list1 = child
    | 1_title = 子盒1

    | 1_group1 = 组1.1
    | 1_list1 = child
      | 1_1_group1 = 组1.1.1
      | 1_1_list1 = 列表1.1.1
      ……
    | 1_group2 = 组1.2
    | 1_list2 = 列表1.2
    ……
  | group2 = 组2
  | list2 = 列表2
  ……
}}

如果选用嵌套导航盒,需要将子导航盒的第1个不具名参数或“border”参数设置为“child”或“subgroup”。下面是基本示例代码(子导航盒位于第1个组/列表区域):

{{Navbox
  | name = {{subst:PAGENAME}}
  | title = 子导航盒示例
  | class = template-navbox_doc_ex5

  | group1 = [optional]
  | list1  = {{Navbox|child
    子导航盒参数……
  }}
  ……
}}

子导航盒示例

下例导航盒有两个子导航盒和一个孙导航盒,由关键字“child”和“subgroup”(可互换)创建。条纹是自动生成的。如需移除所有条纹,可将.navbox-subgroupbackground-colorCSS属性设置为initial

技术细节

  • “查·论·编”链接由Template:Navbar生成。
  • 组与列表间2px宽的间隙是用列表单元格的“border-left”CSS属性生成的。如果希望更改导航盒背景色(如bodystyle = background-color: coral;),则可能需让“border-left-color”与其匹配(即liststyle = border-left-color: coral;)。如果希望给列表区域添加边框,间隙会消失,请自行探索解决办法(或者不要那个间隙了)。
  • 相邻导航盒间的边框会合并,上下导航盒间只有1px宽边框。如果设置了外边距,边框就不能合并了。
  • 导航盒最外层容器的左右外边距默认为“auto”。如果希望以浮动形式显示导航盒,则需手动设置“margin-left”和“margin-right”,因为默认的“auto”会影响浮动。下例是浮动导航盒样式代码的示例:
    bodystyle = max-width: 22em; float: right; margin-left: 1em; margin-right: 0;
  • 导航盒模板大大增加了页面的模板展开后长度,严重时可导致页面超过大小限制,影响内容显示。有一些改善方法:
    • 可将{{Navbox}}替换为{{#invoke:Navbox|navbox}},大概可以将展开后长度减半。
    • 在导航盒中嵌套模板可使展开后长度增加数倍。使用#子导航盒一节所述的行内子盒语法可在一定程度上降低影响。

复制到其他wiki

如果希望在其他wiki上使用Navbox模板,需要有以下前提:

模板数据

这是用于新版可视化编辑器及其他工具的模板数据文档。

Navbox模板数据

本模板可以通过提供链接列表相对快速地创建导航盒。

模板参数

此模板首选参数换行的代码块格式。

参数描述类型状态
边框样式border 1

设置为“child”(等同于“subgroup”)会调整导航盒,使其适合作为子组嵌入到其他导航盒中;设置为“none”则适合嵌入到其他非导航盒模板中。

推荐值
child subgroup off
单行文本可选
模板名name

模板页面名,用来设置“查·论·编”链接。可以使用{{subst:PAGENAME}}作为参数值。

默认值
{{subst:PAGENAME}}
页面名称推荐
折叠状态state

导航框的折叠状态。默认为根据页面中折叠元素数量自动判断,“expanded”为默认展开,“collapsed”为默认折叠。

推荐值
autocollapse expanded collapsed plain off
默认值
autocollapse
单行文本可选
导航栏显示状态navbar

[plain | none] 如果设置为“plain”,标题栏左侧的“查·论·编”导航栏不会显示,导航盒标题保持居中。为便于用户编辑,一般不建议隐藏导航栏。

推荐值
plain off
单行文本可选
项不断行nowrapitems

“yes”会为列表项应用“nowrap”类,以阻止断行。

布尔可选
orphanorphan

无描述

布尔可选
模板样式templatestyles

附加到导航和的模板样式表

推荐值
Template:{{subst:ROOTPAGENAME}}/styles.css
页面名称可选
子模板样式child templatestyles

传递给衍生导航盒的模板样式。衍生导航盒可以使用此参数来在本体外附加自己的样式表。

推荐值
{{{child templatestyles|}}} Template:{{subst:ROOTPAGENAME}}/styles.css
单行文本可选
导航盒类navboxclass

附加到导航盒最外部元素的HTML类

单行文本推荐
主体类bodyclass

附加到导航盒表格元素的HTML类

单行文本可选
标题类titleclass

附加到标题栏的HTML类

单行文本可选
顶栏类aboveclass

附加到顶栏的HTML类

单行文本可选
底栏类belowclass

附加到底栏的HTML类

单行文本可选
组类groupclass

附加到所有组的HTML类

单行文本可选
列表类listclass

附加到所有列表区域的HTML类,一般包含“hlist”,用来设置水平列表。

推荐值
hlist
单行文本推荐
主体CSS样式bodystyle

指定应用到导航盒主体的CSS样式

单行文本可选
基本CSS样式basestyle

应用到标题、顶/底栏、组的CSS样式

单行文本可选
标题栏CSS样式titlestyle

无描述

单行文本可选
顶栏CSS样式abovestyle

无描述

单行文本可选
底栏CSS样式belowstyle

无描述

单行文本可选
组CSS样式groupstyle

应用到所有组区域的CSS样式

单行文本可选
组单元格宽度groupwidth

设置组区域的宽度,要带单位

示例值
8em
单行文本可选
列表区域CSS样式liststyle

应用到所有列表区域的CSS样式

单行文本可选
列表区域内边距listpadding

设置所有列表区域的内边距,使用标准CSS边距值。

单行文本可选
奇数列表行CSS样式oddstyle

作用于奇数列表行的CSS样式。覆盖由“liststyle”定义的样式。

单行文本可选
偶数列表行CSS样式evenstyle

作用于偶数列表行的CSS样式。覆盖由“liststyle”定义的样式。

单行文本可选
evenoddevenodd

“swap”会翻转奇偶行的条纹背景色;“even”和“odd”会使所有行使用相对应的背景颜色(全用偶行背景色或奇行背景色);“off”会禁用条纹背景色。

推荐值
swap even odd off
单行文本可选
图像区域CSS样式imagestyle

应用于右侧图像区域的CSS样式

单行文本可选
左侧图像单元格的CSS样式imageleftstyle

无描述

单行文本可选
标题title

居中显示在导航盒首行的标题

单行文本推荐
组1CSS样式group1style

无描述

单行文本可选
列表1CSS样式list1style

无描述

单行文本可选
组1group1

显示在对应列表区域(listn)左侧,作为其描述/标题的文本。

单行文本可选
列表1list1

导航盒的列表区域,一般是一些链接。如果包含两个以上链接,则应使用wikitext无序列表来列出每个链接。如果没有对应的组(groupn),列表区域会使用整个导航盒的宽度,文本会居中显示。

内容推荐
组2CSS样式group2style

无描述

单行文本可选
列表2CSS样式list2style

无描述

单行文本可选
组2group2

显示在对应列表区域(listn)左侧,作为其描述/标题的文本。

单行文本可选
列表2list2

导航盒的列表区域,一般是一些链接。如果包含两个以上链接,则应使用wikitext无序列表来列出每个链接。如果没有对应的组(groupn),列表区域会使用整个导航盒的宽度,文本会居中显示。

内容推荐
组3CSS样式group3style

无描述

单行文本可选
列表3CSS样式list3style

无描述

单行文本可选
组3group3

显示在对应列表区域(listn)左侧,作为其描述/标题的文本。

单行文本可选
列表3list3

导航盒的列表区域,一般是一些链接。如果包含两个以上链接,则应使用wikitext无序列表来列出每个链接。如果没有对应的组(groupn),列表区域会使用整个导航盒的宽度,文本会居中显示。

内容推荐
组4CSS样式group4style

数值可以一直延伸

单行文本可选
列表4CSS样式list4style

数值可以一直延伸。

单行文本可选
组4group4

显示在对应列表区域(listn)左侧,作为其描述/标题的文本。数值可以一直延伸。

单行文本可选
列表4list4

导航盒的列表区域,一般是一些链接。如果包含两个以上链接,则应使用wikitext无序列表来列出每个链接。如果没有对应的组(groupn),列表区域会使用整个导航盒的宽度,文本会居中显示。数值可以一直延伸。

内容推荐
图像image

显示在组/列表区域右侧的图像,使用标准wikitext图像语法

示例值
[[File:Exaple.png|80px]]
单行文本可选
左侧图像imageleft

显示在组/列表区域左侧的图像,使用标准wikitext图像语法。

示例值
[[File:Exaple.png|80px]]
单行文本可选
顶栏above

标题下的一整行内容,可以放导航盒信息、相关链接之类的。

内容可选
底栏below

导航盒最底部的一行内容,可以放相关链接啥的。

内容可选