更多操作
Holger Huo（讨论 | 贡献） 无编辑摘要 |
Holger Huo（讨论 | 贡献） （→用法） |
||
| 第3行： | 第3行： | ||
=== 用法 === | === 用法 === | ||
本模板用于创建一个信息栏。表格中的每一行既可以是顶栏（header），也可以是成对的标签（label）与数据（data），甚至还可以只是一个数据单元。每行只能有一种状态，且具有优先级：当你将一行同时定义为顶栏与标签／数据对，那么标签／数据对的定义将会被忽略。 | |||
====編號==== | ====編號==== | ||
2022年5月20日 (五) 17:34的版本
本模板为一系列「信息框」模板的元模板，亦即本模板用于构建其他模板。通常不建議在条目中直接使用此模板，但是如有需要，可以在個別「一次性」情況中直接使用。
用法
本模板用于创建一个信息栏。表格中的每一行既可以是顶栏（header），也可以是成对的标签（label）与数据（data），甚至还可以只是一个数据单元。每行只能有一种状态，且具有优先级：当你将一行同时定义为顶栏与标签／数据对，那么标签／数据对的定义将会被忽略。
編號
為方便日後更改信息框格式，header和label／data行的編號不需要完全按照1、2、3……的加一順序編寫，可以在中間預留一些行編號不用，可避免將來如要增加新行時要把該行後面的行編號一併更改。
header和label／data行的編號不可以重複，例如不可以同時使用header1和label1／data1，請使用header1、label2／data2（舉例）。
参数
“查看／讨论／编辑／历史”链接
- name
- “查看／讨论／编辑／历史”链接需要指向模板页的名称（name）。你可以填写{{subst:PAGENAME}}。如果此参数未填，则“查看／讨论／编辑／历史”链接不会显示。
标题
| （信息框的其余部分） |
| 信息框内的标题文本 | |
|---|---|
| （信息框的其余部分） |
有两种方式为一个信息框填入标题。一种是将标题填在信息框外，另一种则是填写在信息框内。根据需要，你可以选择其中的一种使用，亦或同时使用这两种标题，甚至都不使用（尽管我们不推荐这样做）。
- title
- 填写在信息框表格外顶部的标题文本。
- above
- 填写在信息框表格内顶部单元的标题文本。
可选项
- subheader
- 在 above 下面的次標題。subheader2是第2個次標題。
- image
- 在模板上部显示的图像。请使用完整的图像语法，例如[[File:example.png|200px]]，推荐使用模块:InfoboxImage插入图像。图像的位置默认为居中。
在中文維基百科，一個Infobox最多可使用4個圖像參數：overimage（置頂）、image（=image1）、image2、image3，與英文維基百科的Infobox僅提供image（=image1）、image2不同。 - caption
- 位于图像下方的说明文本。
overcaption、caption（=caption1）、caption2、caption3分別對應上面4個圖像參數。 - header(n)
- 填入第n行的顶栏文本。
- label(n)
- 填入第n行的标签文本。
- data(n)
- 填入第n行的数据文本。
- below
- 填写在信息框表格底部单元的文本。底部单元一般用来填写脚注、参见及其他类似的信息。
可选的CSS风格
- bodystyle
- 应用到信息框表格全体。
- titlestyle
- 应用到信息框表格外的标题中。不建议在此处填写背景颜色（background color），因为该处的文字位于信息框外。
- abovestyle
- 应用到信息框表格内顶部单元中。默认的风格为“font-size:large;”（字号设为大号），因为该单元常被用作标题。如果你希望让顶部单元以正常字号显示，只需在该处填写的内容中包含“font-size:medium;”。
- imagestyle
- 应用到信息框的图像单元中，包括图像下方的说明文本。但是，出于兼容性与未来修改的考虑，如果你需要设置说明文本的属性，请使用captionstyle而不要使用imagestyle。
- captionstyle
- 应用到图像说明文本中。
- headerstyle
- 应用到所有的顶栏单元。
- header(n)style
- 应用到第n行的顶栏单元。
- labelstyle
- 应用到所有的标签单元。如果你希望让标签文字不换行显示，只需在该处填写的内容中包含“white-space:nowrap;”。
- label(n)style
- 应用到第n行的标签单元。
- datastyle
- 应用到所有的数据单元。
- data(n)style
- 应用到第n行的数据单元。
- belowstyle
- 应用到底部单元中。
微格式
- bodyclass
- 该参数影响信息框整体的类（class）。
- imageclass
- 该参数影响图像的类。
- class(n)
- 该参数影响特定行数据单元的类。如果信息框没有数据单元，则不会产生作用。
- titleclass
- 该参数影响信息框外标题的类。
- aboveclass
- 该参数影响信息框内标题的类。
通过为各个数据单元定义类名，本模板可以支持微格式信息；此处所说的类名，是根据标准定义的，且可以向机器表明信息的类型。例如，如果一个信息框使用了hCard的微格式，要在信息框内标记此微格式，则填写以下参数：
|bodyclass = vcard
并为每一个包含了vcard所需数据单元的行添加相应的类参数：
|class1 = fn |class2 = org |class3 = tel
等等。用于显示信息框主题的“above”和“title”也可以指定类。
表格域可选项
如果表格的一行只有标签而没有数据，那么该行将不会显示。这样可以方便编者创建选填内容的行。要让某行成为可选项，只需填写一个默认为空字段的参数即可：
|label5 = 人口
|data5 = {{{population|}}}
这样的话，如果在条目中不定义“population”参数，则信息框的那一行不会被显示。
如果表格的一行填写的是预设格式内容（即除了参数外，还有其他内容），而又希望让该行成为可选项的话，你可以通过“#if”语句实现。当参数为空时，令所有的内容均不被呈现。譬如，在下面的例子里，“#if”会判断参数“mass”是否不为空，若不为空则显示它，并跟上“千克”的后缀：
|label6 = 质量
|data6 = {{#if:{{{mass|}}} |{{{mass}}}千克}}
如果你希望顶栏只在其下方的某个或多个数据单元有内容时才显示，以下的例子可以指导你如何实现：
{{Infobox
|name = {{subst:PAGENAME}}
|title = 可选顶栏的用例
|autoheaders = y
|header1 = 可选顶栏
|label2 = 项目一
|data2 = {{{item_one|}}}
|label3 = 项目二
|data3 = {{{item_two|}}}
|label4 = 项目三
|data4 = {{{item_three|}}}
}}
这样，只有在参数“item_one”、“item_two”或“item_three”其中之一被填写时，“header1”才会被显示。如果上述三个参数均未被定义，则顶栏不会显示。
完整模板
（备注：本模板目前最多可以同时处理80行表格，一般的信息框模板只会用到前20行的参数，因此此处省略了后60行的参数。需使用时可依此类推。微格式“class”参数亦被省略，因其不常被用到，使用时请自行添加。）
{{Infobox
| name = {{subst:PAGENAME}}
| child = {{{child|}}}
| subbox = {{{subbox|}}}
| italic title = {{{italic title|no}}}
| bodystyle =
| titlestyle =
| abovestyle =
| subheaderstyle =
| title =
| above =
| subheader =
| imagestyle =
| captionstyle =
| image =
| caption =
| image2 =
| caption2 =
| headerstyle =
| labelstyle =
| datastyle =
| header1 =
| label1 =
| data1 =
| header2 =
| label2 =
| data2 =
| header3 =
| label3 =
| data3 =
| header4 =
| label4 =
| data4 =
| header5 =
| label5 =
| data5 =
| header6 =
| label6 =
| data6 =
| header7 =
| label7 =
| data7 =
| header8 =
| label8 =
| data8 =
| header9 =
| label9 =
| data9 =
| header10 =
| label10 =
| data10 =
| belowstyle =
| below =
}}