Template:Fmbox/doc

本模板{{fmbox}}为页首与页尾讯息框（footer and header message box）。

本模板可用于构建MediaWiki:Sp-contributions-footer-anon等系统消息的消息框，也可用于用户页的页首与页脚消息框，以及编辑提示。

本模板与{{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参数，因此会显示各类型的默认图片。

其他图片

上方显示的默认图片大多用于测试与演示。多数情况下，更适合使用更具体的图片，或完全不使用图片。以下示例通过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参数，模板默认使用 type=system，即浅灰色背景。

image

未指定参数 = 未指定image参数时，模板会根据type参数使用对应的默认图片。

指定图片 = 应使用常规 wiki 图片语法，例如：

image = [[File:User-info.svg|40px]]

宽度 40px–50px 通常比较合适（取决于图片宽高比）；消息框可容纳任意尺寸的图片。

none = 不使用图片。

imageright

未指定参数 = 未指定imageright参数时，右侧不显示图片。

指定图片 = 应使用常规 wiki 图片语法，例如：

imageright = [[File:Nuvola apps bookcase.png|40px]]

宽度 40px–50px 通常比较合适；消息框可容纳任意尺寸的图片。

任意内容 = 可在右侧显示任意其他对象。

id

整个消息框的可选CSS id，不带引号 " "。主要用于标记消息框名称，便于 JavaScript 检测。例如 MediaWiki:Sp-contributions-footer 使用：

id = sp-contributions-footer

class

整个消息框的可选CSS类名，不带引号 " "。主要用于标记消息框名称，便于单独定制皮肤。例如 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}}。因为本框没有使其他消息框在宽度小于 100% 时于所有浏览器中获得正确框流布局的"1px 空图片单元格"代码。

若需在text参数中使用特殊字符，需如下转义：

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

本元模板内部使用 HTML 标记而非维基表格标记。这是制作元模板的常见做法，因为维基表格标记存在若干缺陷，例如难以在参数中使用解析器函数和特殊字符。

管理员注意：MediaWiki 不会像处理普通页面那样解析和转换系统消息中的 HTML 标记。例如
不会自动转换为
，缺失的 与 标签不会自动补全。因此请确保系统消息中的 HTML 代码为有效的 XHTML，即闭合所有开启的标签。不过，常规维基标记在多数系统消息中可正常工作。 更多技术细节参见讨论页。由于本模板与{{mbox}}、{{ambox}}、{{tmbox}}和{{ombox}}的工作方式几乎完全相同，它们的讨论页及相关页面也可能包含更多细节。

参见

• {{mbox}} – 多命名空间消息框（自动检测命名空间）
• {{ambox}} – 条目消息框
• {{tmbox}} – 讨论页消息框
• {{ombox}} – 其他页面消息框
• {{fmbox}} – 页眉和页脚消息框
• {{dmbox}} – 消歧义消息框