Template:Mbox/doc: Difference between revisions

Revision as of 08:55, 18 March 2024

{{TS/cmbox}}
{{TS/gibox}}
{{TS/ombox}}
{{Ambox}}
{{Gibox}}
{{mbox}}
{{Ombox}}

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:Mbox.

العربية ∙ asturianu ∙ Boarisch ∙ беларуская (тарашкевіца) ∙ български ∙ বাংলা ∙ català ∙ čeština ∙ dansk ∙ Deutsch ∙ Zazaki ∙ Ελληνικά ∙ English ∙ Esperanto ∙ español ∙ eesti ∙ euskara ∙ فارسی ∙ suomi ∙ français ∙ galego ∙ עברית ∙ हिन्दी ∙ hrvatski ∙ magyar ∙ Bahasa Indonesia ∙ italiano ∙ 日本語 ∙ ქართული ∙ 한국어 ∙ кыргызча ∙ Lëtzebuergesch ∙ македонски ∙ മലയാളം ∙ ဘာသာမန် ∙ Bahasa Melayu ∙ Mirandés ∙ မြန်မာဘာသာ ∙ norsk bokmål ∙ Plattdüütsch ∙ Nederlands ∙ norsk ∙ polski ∙ português ∙ português do Brasil ∙ русский ∙ sicilianu ∙ Scots ∙ slovenščina ∙ српски / srpski ∙ svenska ∙ ไทย ∙ Türkçe ∙ українська ∙ اردو ∙ oʻzbekcha / ўзбекча ∙ Tiếng Việt ∙ 中文 ∙ 中文（简体） ∙ 中文（繁體） ∙ 中文（臺灣） ∙ +/−

This is used to create message boxes.

Usage

Template parameters

Parameter	Description		Default	Status
`text`	text	The text to be displayed.	empty	required
`type`	type	Changes the color depending on the message needed. Each has its own preset image, see #Examples	notice	optional
`image`	left image	Override the image (“none” for no image). Use format: [[File:Commons-emblem-urgent.svg\|class=noviewer\|48px]]. The default depends on the type.	empty	optional
`imageright`	right image	Show an image on the right side, similar to the left one (but empty by default).	empty	optional
`textstyle`	text style	Override/augment default style of text cell (e.g. alignment — text-align:left; / text-align:right; / text-align:center;).	empty	optional
`style`	box style	Override/augment default style of the whole message box.	empty	optional
`class`	box class	Augment default CSS classes of the whole message box. Particularly useful if your template uses TemplateStyles.	empty	optional
`lang`	language	Set the language of the text – it's important for right-to-left languages: their image is on the right and imageright is on the left. It helps assistive software (e.g. screen readers) even in left-to-right languages.	empty	optional
`width`	box width	Set the width of the box (avoid using it, 80% for example is too large as it leaves only 10% of the page content width for the left/right margins where there may be floating elements generally large of about 250px: if this occurs the Mbox will be displayed at a much lower position on the page, as if there was a "clear:both", so Mbox may not be immediately visible without scrolling down the page with a huge blank space in the middle and all the rest of the page after the Mbox will be also invisible without scrolling). Instead, use the "margin" parameter to set horizontal margins. To avoid the centering, and/or the thick left border, modify e.g. “style=margin-left:0;border-left:2px solid #F4C430”	auto	optional
`margin`	horizontal margin	Set the horizontal margin of the box (by default it is "auto" if a legacy width is specified, otherwise it is "10%").	10%	optional

Template data

Parameter text is empty

TemplateData

TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.

Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either ‎useTemplateData=1 or ‎useTemplateData=only on the ‎/doc subpage and transcluding it with {{Documentation}} into the template. ‎<nowiki>-tags can be wrapped around the arguments, if required, to avoid templates being expanded.

Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw ‎<templatedata>-tags into the Wikitext of the template, as described in various Wikipediae.

Wikipedia's help about TemplateData • Commons-specific information

This is used to create message boxes.

Template parameters
This template prefers block formatting of parameters.
Parameter		Description	Type	Status
box class	`class`	Augment default CSS classes of the whole message box. Particularly useful if your template uses TemplateStyles.	Line	optional
left image	`image`	Override the image (“none” for no image). Use format: [[File:Commons-emblem-urgent.svg\|class=noviewer\|48px]]. The default depends on the type.	Content	optional
right image	`imageright`	Show an image on the right side, similar to the left one (but empty by default).	Content	optional
language	`lang`	Set the language of the text – it's important for right-to-left languages: their image is on the right and imageright is on the left. It helps assistive software (e.g. screen readers) even in left-to-right languages.	Line	optional
horizontal margin	`margin`	Set the horizontal margin of the box (by default it is "auto" if a legacy width is specified, otherwise it is "10%"). Default 10%	Line	optional
box style	`style`	Override/augment default style of the whole message box.	Line	optional
text	`text`	The text to be displayed.	Content	required
text style	`textstyle`	Override/augment default style of text cell (e.g. alignment — text-align:left; / text-align:right; / text-align:center;).	Line	optional
type	`type`	Changes the color depending on the message needed. Each has its own preset image, see the template documentation. Default notice	Line	optional
box width	`width`	Set the width of the box (avoid using it, 80% for example is too large as it leaves only 10% of the page content width for the left/right margins where there may be floating elements generally large of about 250px: if this occurs the Mbox will be displayed at a much lower position on the page, as if there was a "clear:both", so Mbox may not be immediately visible without scrolling down the page with a huge blank space in the middle and all the rest of the page after the Mbox will be also invisible without scrolling). Instead, use the "margin" parameter to set horizontal margins. To avoid the centering, and/or the thick left border, modify e.g. “style=margin-left:0;border-left:2px solid #F4C430” Default auto	Line	optional

Additional information

The template is intended to be used in the following namespaces: all namespaces

The template is intended to be used by the following user groups: all users

Localization

This template is not intended to be localized.

⧼Note⧽

The icon displayed in the message box is clickable and drives to Commons (to see its attributions), but only when the message box is displayed in a "Template:" page (including their talk pages). When the template is displayed in a page belonging to all other namespaces, no link is generated, only the icon is visible directly.