User:AWCPublic/TemplateDoc:Mbox

Mbox 是一个用于创建消息盒（message boxes）的模板。

这个模板已经高度适配了CSS类，内联样式和CSS选择器。可选功能包括添加图片、左边栏条的颜色（left border）、右边的提示文本（例如，这个页面存在的问题）以及弃用该页面提示的功能。

这个模板使用了 Lua 模板语言。你可以在dev社区的全局Lua页面找到一些说明信息。该版本的Mbox始终会与dev社区上的设计保持一致（包括Lua代码和基本CSS。

参数

关于使用这些参数的一些例子参见下文。

参数名称	说明	是否必须	预设值
class	向.mbox根元素中添加CSS类	否	-
bordercolor	左部厚边条的颜色	否	-
type	Mbox的类型，取决于CSS中相关的类，会主要影响bordercolor的CSS参数值，详见使用类型	否	-
bgcolor	Mbox背景颜色	否	-
style	.mbox类所在的元素的其它内联样式，需要用HTML内联样式规范写入，例如background:pink; font-size:12px	否	-
image	添加到Mbox左边的图片	否	-
imagewidth	上面定义的图片的宽度	否	60px
imagelink	点击图片会跳转的目标链接（也可以跳转到已经存在的分类），如果这个参数为空，图片点击没有反应。	否	-
header	标题（显示在Mbox最上面一行的加粗文本），通常是Mbox主题的简短介绍，当Mbox被关闭（鼠标点击右上角的“x”）时将会只显示这个标题	否	-
text	放置在标题下面的非加粗文本，用来详细说明Mbox的具体信息或者一些细节。当Mbox被关闭时不会显示这个内容。	否	-
comment	在主要文本（text）下面显示的小字，一般用于填写添加者的评论和相关信息，当Mbox被关闭时不会显示这个内容。	否	—
aside	在Mbox右侧划出一个平行于标题和说明文字等的区域，在这里面添加一些信息。最常用的情形是该页面不符合相关规范时添加的问题和说明，以及质疑内容，当Mbox被关闭时不会显示这个内容。	否	-
id	每个Mbox专属的ID。预设情形下，在一个有多个Mbox的页面中，点击任意一个Mbox的关闭按钮就会关闭所有的Mbox，要改变这个情形，请给每个Mbox如遇单独不同的ID，当然你也可以组合ID，相同的ID在关闭/打开时总会同时被执行操作。（例如"Template:Mbox/Stub"可以赋值|id=stub)	否	-
collapsed	折叠行为，预设情形下模板是不折叠（或称不被关闭）的，并且显示出所有内容，如果要在预设就折叠内容可以输入|collapsed=true	否	-

例子

实现样例

以下是几个已经打包好的样例，可直接进行无参调用：

1. Template:Mbox/Stub：小作品，提示人们向其中添加新内容。
2. Template:Mbox/Disambig：消歧义，提示人们还有其他和页面标题类似的相关页面存在。
3. Template:Mbox/Outdate：过时页面，大多涉及到已经停止使用或支援的页面或模板。
4. Template:Mbox/Delete：删除横幅，告知人们和管理员这个页面可能不符合相关规定，需要删除。

更多样例参见这里。

基本Mbox

{{Mbox
|header      = 标题文本
|text        = 一般说明信息
|id          = test1
}}

效果：

适用类型

可以修改相关的CSS变量来更改不同的类型的颜色：

:root {
    --type-important: rgba(200, 0, 0, 0.8);
    --type-moderate: rgba(233, 124, 47, 0.8);
    --type-minor: rgba(241, 197, 37, 0.8);
}

如果添加：

{{Mbox
|header = 标题文本
|type   = important
|text   = 一般说明信息
|id     = test2
}}

效果：

添加图片

{{Mbox
|header     = 标题文本
|text       = 一般说明信息
|image      = Wiki.png
|imagelink  = 
|imagewidth = 50px
|id         = test3
}}

效果：

添加侧边栏位

{{Mbox
|header = 标题文本
|type   = important
|text   = 一般说明信息
|aside  = 侧边文字
|id     = test4
}}

效果：

标准参数

{{Mbox
|header  = 标题文本
|text    = 一般说明信息
|comment = 留言
|image   = Wiki.png
|aside   = 侧边信息
|id      = standard
}}

效果：