查看“︁模板:Navbox/doc”︁的源代码

== 用法 ==
使用此模板可以相对方便和快速地归纳同类型条目去创作一个导航模版

可变参数十分多

Navbox大部份效果都不常用，所以将一般参数封装成大家族模板


详细使用方法见：http://zh.wikipedia.org/wiki/Template:Navbox



==用法==
请移除置空不用的参数。
<pre>{{Navbox
|state = autocollapse <!--autocollapse、uncollapsed、collapsed、plain、off--><!--
|name  ={{subst:PAGENAME}}
|title =
|image =
|above =
|abovestyle =
|listclass = hlist
|group1 =
| list1 =
|group2 =
| list2 =

……
|group20 =
| list20 =
|belowstyle =
|below=
}}</pre>

==参数列表==
{{Navbox
|name = Navbox/doc
|state = uncollapsed
|image = {{{image}}}
|title = {{{title}}}
|above = {{{above}}}
|group1 = {{{group1}}}
|list1 = {{{list1}}}
|group2 = {{{group2}}}
|list2 = {{{list2}}}
|list3 = {{{list3}}}''不带{{{group3}}}''
|group4 = {{{group4}}}
|list4 = {{{list4}}}
|below = {{{below}}}<br/><!--
}}
Navbox使用小写的参数名称，如上面框中所示。如果省略其它参数，必需的''name''和''title''会创建一个单行方框。

请注意“group1”（等等）是可选的，命名为“above/below”的部分也是可选的。

基本的和最常见的参数如下所示（参见下方查看完整的列表）：
<!--
The navbox uses lowercase parameter names, as shown in the box (''at right'').  The mandatory ''name'' and ''title'' will create a one-line box if other parameters are omitted.
<br/>

Notice "group1" (etc.) is optional, as are sections named "above/below".
{{brClear}}
The basic and most common parameters are as follows (see below for the full list):
-->
:<code>name - </code>模板的名称（“Template:”后面的部分，注意不是模板的标题）。<!--  the name of the template. -->
:<code>title - </code>标题栏的文字，像<nowiki>[[化学分支]]</nowiki>。<!--  text in the title bar, such as: <nowiki>[[Widget stuff]]</nowiki>. -->
:<code>state - mw-uncollapsed、mw-collapsed</code>：方框的折叠状态。<!-- : the status of box expansion, where "autocollapse" hides stacked navboxes automatically. -->

:<code>titlestyle - </code>一个用于标题栏的CSS样式，像：<!-- a CSS style for the title-bar, such as:  --><code>background:gray;</code>
:<code>groupstyle - </code>一个用于分组单元格的CSS样式，像：<!-- a CSS style for the group-cells, such as:  --><code>background:#eee;</code>

:<code>image - </code>一个可选的置于右侧的图片（以完整的image标签的形式编码：<nowiki>[[File:XX.jpg|90px]]</nowiki>）。<!-- an optional right-side image (coded as the whole image tag:  ). -->
:<code>imageleft - </code>一个可选的置于左侧的图片（编码方式与“image”参数相同）。<!-- an optional left-side image (code the same was as the "image" parameter). -->

:<code>above - </code>在group/list区段之上显示的文字（可能是一栏综合的维基链接）。<!-- text to appear above the group/lst section (could be a list of overall wikilinks). -->

:<code>group<sub>n</sub> - </code>左侧的文字，在list-n之前（如果group-n被省略，list-n从方框的左侧开始）。<!-- the left-side text before list-n (if group-n omitted, list-n starts at left of box). -->
:<code>list<sub>n</sub> - </code>列出维基链接的文字，通常以圆点符号模板分隔开来，像：<!-- text listing wikilinks, often separated by middot templates, such as:  -->[<nowiki/>[A]]<code>{<nowiki/>{•}}</code> [<nowiki/>[B]]
:<code>below - </code>在group/list区段之下显示的可选文字。<!-- optional text to appear below the group/list section. --


