Template:Divbox

Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text").

Template documentation[view] [edit] [history] [purge]

This template can be used to create simple, flexible coloured text background.

Please note that this is intended to be a decorative template and not for use on the general encyclopedia. It will not display on articles.

Purpose[edit]

Wikipedia abounds in boxed templates, such as:

{{delete}}
{{tfd}}
{{GFDL}}
{{current}}
{{FAC}}

Boxes may not always be appropriate; they can be obtrusive. But when boxes are used, they are generally formatted ad hoc. This leads to inconsistencies.

{{Divbox}} provides a straightforward method of presenting any text within a box. Colors are selected using a private style keyword, which sets both box border and background, already chosen to work together, in a visual sense.

The keyword none puts your content inside an invisible box. This is available to offer the identical box model for your content, without a visible box.

This template may be used within another template; or as part of another page.

Usage[edit]

Template general syntax is as follows:

{{divbox|1=style|2=title|3=content|radius=}}

Parameters[edit]

1 (Style): Mandatory. Use any of the following:

Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). amber	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). black	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). bloodred	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). blue
Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). brown	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). forest	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). gold	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). gray
Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). green	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). navy	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). none	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). orange
Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). plain	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). purple	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). lilac	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). red
Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). white	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). yellow	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). fawn	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). tt
Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). simar	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). greenv	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). grayh	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). email
Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). double	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). wordperfect	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). ivory	Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). lavender

You can forgo "1=", as long as this is the first unnamed parameter in the list.
2 (Title): Optional. Plain text; appears strong and centered at top. You can forgo "2=", as long as this is the second unnamed parameter in the list.
3 (Content): Mandatory. Any text, including markup, that is to form the body of the message. You can forgo "3=", as long as this is the third unnamed parameter in the list, and the content does not contain an equals sign (=).
radius: Radius of the rounded edges, along with a valid unit, such as px, pt or em. The parameter works on styles that innately have both sharp or round edges, overriding their default edge roundness. You can forgo this entire parameter and its value; but if used, you cannot omit "radius=", which is case sensitive. However, like any named parameter, it may appear in any position (i.e. it does not need to be the last parameter).

Examples[edit]

What you see	What you type
gray: Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). Lorem ipsum Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.	`{{divbox\|gray\|Lorem ipsum\|Lorem ipsum dolor...}}`
red: Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). Lorem ipsum Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.	`{{divbox\|radius=5px\|red\|Lorem ipsum\|Lorem ipsum dolor...}}`
navy: Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). Lorem ipsum Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.	`{{divbox\|radius=10px\|navy\|Lorem ipsum\|Lorem ipsum dolor...}}`
amber: Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). Lorem ipsum Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.	`{{divbox\|radius=15px\|amber\|Lorem ipsum\|Lorem ipsum dolor...}}`
Without a border or background: Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). Lorem ipsum Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.	`{{divbox\|none\|Lorem ipsum\|Lorem ipsum dolor...}}`
Without title Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.	`{{divbox\|navy\|\|Lorem ipsum dolor...}}`
Content contains '=': Page Template:Divbox/styles.css must have content model "Sanitized CSS" for TemplateStyles (current model is "plain text"). Lorem ipsum Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.	`{{divbox\|lavender\|Lorem ipsum\|3=Lorem <span style="color:#F00;">ipsum</span> dolor...}}`

Using subst: with this template[edit]

The subst: atom may be used with {{divbox}}. This may be highly desirable. Note that subst: does not take effect in preview, but only after saving a page. The template's inclusion is replaced by the code of the template itself, which will continue to write the box as before, but without an additional server call.

Since {{divbox}} itself calls a template based on your choice of style keyword, you will find that even after saving an instance of use with subst: there remains a "live" call to the underlying style template. This means that viewing the page risks a server call to the style template, but also means that changes to the style template automatically propagate to all pages where it is used. This way, all {{divbox}}-type boxes, wherever they are in the project, keep the same consistent look.

Just paste in your content and, when you're finished, be sure to close the template call with }}.

Since the contents are given in the form of two parameter values, for the content you may place within {{divbox}}, the restrictions on parameter values apply. For example, if you put content that includes template calls, {{divbox}} cannot tell where its last parameter ends.

If the contents do not satisfy the restrictions, insert this code in your page first:

{{subst:divbox|keyword|title|DUMMYCONTENT}}

That is, choose your style and title as usual (or omit the title with two pipes), but instead of actual content, write "DUMMYCONTENT". Then, save the page and reopen it for editing. You'll see the box code in all its gory detail, and the placeholder DUMMYCONTENT, followed by the HTML division closing tag. Now, you may simply replace DUMMYCONTENT with your content, save, and move on. Since almost anything may be placed within division tags, this should not break no matter what you do.

Making new divbox styles[edit]

I'd rather hope you were able to find joy within the existing set of styles, but if not, you can create new ones. Follow these instructions to be sure your new style will "play nice" with {{divbox}}. Note that this requires some understanding of CSS.

Experiment in a drawing program, such as GraphicConverter or Adobe Photoshop, and decide what colors you want for your new box style. You need to find out the HTML color codes for each color.
Open an existing box style template, such as {{divbox/style/red}}. Copy out the code.
Create a new box style template page. It must be located in main Template namespace and must be named Template:divbox/style/XXXXX, where "XXXXX" is your new style name.
Paste in the "borrowed" code and replace the color codes with your new, chosen colors. Save the new template.
Return to this Talk page and add your new style to this documentation. Remember, a job's not over until the paperwork is done!

Note that you may even change the division box margins and paddings. This is not recommended. There are a couple of good reasons for specifying these values, and in these units. Most users who "roll their own" make choices with unintended consequences; {divbox} is meant to help you avoid these pitfalls.