跳到内容

User:Chronowar/sandbox3:修订间差异

删除2,001字节 、​ 2020年10月12日 (星期一)
无编辑摘要
无编辑摘要
无编辑摘要
第66行: 第66行:
}}
}}


==参数 列表==
==参数 描述==
以下是一个例子。
[[模板:Navbox|Navbox]]使用小写的参数名称。
{{Navbox
|name = Navbox/doc
|state = uncollapsed
|image = {{{image}}}
|title = {{{title}}}
|above = {{{above}}}
|group1 = {{{group1}}}
|list1 = {{{list1}}}
|group2 = {{{group2}}}
|list2 = {{{list2}}}
|list3 = {{{list3}}}
|group4 = {{{group4}}}
|list4 = {{{list4}}}
|below = {{{below}}}<!-- <br/>参见下方的其他替代导航格式:[[#表格布局|''表格布局'']]See alternate navbox formats under:[[#Layout of table|''Layout of table'']]  -->
}}
[[模板:Navbox|Navbox]]使用小写的参数名称 ,如上面框中所示


 如果省略其他参数,必需的<code>name</code>和<code>title</code>会创建一个单行方框。
 如果省略其他参数,必需的<code>name</code>和<code>title</code>会创建一个单行方框。
:其它的所有变量都是可选的。
:其它的所有变量都是可选的。


  基本 参数 方表格所示:
  下面是用于Navbox的 参数 的一个完整清单。在大多数情况 ,只要有参数<code>name</code>、<code>title</code>和几个<code>group</code>和<code>list</code>就可以了。
{| class="wikitable" style="text-align:center"
{| class="wikitable" style="text-align:center"
|-
|-
第95行: 第79行:
|-
|-
|<code>name</code>
|<code>name</code>
|该索引模板的名称(“模板:”后面的部分,注意不是模板的标题)。
|该索引模板的名称(“模板:”后面的部分,注意不是模板的标题)。 你可以输入<code><nowiki>{{subst:PAGENAME}}</nowiki></code>作为这个参数的值,这也是个快捷的方法。<!-- 事实上仅当<code>title</code>被指定,且<code>border</code>参数未被设置时,此name参数才是必需的,但是目前不支持border函数。 -->
|-
|-
|<code>title</code>
|<code>title</code>
|标题栏中的文字,例如<code><nowiki>[[Arcaea]]</nowiki></code>。
|标题栏中的文字, 作为主体内容的一个简要描述。 例如<code><nowiki>[[Arcaea]]</nowiki></code>
<ref>这应该是单独的一行,但是如果需要第二行,请使用<code><nowiki>{{brClear}}</nowiki></code>来保证正确的居中。</ref>本参数从技术上来说不是必需的,但是使用Navbox而不带标题是相当没有意义的
|-
|-
|<code>state</code>
|<code>state</code>
| 个状态 :autocollapse 、uncollapsed、collapsed<br />Navbox 的折叠状态, 基本语 参照表格class部分
| 个状态 :<code>autocollapse 、uncollapsed、collapsed 、plain、off</code><br />
缺省为<code>autocollapse</code>。如果在使用了其他可折叠表格 同一个页面上有两个或更多表格,那么navbox一开始就会 折叠 起来。<!--要了解技术上的实现,请参见[[MediaWiki:Common.js]]。--><br />
<code>collapsed</code>:该导航框总会在开始时以折迭起来的 状态 展现。<br />
<code>plain</code>:该导航框会不带右侧的“隐藏”链接 并且标题会保持居中。<br />
<code>off</code>:该导航框总会在被展开时不带右侧的“隐藏”链接,但是没有补白以保持标题居中。<ref>这只是为了高级用 ;“plain”选项应能满足大多数需要将“显示”/“隐藏”按钮隐藏起来的情况。</ref><br />
除上述4个值之外的其他值(例如“uncollapsed”),该导航框总会在开始时以展开的状态出现,但是带有“隐藏”按钮
<ref>若要在单独显示框体,而在一个条目中时自动隐藏内容,可以将“uncollapsed”置于<nowiki><noinclude></nowiki>标签之内:
<code>state = </code><nowiki><noinclude>uncollapsed</noinclude></nowiki></ref>
|-
|-
|<code>titlestyle</code>
|<code>titlestyle</code>
第127行: 第119行:
|在group/list区段之下显示的可选文字,与<code>above</code>性质相同。
|在group/list区段之下显示的可选文字,与<code>above</code>性质相同。
|}
|}
其他的一些替代导航格式:[[#表格布局|表格布局]]。


进一步的细节,以及复杂的约束,在下方[[#参数描述|参数描述]]章节作了解释。参见其他的一些替代导航格式:[[#表格布局|''表格布局'']]。<!-- Further details, and complex restrictions, are explained below under section ''[[#Parameter descriptions|Parameter descriptions]]''. See some alternate navbox formats under: [[#Layout of table|''Layout of table'']]. -->
===高级 参数/复杂 描述===
 
<!--
== 参数描述 ==
下面是用于Navbox的参数的一个完整清单。在大多数情况下,只要有参数<code>name</code>、<code>title</code>和几个<code>group</code>和<code>list</code>就可以了。
 
=== 设置参数 ===
:; ''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>autocollapse、uncollapsed、collapsed、plain、off</code>]</span>
:*缺省为<code>autocollapse</code>。如果在使用了其他可折迭表格的同一个页面上有两个或更多表格,那么该页面上的带<code>autocollapse</code>的导航框一开始就会折迭起来。否则,该导航框会被展开。要了解技术上的实现,请参见[[MediaWiki:Common.js]]。
:*如果设置为<code>collapsed</code>,该导航框总会在开始时以折迭起来的状态展现。
:*如果设置为<code>plain</code>,该导航框总会在被展开时不带右侧的“隐藏”链接,并且标题会保持居中(通过使用补白来偏移<small>查 • 论 • 编 • 历</small>链接)。
:*如果设置为<code>off</code>,该导航框总会在被展开时不带右侧的“隐藏”链接,但是没有补白会被用来保持标题居中。这只是为了高级用法;“plain”选项应能满足大多数需要将“显示”/“隐藏”按钮隐藏起来的应用。
:*如果设置为除<code>autocollapse</code>、<code>collapsed</code>、<code>plain</code>或<code>off</code>之外的其他值(像“uncollapsed”),该导航框总会在开始时以展开的状态出现,但是带有“隐藏”按钮。
:若要在独处(未被包含)时显示框体,而在一个条目中时自动隐藏内容,可以将“uncollapsed”置于<nowiki><noinclude></nowiki>标签之内:
:* <code>state = </code><nowiki><noinclude>uncollapsed</noinclude></nowiki>
:*如此设置会强制框体在单独出现时(甚至是后面有其他导航框时)展开,显示“隐藏”按钮,而当被堆迭在一个条目中时自动折迭框体。
:很多时候,对于一个导航框,编辑者会想要一个缺省的初始状态,并且在条目中它可以被覆写。要做到这一点,这里有个窍门:
:在你的居间模板里,创建一个参数也命名为“state”作为一个传递。
:; ''navbar''<sup>†</sup>
:; ''navbar''<sup>†</sup>
::缺省为<code>Navbar</code>。如果设置为<code>plain</code>,在标题栏左侧的<small>查 • 论 • 编</small>链接不会显示出来,而且补白会被自动应用以保持标题居中。设置为<code>off</code>可以移除<small>查 • 论 • 编</small>链接,但是不会应用补白(这只是为了高级用法;“plain”选项应能满足大多数不想要导航栏的应用。)强烈建议使用者不要隐藏导航栏,为的是使用户编辑该模板更加容易,并且可以贯穿各个页面都有一个标淮的风格。
::缺省为<code>Navbar</code>。如果设置为<code>plain</code>,在标题栏左侧的<small>查 • 论 • 编</small>链接不会显示出来,而且补白会被自动应用以保持标题居中。设置为<code>off</code>可以移除<small>查 • 论 • 编</small>链接,但是不会应用补白(这只是为了高级用法;“plain”选项应能满足大多数不想要导航栏的应用。)强烈建议使用者不要隐藏导航栏,为的是使用户编辑该模板更加容易,并且可以贯穿各个页面都有一个标淮的风格。
<!--
 中文模板目前不支持此参数。2008-10-23
 中文模板目前不支持此参数。2008-10-23
:; ''border''<sup>†</sup>
:; ''border''<sup>†</sup>
::''关于将导航框用在另一个导航框内部,欲了解示例及更完整的描述,请参见下面的章节。''如果设置为<code>child</code>或<code>subgroup</code>,那么该导航框能够被用作一个无边框的子导航框。其边框被隐藏并且在表格的边上没有补白,因此它能很好地放进它的父导航框的list区域。如果设置为<code>none</code>,那么
::''关于将导航框用在另一个导航框内部,欲了解示例及更完整的描述,请参见下面的章节。''如果设置为<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):
:: ''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><nowiki>{{Navbox|child</nowiki></code>
第159行: 第133行:
:::<code><nowiki>}}</nowiki></code>
:::<code><nowiki>}}</nowiki></code>
-->
-->
=== 单元格 ===
:; ''title''<sup>†</sup>
:; ''title''<sup>†</sup>
::显示在表格顶端一行居中位置的文字 。它通常是该模板的主题,也就是主体内容的一个简要描述。这应该是单独的一行,但是如果需要第二行,请使用<code><nowiki>{{brClear}}</nowiki></code>来保证正确的居中。本参数从技术上来说不是必需的,但是使用Navbox而不带标题是相当没有意义的
::显示在表格顶端一行居中位置的文字。
:; ''group<sub>n</sub>''<sup>†</sup>
:; ''group<sub>n</sub>''<sup>†</sup>
::(即''group1''、''group2''等等)如果被指定,文字会显示在位于''list<sub>n</sub>''左侧的抬头单元格中。如果被省略,''list<sub>n</sub>''占用表格的全部宽度。
::(即''group1''、''group2''等等)如果被指定,文字会显示在位于''list<sub>n</sub>''左侧的抬头单元格中。如果被省略,''list<sub>n</sub>''占用表格的全部宽度。
第331行: 第303行:
*外层导航框表格的缺省的左外边距(margin-left)和右外边距(margin-right)被设置为“auto;”。如果你想使用导航框作为一个浮动对象(float),你需要手动设置左外边距和右外边距的值,因为自动外边距(auto margins)会阻止浮动(float)选项。例如,添加下列代码来使用导航框作为一个浮动对象:
*外层导航框表格的缺省的左外边距(margin-left)和右外边距(margin-right)被设置为“auto;”。如果你想使用导航框作为一个浮动对象(float),你需要手动设置左外边距和右外边距的值,因为自动外边距(auto margins)会阻止浮动(float)选项。例如,添加下列代码来使用导航框作为一个浮动对象:
::<code>style = width:22em;float:right;margin-left:1em;margin-right:0em;</code>
::<code>style = width:22em;float:right;margin-left:1em;margin-right:0em;</code>
==备注==
<references />
4,333

个编辑