=== 设置参数 ===
:; ''name''<sup>†</sup>
::模板的名称。你可以输入<code><nowiki>{{subst:PAGENAME}}</nowiki></code>作为这个参数的值，这也是个快捷的方法。此参数是必需的。<!-- 仅当<code>title</code>被指定，且<code>border</code>参数未被设置时，此name参数才是必需的。 -->
:; ''state''<sup>†</sup> <span style="font-weight:normal;">[<code>mw-uncollapsed、mw-collapsed、plain、off</code>]</span>
<!--:*缺省为<code>autocollapse</code>。如果在使用了其它可折叠表格的同一个页面上有两个或更多表格，那么该页面上的带<code>autocollapse</code>的导航框一开始就会折叠起来。否则，该导航框会被展开。要了解技术上的实现，请参见[[MediaWiki:Common.js]]。-->
:*如果设置为<code>mw-collapsed</code>，该导航框总会在开始时以折叠起来的状态展现。
:*如果设置为<code>plain</code>，该导航框总会在被展开时不带右侧的“隐藏”链接，并且标题会保持居中（通过使用补白来偏移<small>查 • 论 • 编 • 历</small>链接）。
:*如果设置为<code>off</code>，该导航框总会在被展开时不带右侧的“隐藏”链接，但是没有补白会被用来保持标题居中。这只是为了高级用法；“plain”选项应能满足大多数需要将“显示”/“隐藏”按钮隐藏起来的应用。
:*如果设置为除<code>mw-collapsed</code>、<code>plain</code>或<code>off</code>之外的其它值（像“mw-uncollapsed”），该导航框总会在开始时以展开的状态出现，但是带有“隐藏”按钮。
<!--:若要在独处（未被包含）时显示框体，而在一个条目中时自动隐藏内容，可以将 “uncollapsed ”置于<noinclude>标签之内：
:* <code>state = </code><nowiki><noinclude>uncollapsed</noinclude></nowiki>
:*如此设置会强制框体在单独出现时（甚至是后面有其它导航框时）展开，显示“隐藏”按钮，而当被堆叠在一个条目中时自动折叠框体。-->
:很多时候，对于一个导航框，编辑者会想要一个缺省的初始状态，并且在条目中它可以被覆写。要做到这一点，这里有个窍门：
:在你的居间模板里，创建一个参数也命名为“state”作为一个传递，像这样：
:*<tt><nowiki>| state = {{{state<includeonly>|你想要的初始状态</includeonly>}}}</nowiki></tt>
:*<nowiki><includeonly>|</nowiki>会使得当查看模板页面本身时，模板会被展开。
<!--::*示例：<nowiki>{{</nowiki>[[Template:土星的卫星|土星的卫星]]<nowiki>}}</nowiki>带autocollapse作为其缺省的初始状态。条目[[土卫三十五]]嵌入包含了它，并且只有一个导航框架。因此该页面的“土星的卫星”导航框显示了出来。条目[[土卫一]]有两个导航框。因此该页面的“土星的卫星”导航框折叠了起来。另外，也可以在条目中使用带state参数的引用形式（如<nowiki>{{土星的卫星|state=collapsed}}</nowiki>）来覆写其折叠状态。
::*示例：<nowiki>{{</nowiki>[[Template:阿拉伯语言|阿拉伯语言]]<nowiki>}}</nowiki>带expanded作为其缺省的初始状态。所有嵌入包含它的条目缺省情况下会显示其内容，除非有一个假定的条目在嵌入包含它时指定了state = collapsed。-->
:; ''navbar''<sup>†</sup>
::缺省为<code>Navbar</code>。如果设置为<code>plain</code>，在标题栏左侧的<small>查 • 论 • 编</small>链接不会显示出来，而且补白会被自动应用以保持标题居中。设置为<code>off</code>可以移除<small>查 • 论 • 编</small>链接，但是不会应用补白（这只是为了高级用法；“plain”选项应能满足大多数不想要导航栏的应用。）强烈建议使用者不要隐藏导航栏，为的是使用户编辑该模板更加容易，并且可以贯穿各个页面都有一个标准的风格。
<!--
中文模板目前不支持此参数。2008-10-23
:; ''border''<sup>†</sup>
::''关于将导航框用在另一个导航框内部，欲了解示例及更完整的描述，请参见下面的章节。''如果设置为<code>child</code>或<code>subgroup</code>，那么该导航框能够被用作一个无边框的子导航框。其边框被隐藏并且在表格的边上没有补白，因此它能很好地放进它的父导航框的list区域。如果设置为<code>none</code>，那么

:: ''See section below on using navboxes within one another for examples and a more complete description.''  If set to <code>child</code> or <code>subgroup</code>, then the navbox can be used as a borderless child that fits snuggly in another navbox.  The border is hidden and there is no padding on the sides of the table, so it fits into the ''list'' area of its parent navbox.  If set to <code>none</code>, then the border is hidden and padding is removed, and the navbox may be used as a child of another container (do not use the <code>none</code> option inside of another navbox; similarly, only use the <code>child</code>/<code>subgroup</code> option inside of another navbox).  If set to anything else (default), then a regular navbox is displayed with a 1px border.  An alternate way to specify the border to be a subgroup style is like this (i.e. use the first unnamed parameter instead of the named ''border'' parameter):
:::<code><nowiki>{{Navbox|child</nowiki></code>
::::<code>...
:::<code><nowiki>}}</nowiki></code>
-->

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

