查看“模板:MessageBox/doc”的源代码

{{T|MessageBox}} is a template for creating message boxes.

It is highly customizable with classes, inline styles, and provided CSS selectors. Optional features such as an image, left border, right-side text (for e.g. shortcuts), and a dismiss function.

It uses the [[w:Help:Lua|Lua templating language]], and more information can be found [[w:c:dev:Global_Lua_Modules/Mbox|on the Global Lua Module page]]. This version is modified to produce a starter style, based on the [[w:c:dev:mediawiki:Global Lua Modules/Mbox.css|basic style from the module]]. To use the full capabilities of this module and remove the default styling, remove the indicated portions of [[Module:Mbox]]. 

'''For a traditional wikitext version of this template, see [[w:c:templates:Template:Ambox|Ambox on Templates Wiki]]'''.

==Parameters==
For examples of how to use these parameters, see [[#Examples]].
{| class="wikitable" style="width: 100%"
! Parameter name
! Description
! Required?
! Default
|-
| <code>class</code>
| Additional classes to the root <code>.mbox</code> element.
| No
| —
|-
| <code>bordercolor</code>
| The color of the thick left-most border.
| No
| Stylesheet default
|-
| <code>type</code>
| Type of mbox as declared as in CSS with variables. Affects color of the thick left-most border. See [[#Using types]].
| No
| —
|-
| <code>bgcolor</code>
| The color of the mbox's background.
| No
| Stylesheet default
|-
| <code>style</code>
| Additional inline styles to the root <code>.mbox</code> element.
| No
| —
|-
| <code>image</code>
| An image to be added to the left of all text content.
| No
| —
|-
| <code>imagewidth</code>
| The width of the image (height automatically adjusts).
| No
| <code>60px</code>
|-
| <code>imagelink</code>
| The link to which the image points (could link to the relevant maintenance category, per example). If not included, the image will be un-clickable.
| No
| —
|-
| <code>header</code>
| The header (bold text placed at the top). This is typically used to very briefly explain the subject of the mbox itself, as when the mbox is closed, only the header will show.
| No
| —
|-
| <code>text</code>
| Non-bold text placed below the header, typically used to explain the subject of the mbox in further or additional detail. When the mbox is closed, this text will be hidden.
| No
| —
|-
| <code>comment</code>
| Smaller non-bold text placed below the main text, typically used to add additional links or context about the notice. When the mbox is closed, this text will be hidden.
| No
| —
|-
| <code>aside</code>
| Text placed within a small allocation on the right side separated by a light gray border. Most commonly used to show shortcuts to the page in question (such as on policy pages). When the mbox is closed, this text will be hidden.
| No
| —
|-
| <code>id</code>
| By default, one close button will close all mboxes on the page. However, to change this, this parameter may be used, given as the name of the mbox implementation (e.g., "Template:Cleanup" would have <code><nowiki>|id=cleanup</nowiki></code>).
| No
| —
|-
| <code>collapsed</code>
| By default, the mbox will be uncollapsed, and the full contents will be shown. However, to change this, this parameter may be used to set an mbox as collapsed by default (e.g., <code><nowiki>|collapsed=true</nowiki></code> would set the mbox to be collapsed by default).
| No
| —
|}

==Design==
Some communities may wish to customize the appearance of the mboxes. The most common styling options are provided illustrated in CSS.


; Technical notes
* Additional inline styles to the root <code>.mbox</code> element can be achieved via the <code>style</code> parameter in the template.

== Examples ==
=== Basic MessageBox ===
<pre>
{{MessageBox
|header      = Header text here
|text        = Normal text here
|id          = test1
}}</pre>

Produces:

{{#invoke:Mbox|main
|header      = Header text here
|text        = Normal text here
|id          = test1
}}

=== Using types ===
To use types, CSS variables must be added, such as:

If added:

<pre>
{{MessageBox
|header = Header text here
|type   = important
|text   = Normal text here
|id     = test2
}}</pre>

Produces:

{{#invoke:Mbox|main
|header = Header text here
|type   = important
|text   = Normal text here
|id     = test2
}}

Depending on your styling, there may not be a visual difference in the above example.

=== With an image ===
<pre>
{{MessageBox
|header     = Header text here
|text       = Normal text here
|image      = Wiki.png
|imagelink  = 
|imagewidth = 50px
|id         = test3
}}</pre>

Produces:

{{#invoke:Mbox|main
|header     = Header text here
|text       = Normal text here
|image      = Wiki.png
|imagelink  = 
|imagewidth = 50px
|id         = test3
}}

=== With an aside ===
<pre>
{{MessageBox
|header = Header text here
|type   = important
|text   = Normal text here
|aside  = Aside text here
|id     = test4
}}</pre>

Produces:

{{#invoke:Mbox|main
|header = Header text here
|type   = important
|text   = Normal text here
|aside  = Aside text here
|id     = test4
}}

=== Standard/default style ===
<pre>
{{MessageBox
|header  = Header text here
|text    = Normal text here
|comment = Comment text here
|image   = Wiki.png
|aside   = Aside text here
|id      = standard
}}</pre>

Produces:

{{#invoke:Mbox|main|header=Header text here |text=Normal text here |comment=Comment text here |image=Wiki.png |aside=Aside text here |id=standard}}
<includeonly>[[Category:Notice templates]]</includeonly><noinclude>[[Category:Template documentation]]</noinclude>