模板:Ombox/doc

本模板是{{Ombox}} ([O]ther [m]essage [b]ox) (其他消息框) 元模板。

此模板用于构建除 articles (条目) , talk pages (讨论页) , image pages (文件页) 或者 category pages (分类页) 之外的所有消息框。它提供若干种不同的颜色, 当无图像参数给出时使用预设图像, 它还有其他特点。

该模板的工作与{{Ambox}}几乎相同，并使用同样的参数。

用法

简单应用的例子:

{{Ombox | text = Some text.}}

复杂应用的例子:

{{Ombox
  | type      = style
  | image     = [[File:Emblem-question-yellow.svg|40px]]
  | style     = max-width: 400px; 
  | textstyle = color: red; font-weight: bold; font-style: italic;
  | text      = 消息框文本. 
}}

分类信息框类别

以下范例使用了不同的 type 参数, 但没有使用 image 参数, 因而使用了各 type (类型) 所对应的预设图像。

其他图片

上方显示的预设图像是十分方便的, 但在很多情况下需要使用特别指定的图像。以下是一些使用 image 参数来指定其他图像的案例:

特殊设定

此外, 还有一些其他的参数。

参数

所有参数的列表:

{{Ombox
  | type            = speedy / delete / content / style / notice / move / protection
  | image           = none / [[File:Some image.svg|40px]]
  | imageright      = [[File:Some image.svg|40px]]
  | style           = CSS values
  | textstyle       = CSS values
  | text            = The message body text. 
  | plainlinks      = no 
  | small           = {{{small|}}} / yes
  | smallimage      = none / [[Image:Some image.svg|30px]]
  | smallimageright = none / [[Image:Some image.svg|30px]]
  | smalltext       = A shorter message body text.
}}

type

如果不指定type参数，会返回用于 "条目注意" 的预设类型notice的模板。这意味着会像上文中的简单应用那样产生一个蓝色的边框。

image

No parameter = 如果不指定image参数的话, 会返回使用预设图像的模板。至于是哪张预设图像则取决于type参数。

An image = 应该是一幅带有常见维基符号的图像。通常为40px－50px的宽度, 这取决于图像的长宽比。 (但消息框可应付各种尺寸的图像。) 例如:

image = [[File:Sub-arrows.svg|40px]]

none = 不使用图像。

imageright

No parameter = 如果不指定imageright参数的话, 会返回右侧不带图像的模板。

An image = 应该是一幅带有常见维基符号的图像。通常为40px－50px的宽度, 这取决于图像的长宽比。（但消息框可应付各种尺寸的图像。）例如:

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

Anything = 任何你想在模板右侧显示的其他内容。

style

一个可选的 CSS 值, 作用于整个消息框区域. 不需要 " " 符号. 例如:

style = margin-bottom: 0.5em;

textstyle

一个可选的 CSS 值, 作用于文本单元格. 例如:

textstyle = text-align: center;

text

消息框的主体文本。

plainlinks

在RIA | Wiki中, 外链后会显示一个箭头, 像这样: Example.com。然而, 在消息框中, 箭头图标默认不显示, 像这样: Example.com。要得到普通带箭头的外链, 使用|plainlinks=no。

小型信息框参数

small

yes = 使它成为一个较小的右浮动消息框。这也会使默认图像变小。请注意, 只有在 |small=yes 时, 才使用提供给 smallimage ，smallimageright 和 smalltext 参数的任何数据。若您的模板也需理解small参数, 您可以使用以下代码:

small = {{{small|}}}

smallimage

无参数 = 如果未指定 smallimage 参数, 模板将会回调使用 image 参数。如果 image 参数也为空, 模板将会使用小型默认图像。

一张图像 = 应使用标准wiki图像语法。30px宽的图像一般不会导致错误, 例如:

smallimage = [[Image:Replacement filing cabinet.svg|30px]]

none = 意味着不会使用图像, 当 small = yes 时, 这将覆盖任何在 image 中定义的图像。

smallimageright

无参数 = 如果未指定 smallimageright 参数, 模板将回调使用 imageright 参数。如果 imageright 参数也为空, 模板将不会在右侧显示任何图像。

一张图像 = 应使用标准wiki图像语法。30px宽的图像一般不会导致错误, 例如:

smallimageright = [[File:Nuvola apps bookcase.png|30px]]

Anything = 任何你想在模板右侧显示的内容。

none = 意味着不会使用图像, 当 small = yes 时, 这将覆盖任何在 imageright 中定义的图像。

smalltext

较短版本的信息框主体文本。如果未指定 smalltext 参数, 模板将回调使用 text 参数。

技术细节

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

{{Ombox
  | text  = <div>
等号 (=) 和开始和结束大括号 ({ }) 会正常显示。
但是需要这样表示管道符 {{!}} 和两个连续结束大括号<nowiki>}}</nowiki>. 
这样表示连续管道符和结束大括号: <nowiki>|}}</nowiki>.
</div>
}}

此模板在Module:Message_box/styles.css中使用 .ombox 类定义其外观, 因此它完全可皮肤化。

此模板调用Module:Message box, 其中包含{{Ombox}}的大部分代码, 而{{Ombox}}本身进行参数预处理。

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

有关更多技术细节, 请参见原讨论页面。由于此模板的工作原理几乎与{{Ambox}}, {{Imbox}}, {{Cmbox}}和{{Tmbox}}相同, 因此它们的讨论页和相关页面也可能包含更多详细信息。

模板数据

这是用于新版可视化编辑器及其他工具的模板数据文档。

Ombox模板数据

Ombox (其他消息框) 元模板, 用于创建使用于主、分类、文件和讨论名字空间之外的消息框。

模板参数

此模板有自定义格式。

参数		描述	类型	状态
名称	name	模板名称	字符串	可选
类型	type	指定消息框类型 默认值 notice	字符串	推荐
图像	image	可以设置消息框左侧的图像	文件	可选
右侧图像	imageright	可以设置消息框右侧的图像	wikitext片段	可选
CSS 样式	style	可以设置消息框的 CSS 样式	字符串	可选
文本 CSS 样式	textstyle	可以设置消息框内文本的 CSS 样式	字符串	可选
文本	text	消息框主体文本	内容	可选
plainlinks	plainlinks	设置为«no»启用外链图标	布尔	可选
小型信息框	small	指定该模板是否可以显示为小型信息框	字符串	可选
小型消息框左侧图像	smallimage	使用标准的wiki图像语法	文件	可选
小型消息框右侧图像	smallimageright	使用标准的wiki图像语法	wikitext片段	可选
小型信息框主体文本	smalltext	若不定义, 使用text参数指定的文本	wikitext片段	可选