=== 样式参数 ===
一般不建议更改样式，以保持维基百科中模板和网页的一致性。然而，修改样式的选项还是有的。
:; ''style''<sup>†</sup>
::指定应用到模板主体的CSS样式。''bodystyle''参数也有下面举例的同样效果，并能被用来代替这个''style''参数。此选项应谨慎使用，因为它可以导致视觉上的不一致。举例：
::: <code>style = background:#''nnnnnn'';</code>
::: <code>style = width:''N'' [em/%/px or width:auto];</code>
::: <code>style = float:[''left/right/none''];</code>
::: <code>style = clear:[''right/left/both/none''];</code>
<!-- 注释：中文模板目前尚不支持basestyle参数。2008-10-27
:; ''basestyle''<sup>†</sup>
::CSS样式，会同时应用到''title''、''above''、''below''和''group''单元格。该样式不会应用到''list''单元格。这就比较方便了，使得编辑者很容易改变导航框的基本颜色而无需重复去为该导航框的不同部分指定样式。举例：
--><!--
:: CSS styles to apply to the ''title'', ''above'', ''below'', and ''group'' cells all at once.  The style are not applied to ''list'' cells.  This is convenient for easily changing the basic color of the navbox without having to repeat the style specifications for the different parts of the navbox.  Examples:

::: <code>basestyle = background:lightskyblue;</code>
-->
:; ''titlestyle''<sup>†</sup>
::应用到''title''的CSS样式，最常见的有导航栏的背景颜色：
::: <code><nowiki>titlestyle = background:</nowiki>''#nnnnnn'';</code>
::: <code><nowiki>titlestyle = background:</nowiki>''name'';</code>

:; ''groupstyle''<sup>†</sup>
::应用到''groupN''单元格的CSS样式。该选项覆写应用于整个表格的任何样式。举例：
::: <code>groupstyle = background:#''nnnnnn'';</code>
::: <code>groupstyle = text-align:[''left/center/right''];</code>
::: <code>groupstyle = vertical-align:[''top/middle/bottom''];</code>
<!-- 中文模板目前不支持以下参数。2008-10-27
:; ''group<sub>n</sub>style''<sup>†</sup>
-->
:; ''liststyle''<sup>†</sup>
::应用到所有list的CSS样式。若指定了下面的''oddstyle''和''evenstyle''参数，则它们的优先级高于本参数。
<!-- 中文模板目前不支持以下参数。2008-10-27
:; ''list<sub>n</sub>style''<sup>†</sup>

:; ''listpadding''<sup>†</sup>
-->
:; ''oddstyle''
:; ''evenstyle''
::应用到奇数/偶数编号的列表。会推翻由''liststyle''定义的样式。缺省的表现是分别添加条纹状的颜色（白色和灰色）到奇数/偶数行，以提高可读性。除了在非常特别的情况下，这些设置不应更改。
<!--
::Applies to odd/even list numbers.  Overrules styles defined by ''liststyle''.  The default behavior is to add striped colors (white and gray) to odd/even rows, respectively, in order to improve readability.  These should not be changed except in extraordinary circumstances.
-->
<!-- 中文模板目前不支持以下参数。2008-10-29
:; ''evenodd'' <span style="font-weight:normal;"><code>[swap, even, odd, off]</code></span>
-->
:; ''abovestyle''<sup>†</sup>
:; ''belowstyle''<sup>†</sup>
::CSS样式，应用到顶端单元格（通过''above''参数指定）和底端单元格（通过''below''参数指定）。典型地被用来设置背景颜色或文本对齐方式：
::: <code>abovestyle = background:#''nnnnnn'';</code>
::: <code>abovestyle = text-align:[''left/center/right''];</code>
<!-- 中文模板目前不支持以下参数。2008-10-29
:; ''imagestyle''<sup>†</sup>
:; ''imageleftstyle''<sup>†</sup>
-->
===== 缺省样式 =====
这里列出的样式设置是使用导航框的编辑者最经常更改的那些设置。其它更加复杂的样式设置被排除在这个列表之外，以保持它简单。大多数样式是在[[MediaWiki:Common.css]]中设置。
:<code>bodystyle  = background:#fdfdfd; width:100%; vertical-align:middle;</code>
:<code>titlestyle = background:#ccccff; padding-left:1em; padding-right:1em; text-align:center;</code>
:<code>abovestyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;</code>
:<code>belowstyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;</code>
:<code>groupstyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:right;</code>
:<code>liststyle  = background:transparent; text-align:left/center;</code>
:<code>oddstyle   = background:transparent;</code>
:<code>evenstyle  = background:#f7f7f7;</code>

