View source for Template:Label/doc

{{Documentation subpage}}
__NOTOC__
==Usage==
{{tl|label}} creates an information box with a custom text, and is the basic alert template. The box will show at the position on the page where you put the template, and stretch horizontally to fill the width of the available space and vertically depending on how many rows of text are needed. The text inside the box is centred.

To use the template, type <code><nowiki>{{label|label=header|description=message body|icon=icon.png}}</nowiki></code>.

==Parameters==
There are three named parameters for the header (<code>label</code>), the message body (<code>description</code>) and an icon (<code>icon</code>), respectively. The <code>label</code> parameter is mandatory, while the other two are optional. The text inside the box is pre-formatted to align as centred, but can be additionally formatted using wiki-code.

===Header===
(Mandatory!)
'''<code>label</code>''': Custom text

The first parameter is the header, and is automatically formatted as '''bold text'''. Thus, any text you enclose in three apostrophes (for bold text) in this field will be inverted (i.e. show as plain text).

'''Usage:'''
* <code><nowiki>{{</nowiki>label|'''label='''header|description=message body|icon=icon.png<nowiki>}}</nowiki></code>

===Body text===
(Optional)
'''<code>description</code>''': Custom text

The second parameter is the message's body text, and is not pre-formatted.

'''Usage:'''
* <code><nowiki>{{</nowiki>label|label=header|'''description='''message body|icon=icon.png<nowiki>}}</nowiki></code>

===Icon===
(Optional)
'''<code>icon</code>''': File-name for icon (image)

The third parameter is for displaying an icon. The image is pre-formatted to appear on the left side of the box, but it isn't scaled up or down from its original size. Thus, only use appropriately small, icon-like images with this parameter.

You have to link to an image in the [[Special:ListFiles|MozillaWiki file archive]]. Don't include the namespace, <code>File:</code>. Just enter the file-name including the file extension, e.g. <code>image.png</code>.

'''Usage:'''
* <code><nowiki>{{</nowiki>label|label=header|description=message body|'''icon='''icon.png<nowiki>}}</nowiki></code>

==Examples==
===Correct use===
{| class="wikitable"
|-
! Example case !! What you write !! What you see
|-
| Only header || <code><nowiki>{{label|label=The "label" parameter is automatically formatted as bold text.}}</nowiki></code> || {{label|label=The "label" parameter is automatically formatted as bold text.}}
|-
| Header and body text || <code><nowiki>{{label|label=This is the header|description=This is the body text.}}</nowiki></code> || {{label|label=This is the header|description=This is the body text.}}
|-
| Header, body text and icon || <code><nowiki>{{label|label=This is the header|description=This is the body text.|icon=idea.png}}</nowiki></code> || {{label|label=This is the header|description=This is the body text.|icon=idea.png}}
|-
| Wiki-coding || <pre><nowiki>{{label
|label=Wiki-formatting for '''bold text''' is inverted in the header
|description=The ''other rows'' '''behave as''' '''''normal'''''. <br />
You can use wiki-code to, e.g.
[[link to stuff]],
* list things,
make text <small>small</small> or <big>big</big>,
 and include pre-format boxes.
You can even



insert empty rows.
|icon=idea.png}}</nowiki></pre> || {{label|label=Wiki-formatting for '''bold text''' is inverted in the header|description=The ''other rows'' '''behave as''' '''''normal'''''. <br />
You can use wiki-code to, e.g.
[[link to stuff]],
* list things,
make text <small>small</small> or <big>big</big>,
 and include pre-format boxes.
You can 
even



insert empty rows.|icon=idea.png}}
|}

===Incorrect use===
{| class="wikitable"
|-
! Example case !! What you write !! What you see
|-
| No parameters || <code><nowiki>{{label}}</nowiki></code> || {{label}}
|-
| No "label" parameter || <code><nowiki>{{label|description=This is the body text.|icon=idea.png}}</nowiki></code> || {{label||description=This is the body text.|icon=idea.png}}
|-
| Empty "label" parameter || <code><nowiki>{{label|label=|description=This is the body text.|icon=idea.png}}</nowiki></code> || {{label|label=|description=This is the body text.|icon=idea.png}}
|}

==See also==
* {{tl|Admon/caution}}
* {{tl|Admon/important}}
* {{tl|Admon/note}}
* {{tl|Admon/tip}}
* {{tl|message}}
** {{tl|message/box}}


<!-- Add categories below -->
<includeonly>
[[Category:Admonition templates|Label]]
[[Category:Message box templates]]
</includeonly>