模板:Tmbox

模板文档

[查看] [编辑] [历史] [清除缓存]

这是{{Tmbox}} ([T]alk page [m]essage [box]) (讨论页消息框) 元模板。其他模板调用此模板以使整个项目的讨论页上使用的模板消息具有一致的结构和外观。可以在讨论页上直接调用此模板, 以便以与模板消息相同的格式呈现一次性消息, 但这是非标准的 (如果消息足够重要或用途足够广泛, 您应该考虑创建一个单独的模板, 以便其他编辑者可以轻松使用它) 。Tmbox提供了几种不同的颜色用于不同的用途, 如果未提供图像参数, 则提供默认图像, 并具有其他一些令人偷税的功能。该模板的工作方式类似于{{Ambox}}, 并使用相同的参数。

建议样式标准

讨论页消息框的类型与所有其他命名空间的框遵循相同的命名约定, 但是任何特定讨论页消息框的类型可能不像其他命名空间中那样明显。在确定用于讨论页消息框的类型时, 请考虑以下准则:

• speedy 仅应用于 快速删除模板。
• delete 仅应用于与进行中的删除讨论有关的模板。请不要仅使用此类型来为消息框显示红色边框。
• content 和 style 仅应用于大小警告, content (有橙色边框那个) 用于更重要和即时的警报中, style (黄边框) 用以次要警告。理想情况下，这些类型的消息框应该是 临时的: 不应期望它们无限期地保留在对话页面上。
• move 和 protection 仅应分别用于与移动和合并以及页面保护有关的消息框。
• notice类型应用于大多数对话页消息框; 旨在传达或总结信息的内容。如果对话页消息框显然不适合其他类型之一, 则可能是此类型。

使用

简单使用例:

{{tmbox | text = 一些文本。}}

复杂例子:

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

讨论页消息框类型

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

特殊

其他一些参数组合。

参数

参数列表:

{{tmbox
  | name = 模板名
  | type  = speedy / delete / content / style / notice / move / protection
  | image = none / [[File:Some image.svg|40px]]
  | imageright = [[File:Some image.svg|40px]]
  | style = CSS 值
  | textstyle = CSS 值
  | plainlinks = no
  | text  = 消息框主体文本。
  | small = {{{small|}}} / yes
  | smallimage = none / [[File:Some image.svg|30px]]
  | smallimageright = none / [[File:Some image.svg|30px]]
  | smalltext  = 更小的消息框主体文本
}}

name

(可选) 模板名。若指定值, 将会往HTML元素中 class 属性里添加 box-name 类, 用于机器人或脚本。

type

如果未指定 type 参数, 模板将会使用默认的 notice 类。此类得到灰色边框。

image

无参数 = 如果未指定 image 参数, 模板将会使用该类默认的图像。

一张图像 = 应使用标准wiki图像语法。40px–50px宽的图像一般不会导致错误, 具体取决于图像的高宽比。(但是消息框可以处理任何大小的图像。) 例如:

image = [[File:Crystal package settings.png|40px]]

none = 不会生成图像。

imageright

无参数 = 如果未指定 image 参数, 消息框右侧将不会显示图像。

一张图像 = 应使用标准wiki图像语法。40px–50px宽的图像一般不会导致错误, 具体取决于图像的高宽比。(但是消息框可以处理任何大小的图像。) 例如:

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

任何东西 = 任何你想在消息框右侧显示的内容。

style

作用于整个消息框表格的CSS值。没有引号 " " 但需要结尾分号 ;。例如:

style = margin-bottom: 0.5em;

textstyle

作用于文本单元格的CSS值。例如:

textstyle = text-align: center;

plainlinks

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

text

消息框主体文本。

小型信息框参数

small

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

small = {{{small|}}}

smallimage

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

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

smallimage = [[File:Crystal package settings.png|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 参数中使用特殊字符, 则需要像这样对它们进行转义:

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

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

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

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

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

模板数据

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

Tmbox模板数据

Tmbox (讨论页消息框) 元模板, 用于创建使用于讨论名字空间的消息框。

模板参数[编辑模板数据]

此模板有自定义格式。

参数		描述	类型	状态
名称	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片段	可选

脚注

上述模板文档页模式文档嵌入自模板:Tmbox/doc。 (编辑 | 历史)
编者可以在本模板的沙盒 (创建 | 镜像)和测试样例 (创建)页面进行实验。
请在/doc子页面中添加分类。 本模板的子页面。