由于''liststyle''和''oddstyle''是透明的，奇数列表有''bodystyle''的颜色，其缺省值是#fdfdfd（白色带有少许灰色）。一个list有<code>text-align:left;</code>设定，如果它有一个group的话；否则，它有<code>text-align:center;</code>设定。由于只有''bodystyle''有一个垂直对齐（vertical-align）属性，所 有其它样式继承其<code>vertical-align:middle;</code>设定。

<!-- 中文模板目前不支持以下参数。2008-10-31
=== 高级参数 ===
:; ''titlegroup''
:; ''titlegroupstyle''
:; ''innerstyle''
-->

== 示例 ==
=== 不带图片 ===
<pre style="overflow:scroll;">
{{Navbox
|listclass=hlist
|name  = Navbox/doc
|title = [[珠海公交集团]]组织架构
|group1=分公司
|list1=<ul><li>[[香洲分公司]]</li><li>[[吉大分公司]]</li><li>[[斗门分公司]]</li><li>[[前山分公司]]</li></ul>
|group2=出租车
|list2=<ul><li>[[柏宁]]</li><li>[[柏安]]</li><li>[[柏顺]]</li></ul>
|group3=直属
|list3=[[营运部]]
}}</pre>

{{Navbox
|listclass=hlist
|name  = Navbox/doc
|title = [[珠海公交集团]]组织架构
|group1=分公司
|list1=<ul><li>[[香洲分公司]]</li><li>[[吉大分公司]]</li><li>[[斗门分公司]]</li><li>[[前山分公司]]</li></ul>
|group2=出租车
|list2=<ul><li>[[柏宁]]</li><li>[[柏安]]</li><li>[[柏顺]]</li></ul>
|group3=直属
|list3=[[营运部]]
}}

=== 带图片，不带分组 ===
<pre style="overflow:scroll;">
{{Navbox
|listclass=hlist
|name  = Navbox/doc
|title = [[珠海公交集团]]组织架构
|image=[[File:TU.png|80px]]
|group1=分公司
|list1=<ul><li>[[香洲分公司]]</li><li>[[吉大分公司]]</li><li>[[斗门分公司]]</li><li>[[前山分公司]]</li></ul>
|group2=出租车
|list2=<ul><li>[[柏宁]]</li><li>[[柏安]]</li><li>[[柏顺]]</li></ul>
|group3=直属
|list3=[[营运部]]
}}
</pre>
{{Navbox
|listclass=hlist
|name  = Navbox/doc
|title = [[珠海公交集团]]组织架构
|image=[[File:TU.png|80px]]
|group1=分公司
|list1=<ul><li>[[香洲分公司]]</li><li>[[吉大分公司]]</li><li>[[斗门分公司]]</li><li>[[前山分公司]]</li></ul>
|group2=出租车
|list2=<ul><li>[[柏宁]]</li><li>[[柏安]]</li><li>[[柏顺]]</li></ul>
|group3=直属
|list3=[[营运部]]
}}

=== 带两张图片，不带分组，多重列表 ===
<pre style="overflow:scroll;">
{{Navbox
|listclass=hlist
|name  = Navbox/doc
|title = [[珠海公交集团]]组织架构
|image=[[File:TU.png|80px]]
|imageleft=[[File:TU.png|80px]]
|list1=<ul><li>[香洲分公司]]</li><li>[[吉大分公司]]</li><li>[[斗门分公司]]</li><li>[[前山分公司]]</li></ul>
|list2=<ul><li>[[金湾分公司]]</li><li>[[红山维修厂]]</li><li>[[前山分公司]]</li><li>[[观光旅游分公司]]</li></ul>
|list3=[[珠海公交巴士有限公司]]
}}
</pre>
{{Navbox
|listclass=hlist
|name  = Navbox/doc
|title = [[珠海公交集团]]组织架构
|image=[[File:TU.png|80px]]
|imageleft=[[File:TU.png|80px]]
|list1=<ul><li>[[香洲分公司]]</li><li>[[吉大分公司]]</li><li>[[斗门分公司]]</li><li>[[前山分公司]]</li></ul>
|list2=<ul><li>[[金湾分公司]]</li><li>[[红山维修厂]]</li><li>[[前山分公司]]</li><li>[[观光旅游分公司]]</li></ul>
|list3=[[珠海公交巴士有限公司]]
}}

