Template:Message/doc

This is a documentation subpage for Template:Message.
It contains usage information, categories and other content that is not part of the original template page.

Usage

{{message}} displays a custom made message box.

Parameters

Copy-paste templates

Mandatory parameter

Text

1

Custom text string, wiki-formatting can be used. The parameter is unnamed, so no parameter name needs to be entered.

Note:

• If this parameter is left out, its name in the template code, "{{{1}}}", will be displayed.

Usage

• {{message|''text''}}

Optional parameters

Class

class

A custom CSS class to append to the box's default class messagebox, e.g. messagebox small.

Usage

• {{message|1|class=class name}}

Colours

bgcolor

The background colour of the box, defined as a CSS colour name (e.g. white) or a hexadecimal colour code, e.g. #ffffff for white. The default colour is #f9f6b7.

Usage

• {{message|1|bgcolor=CSS/hex colour}}

bdcolor

The border colour of the box, defined as a CSS colour name (e.g. black) or a hexadecimal colour code, e.g. #000000 for black. The default colour is #c4c295.

Usage

• {{message|1|bdcolor=CSS/hex colour}}

fgcolor

The foreground colour of the box (i.e. text colour), defined as a CSS colour name (e.g. black) or a hexadecimal colour code (e.g. #000000 for black). The default colour is black.

Usage

• {{message|1|fgcolor=CSS/hex colour}}

Image

image

You can choose a specific image to use for the template by using the image parameter. The image is displayed on the left side in the box, to the left of the text. The default image is Idea.png (File:Idea.png).

Notes:

• When defining an image, don't include the namespace (File: or Image:). That is inserted automatically.

Usage

• {{message|1|image=name.ext}}

imgwidth

The width of the used image (in pixels). The default value is 35.

Note:

• When defining the image width, don't include the unit (px or pixels). That is inserted automatically.

Usage

• {{message|1|imgwidth=number value}}

CSS styling

style

Optional CSS properties with corresponding values may be defined, without quotation marks " " but with the ending semicolons ;. The parameter specifies the style used by the entire message box.

Usage

• {{message|1|style=prop1:value1; prop2:value2;}}

Examples

Correct use

Parameter	What you write	What you see
1	{{message|You ''can'' '''use''' <sup>wiki</sup> <big>markup</big>}}	You can use wiki markup
class	{{message|Custom text|class=text}}	Custom text
bgcolor	{{message|Custom text|bgcolor=white}}	Custom text
	{{message|Custom text|bgcolor=#ffffff}}	Custom text
bdcolor	{{message|Custom text|bdcolor=black}}	Custom text
	{{message|Custom text|bdcolor=#000000}}	Custom text
fgcolor	{{message|Custom text|fgcolor=green}}	Custom text
	{{message|Custom text|fgcolor=#008000}}	Custom text
image	{{message|Custom text|image=Green check.png}}	Custom text
imgwidth	{{message|Custom text|image=Green check.png|imgwidth=75}}	Custom text
style	{{message|Custom text|style=text-align:right;}}	Custom text

Incorrect use

Example case	What you write	What you see (error)
No parameter	{{message}}	{{{1}}}

See also

• {{message/box}} – the same as {{message}}, plus the option to define the maximum width of the box, and some other tweaks.
• {{admon}} – four types of message boxes for various situations, based upon the template {{message}}.
• {{label}} – strong message box for incredibly important messages. Use only if absolutely necessary.