Template:Table cell templates/doc

The templates in this series are designed to be used in a table to make a cell with text in that cell, with an appropriately colored background. They are commonly used in comparison tables. Most of these templates should not be used simply to produce a background color, use them according to their meaning.

For example, makes a cell with a green background. The text in the cell is taken from the first parameter;  would output "Sure" otherwise it defaults to "Yes". Most templates allow authors to override the default text in this way, some require text put after the template call and some also need a vertical bar in between:  or. This information, the colors and default texts are found in the table below.

If you want to use other attributes for the table cells, e.g.,  , or  , they need to be put before the template call, and there must be no vertical bar (aka pipe)   in-between them:

... !Yes ||No ||rowspan=2 N/A ...
 * colspan=2 style="border:solid 3px Maroon" Yes-no
 * colspan=2 style="border:solid 3px Maroon" Yes-no

Code
Common code to most if not all the templates in this series:

Creating new templates
To make a new table cell template you can use:

You should leave out the  parameter and often the   parameter is unnecessary, too.

Add the new template to the table in the common documentation afterwards. Please consider reusing one of the other templates and please choose the color sensibly.

If you find a table cell template that does not take a parameter and you want to be able to change the text in the cell, do not duplicate the template! Instead, edit the template and change the text to a default parameter substitution. For example, if a template's text is, change that to.



Choosing a color
When changing or creating a new template, follow the use of colour guidelines and the color accessibility guidelines when choosing the background color and, sometimes, the text color. Many of these templates can be used with links to other articles or references, so the links should be clearly identifiable against the background color. You can check contrast level using the WebAIM contrast checker by setting the foreground color to the blue link color. Contrast should be at the minimum WCAG AA level and, whenever possible, at WCAG AAA level. Manual of Style/Accessibility/Colors has a set of colors that comply with WCAG AAA and WCAG AA for unvisited links and normal text.

Color subpage
All templates should either have a  subpage that contains nothing but a valid CSS color code, possibly wrapped in nowiki tags, e.g. , which can be included with   in the   attribute, or they should reference another template's subpage, e.g.  . Alternatively, the   subpage may redirect to another color code subpage:.

This way, pages that are using these templates may also use legend and similar templates which can reference the actual color:

TemplateData
{	"description": "One of several templates for styling individual table cells with standard contents and colors.", "format": "inline", "params": { "1": {			"label": "text", "description": "text to be displayed instead of the default; if this doesn't work put the text after the template, possibly with a vertical bar | in between", "type": "content", "default": "(template dependent)", "required": false, "suggested": false },		"align": { "label": "horizontal align", "description": "text alignment inside the cell, either 'left', 'right', 'center' or 'justified'", "default": "center", "inherits": "1", "type": "string", "suggested": false, "suggestedvalues": [ "left", "center", "right", "justified" ]		},		"style": { "label": "style", "description": "a semicolon-separated list of additional CSS rules to be applied to the table cell", "inherits": "1", "type": "string", "suggested": false },		"color": { "label": "background color", "description": "a valid CSS color value or name to override the standard cell background, only available with some templates", "inherits": "1", "type": "line", "suggested": false }	} }