=== 带有图片、分组、上方注释、下方注释 ===
<pre style="overflow:scroll;">
{{Navbox
|listclass=hlist
|name  = Navbox/doc
|title =  [[珠海公交集团]]组织架构
|image=[[File:TU.png|80px]]
|above = （仅列出部分公司）
|group1=分公司
|list1=<ul><li>[[香洲分公司]]</li><li>[[吉大分公司]]</li><li>[[斗门分公司]]</li><li>[[前山分公司]]</li></ul>
|group2=出租车
|list2=<ul><li>[[柏宁]]</li><li>[[柏安]]</li><li>[[柏顺]]</li></ul>
|group3=直属
|list3=[[营运部]]
|below  = 《[[珠海公交集团]]》官网：https://www.zhgjjt.com/
}}
</pre>

{{Navbox
|listclass=hlist
|name  = Navbox/doc
|title =  [[珠海公交集团]]组织架构
|image=[[File:TU.png|80px]]
|above = （仅列出部分公司）
|group1=分公司
|list1=<ul><li>[[香洲分公司]]</li><li>[[吉大分公司]]</li><li>[[斗门分公司]]</li><li>[[前山分公司]]</li></ul>
|group2=出租车
|list2=<ul><li>[[柏宁]]</li><li>[[柏安]]</li><li>[[柏顺]]</li></ul>
|group3=直属
|list3=[[营运部]]
|below  = 《[[珠海公交集团]]》官网：https://www.zhgjjt.com/
}}


== 子导航框 ==

要在一个边框中放置多个导航框，可以使用''border''参数，或通过将第一个参数指定为“child”来实现。基本用法如下（为第一个组增加了一个子组）：

<pre style="overflow: auto;">
{{Navbox
| name = {{subst:PAGENAME}}
| title = Title
| group1 = [optional]
| list1  = {{Navbox|child
   ...child navbox parameters...
 }}

...
}}
</pre>

=== 子分组示例 ===

{{main|Template:Navbox subgroup}}

下面的示例展示了子分组的用法

{{Navbox
| name = Navbox/doc
| image = [[File:TU.png|100px|link=|alt=]]
| state = uncollapsed
| title = 子次级分组示例
| above = 上方文字
| below = 下方文字
| group1 = 分组1
| list1  = 列表1
| group2 = 分组2
| list2  =
 {{Navbox|child
  | evenodd = swap
  | group1 = 分组2.1
  | list1  = 列表1
  | group2 = 分组2.2
  | list2  = 列表2
  | group3 = 分组2.3
  | list3  = 列表3
 }}
| group3 = 分组3
| list3 = 列表3
| group4 = 分组4
| list4 =
 {{Navbox|child
  | evenodd = swap
  | group1 = 分组4.1
  | list1  = 列表1
  | group2 = 分组4.2
  | list2  = 列表2
  | group3 = 分组4.3
  | list3  = 列表3
 }}
}}



== 技术细节 ==
* 此模板为其大部分外观使用CSS类，因此它完全可以更换皮肤。
<!-- * 在内部此元模板使用了HTML标记代替 -->
<!--
*Internally this meta template uses HTML markup instead of wiki markup for the table code. That is the usual way we make meta templates since wiki markup has several drawbacks. For instance it makes it harder to use [[m:Help:ParserFunctions|parser functions]] and special characters in parameters.
-->

=== 运作详情 ===
* 列表单元格宽度初始被设置为100%。因此，如果你想手动设置分组单元格的宽度，你就需要同时指定liststyle使之有width:auto。如果你想设置分组宽度并使用图片，这取决于你已弄明白在groupstyle、liststyle、imagestyle和imageleftstyle参数中的CSS，以使所有部件都工作正常。以下两行是设置分组宽度的示例：
::<code>groupstyle = width:10em;</code>
::<code>liststyle = width:auto;</code>
*相邻的导航框在它们之间仅有一个1px的边框（除了在IE6中，因其不支持必需的CSS）。如果你设置了<code>style/bodystyle</code>的顶端外边距（top margin）或底顶端外边距（bottom margin），那么此特性就不运作了。
*外层导航框表格的缺省的左外边距（margin-left）和右外边距（margin-right）被设置为“auto;”。如果你想使用导航框作为一个浮动对象（float），你需要手动设置左外边距和右外边距的值，因为自动外边距（auto margins)会阻止浮动（float）选项。例如，添加下列代码来使用导航框作为一个浮动对象：
::<code>style = width:22em;float:right;margin-left:1em;margin-right:0em;</code>

[[分类:ZBC格式模板]]