Template:Mbox: Difference between revisions

From stencil.wiki
No edit summary
No edit summary
Line 39: Line 39:
"label": "Background",
"label": "Background",
"description": "Background color for the box (neutral grey if not specified). Embedded in the \"background\" CSS property.",
"description": "Background color for the box (neutral grey if not specified). Embedded in the \"background\" CSS property.",
"type": "string"
"type": "string",
"default": "#FFFFFF"
},
},
"border": {
"border": {
"label": "Border",
"label": "Border",
"description": "Border style for the box. Embedded in the \"border\" CSS property.",
"description": "Border style for the box. Embedded in the \"border\" CSS property.",
"type": "string"
"type": "string",
"default": "1px solid #F1F3F5"
},
},
"color_bar": {
"color_bar": {

Revision as of 17:37, 14 December 2024

Lightweight message box (maybe notice box) to implement top-off page warnings needed on some pages. It allows some color flags/styling to distinguish boxes from each other, but primarily only offers a title and body text.

Usage

This box should be used within message-specific templates (e.g. Template:Class template) which parse their own inputs into the display fields of the message box.

Plain boxes can be called with {{mbox}} while providing text and an optional title—they will auto-size to the width of their contents, and wrap text at full width. They can include markup and full wiki-text (including transcluding other templates).

{{mbox|text=Sample message text in a plain box.}}
Sample message text in a plain box.
{{mbox|title=Sample ''styled'' title|text=<p>A plain box with a title and '''some markup''' in the text and other templates like {{Ink chip|Light Teal}} or [[links]]. A bunch of extra text has been added to this section to show the text-wrapping within the box. The <code><p/></code> tags are included to make sure the ink chip displayed uses its small size.</p>}}
Sample styled title

A plain box with a title and some markup in the text and other templates like Light Teal or links. A bunch of extra text has been added to this section to show the text-wrapping within the box. The <p/> tags are included to make sure the ink chip displayed uses its small size.

Styling

The main differentiation provided is in a 10px color bar on the left side of the box, which can be set with color_bar. Both the background and border styles can be set, as well as a CSS class for the box or custom style. The max-width is provided at 80%, but can be set with max_width.

{{mbox|text=Sample message text in a plain box.|color_bar=#BB76CF}}
Orchid box
A box with an orchid side bar.

TemplateData

A simple message box. This template is meant to implement specific message boxes, not to be invoked directly.

Template parameters[Edit template data]

This template prefers block formatting of parameters.

ParameterDescriptionTypeStatus
Titletitle

Header text to be used at the top of the box—this will be displayed in bold.

Stringsuggested
Texttext

The body text of the message box.

Stringrequired
Color barcolor_bar

The color used for the left side bar of the box—no bar is displayed if left blank. Embedded in the "border-left" CSS property.

Stringoptional
Classclass

Custom class to add to the table.

Stringsuggested
Backgroundbackground

Background color for the box (neutral grey if not specified). Embedded in the "background" CSS property.

Default
#FFFFFF
Stringoptional
Borderborder

Border style for the box. Embedded in the "border" CSS property.

Default
1px solid #F1F3F5
Stringoptional
Max widthmax_width

The max width for the message box (should be percentage based).

Default
80%
Stringoptional
Stylestyle

Additional CSS styles embedded at the end of the inline styles for the box

Stringoptional