No categories assigned

Notification Box


Template example: Notification box

To emphasize text passages, it is common to use a type of notifcation box.

In this example, we create a notification box that can be used to show a warning, a tip or a note:

boxnote-outputs.png

The color of the box and the box label change automatically depending on the type of box a user selects.

Creating the template

  1. Create the page Template:Box Note
  2. Add the template content and save the page:
    <div class="infobox notification-{{{boxtype}}}">
    <span class="boxlabel">
    {{#switch: {{{boxtype}}}
     | note = Note:
     | tip = Tip:
     | warning = Warning:
     | #default = Note:
    }}
    </span>
    {{{Note text}}}
    </div>
    
    What this code does:
  • The container (<div>...</div>) is used for styling the box. It has the style classes infobox and {{{boxtype}}}. The boxtype parameter provides the actual value the user chooses when using the template.
  • The <span>...</span> contains the label for the box. It displays the label for the box type the user chooses. It has the style class boxlabel which is used to format the label.
  • {{{Note text}}} is the placeholder for the actual text the user creates on a particular page.

To make it easy for users to insert and use this template in visual editing mode, we include a <templatedata> section in the template. It is wrapped in a <nowiki>...<nowiki> tag to ensure that this part of the template is not transcluded in the target page that uses the actual template. This template sections function is to describe the parameters of the template. It also populates the form for visual editing:

<div class="infobox notification-{{{boxtype}}}">
<span class="boxlabel">
{{#switch: {{{boxtype}}}
 | note = Note:
 | tip = Tip:
 | warning = Warning:
 | #default = Note:
}}
</span>
{{{Note text}}}
</div>

<noinclude>
<templatedata>
{
	"params": {
		"boxtype": {
			"description": "Possible values: note, tip, warning",
			"example": "note",
			"type": "string",
			"default": "note",
			"required": true
		},
		"Note text": {}
	},
	"description": "To add standard infoboxes such as notes or related links to a page"
}
</templatedata>
</noinclude>

What this code does:

  • It lists the two parameters (boxtype and Note text), separated by a comma.
  • It lists the parameter objects (optional): description, example, type, etc. For a full ist of template data objects, see www.mediawiki.org/wiki/Extension:TemplateData#Param_object
  • It describes the purpose of the template (description) so that users can distinguish it from similar templates.

Creating the template styles

To style the notification box, we have assigned three style classes:

  • infobox: Container for the infobox. We can specify layout properties such as border, background or padding
  • notification-{{{boxtype}}}: Used for color-coding the box based on what type of box a user wants to insert on a page.
  • boxlabel: Styling of the box label.

Since we want to load the styles only when this template is used on a page, we create the stylesheet page as a subpage of the template.

To create the styleheet:

  1. Create the stylesheet page:Template:Box Note/styles.css
  2. Add the styles and save the page:
/* Box Note*/
.infobox {
	padding: 1em;
	margin: 2em 0;
	border:1px solid #ccc;
}
.infobox p {
	padding: 0;
	margin: 0;
}
.boxlabel {	
	font-weight:bold;
	padding-right:0.5em;
}
.notification-note {
border-left: solid 4px #3498db;
}
.notification-tip {
border-left: solid 4px #f2c412;
}
.notification-warning {
border-left: solid 4px #c23c2b;
}


Now, add the reference to the stylesheet at the top of the template page (Template:Box Note) and save the template again:

<templatestyles src="Template:Box_Note/styles.css" />
<div class="infobox notification-{{{boxtype}}}">
    ....

Your template is now ready to use.

Using the template

To create a notification box on a page:

  1. Select Insert > Template in visual editing mode:
    template-insert.png
  2. Select the template Box Note and click Add template:
    template-insert-selecttemplate.png
  3. Enter the name for the type of box you want to create, for example note:
    template-insert-type.png
  4. Click Add more information
  5. Click Note text and enter the text for your notification box:
    template-insert-text.png
  6. Click Insert. The notification box is now included on your page:[File:boxnote-output-note.png|480x480px|center]]

Save the page if you have no further edits to make.

To later edit the notification in visual editing mode, simply double-click the notification and the template dialog window opens.




Attachments

Discussions