Template:Fmbox/doc

勤求古训,博采众方
信息框元模板
模板背景
{{Ambox}}条目
{{Cmbox}}分类
{{Imbox}}图片
{{Tmbox}}讨论
{{Fmbox}}页脚/标题
{{Ombox}}其他页面
{{Mbox}}自动侦测
消歧义

本模板{{fmbox}}为页首与页尾信息框

它可以用于为系统消息构建消息框。它还可以用于用户页面上的页脚和页眉框。

此模板的工作方式与{{ambox}}类似,并且大多使用相同的参数。主要的区别是这个盒子是100%宽的,并且有不同的颜色样式。

使用方法

简易使用法如下:

{{fmbox | text = 示范文字。}}


完整使用法如下:

{{fmbox
| type      = editnotice
| image     = [[File:Emblem-question-yellow.svg|40px]]
| style     = border: 1px solid #f4c430;
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = 消息正文文本。
}}

页脚和页眉信息框类型

以下示例使用不同的 type 参数,但不使用图像参数,因此它们使用每种类型的默认图像。

其他图像

上面显示的默认图像主要用于测试和演示。在大多数情况下,使用更具体的图像或根本不使用图像更合适。这些示例使用 image 参数指定默认图像以外的图像。

特殊的

其他一些参数组合。

参数

所有参数列表:

{{fmbox
| type  = system / editnotice / warning
| image = none / [[File:Some image.svg|40px]]
| imageright = [[File:Some image.svg|40px]]
| id = CSS id
| class = CSS class names
| style = CSS values
| textstyle = CSS values
| text  = 消息正文文本。
}}

type

如果未给定 type 参数,则模板默认为类型 system。这意味着它有一个浅灰色的背景。

image

No parameter = 如果未指定 image 参数,模板将使用默认图像。它使用的默认图像取决于 type 参数。
An image = 应该是一个带有常用wiki符号的图像。40px-50px的宽度通常为正确的,具体取决于图像的高宽比。(但消息框可以处理任何大小的图像。)例如
image = [[File:User-info.svg|40px]]
none = 表示未使用图像。

imageright

No parameter = 如果未提供imageright参数,则右侧不会显示图像。
An image = 应该是一个带有常用wiki符号的图像。40px-50px的宽度通常为正确的,具体取决于图像的高宽比。(但消息框可以处理任何大小的图像。)例如
imageright = [[File:Nuvola apps bookcase.png|40px]]
Anything = 要在右侧显示的任何其他对象。

id

整个消息框表使用的可选 CSS id。不带引号""。主要用于标记带有其名称的消息框,以便于从javascript检测消息的存在。例如MediaWiki:Sp-contributions-footer将使用:
id = sp-contributions-footer

class

整个消息框表使用的可选CSS class 名。不带引号""。主要用于标记一个带有其名称的消息框,这样它就可以单独剥皮。例如MediaWiki:Sp-contributions-footer将使用:
class = sp-contributions-footer

style

整个消息框表使用的可选 CSS 值。没有引号"",但结尾分号;。例如:
style = margin-top: 1em;

textstyle

文本单元格使用的可选 CSS 值。例如:
textstyle = font-size: 90%; text-align: center;

text

消息正文文本。

技术细节

此模板当前使用硬编码样式和类名。稍后它将只使用 CSS 类,使其更容易蒙皮。(同时,可以使用“!important”关键字对其进行蒙皮。

如果您需要制作一个小于 100% 宽度的信息,则“不要”使用此信息框,而是使用 {{ombox}}。由于此信息框没有“1px 空图像单元格”代码,因此当宽度小于 100% 时,其他 mbox 在所有浏览器中都能获得适当的大小。

如果需要在 text 参数中使用特殊字符,则需要像这样对它们进行转义:

{{fmbox
| text  = <div>
等号 = 与前后大括号{ }可以正常地使用。
但是管道符{{!}}与两个连着的后大括号}}则不能直接使用。
一起用同样要带nowiki标记|}}。
</div>
}}

在内部,此元模板使用HTML wiki标记,而不是表代码的wiki标记。这是我们制作元模板的常用方法,因为wiki标记有几个缺点。例如,这使得在参数中使用ParserFunctions和一些特殊字符变得更加困难。

管理员注意:MediaWiki在系统消息中解析和转换HTML wiki标记的方式与普通页面的方式不同。”。例如,这意味着 <br>不会自动转换为<br/>,并且不会自动添加缺少的</td></tr>标记。因此,请确保您在系统消息中使用的任何HTML代码都是有效的XHTML。即,关闭所有开始的标记。然而,常规的wiki标记在大多数系统消息中都能正常工作。

有关更多技术细节,请参阅讨论页。由于这个模板的工作方式几乎与{{ambox}}、{{tmbox}}、{{imbox}}、{{cmbox}} 和 {{ombox}} 完全相同,因此它们的讨论页和相关页面也可能包含更多详细信息。

参看

在信息框(mbox)家族中的元模板:

  • {{ambox}}:用于条目信息框
  • {{tmbox}}:用于讨论页信息框
  • {{imbox}}:用于图像页信息框
  • {{cmbox}}:用于分类信息框
  • {{ombox}}:用于其他页面信息框
  • {{mbox}}:有名字空间探测功能。某些消息框会用在几类页面并因此需要依据所用在的页面来改变风格,这种情况下的消息框可以用此元模板。

有相近关系的元模板:

  • {{fmbox}}:用于页眉和页脚信息框
  • {{dmbox}}:用于消歧义以及设定索引信息框