Template:Table cell templates/doc: Difference between revisions

From FamilySearch Wiki
(Created page with "<noinclude>{{Documentation subpage}}</noinclude> The templates in this series are designed to be used in a table to make a cell with text in that cell, with an ap…")
 
No edit summary
 
Line 29: Line 29:


To make a new table cell template you can use:
To make a new table cell template you can use:
<source lang=text>{{subst:Table cell templates| text = default text | bg = background color | class = a class name without prefix | align = standard horizontal alignment}}</source>
<source lang=text>style="background: background color; color: black; vertical-align: middle; text-align: <nowiki>{{{align|</nowiki>standard horizontal alignment<nowiki>}}}</nowiki>; <nowiki>{{{style|}}}</nowiki>" class="a class name without prefix table-a class name without prefix"| <nowiki>{{{1|</nowiki>default text<nowiki>}}}</nowiki></source>


You should leave out the <code>align</code> parameter and often the <code>class</code> parameter is unnecessary, too.
You should leave out the <code>align</code> parameter and often the <code>class</code> parameter is unnecessary, too.
Line 36: Line 36:


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 <code>Dropped</code>, change that to <code><nowiki>{{{1|Dropped}}}</nowiki></code>.
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 <code>Dropped</code>, change that to <code><nowiki>{{{1|Dropped}}}</nowiki></code>.
=== See also ===
* {{Tl|multiplayer}}
* {{Tl|GPL-lic}}
* {{Tl|chg}}: calculate and display changes between two values
=== Notes ===
{{Reflist}}


<!-- ADD CATEGORIES BELOW THIS LINE -->
<!-- ADD CATEGORIES BELOW THIS LINE -->

Latest revision as of 13:39, 25 November 2011

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.

For example, {{yes}} makes a cell with a green background. The text in the cell is taken from the first parameter; {{yes|Sure}} 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: {{table cell template}} text or {{table cell template}} | text. 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. colspan or rowspan, they need to be put before the template call and there must be no vertical bar | in between them:

Yes No N/A
Yes/No
...
!{{Yes}} ||{{No}} ||rowspan=2 {{n/a}}
|-
|colspan=2 {{Yes-No}}
...


Code[edit source]

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

style="background: #abcdef; color: black; vertical-align: middle; text-align: {{{align|center}}}; {{{style|}}}" class="automatic table-automatic"| {{{1|text}}}

Code specific to this template:

style="background: white; color: black; vertical-align: middle; text-align: {{{align|center}}}; {{{style|}}}" class="Table cell templates table-Table cell templates"| {{{1|{{{text}}}}}}

To make a new table cell template you can use:

style="background: background color; color: black; vertical-align: middle; text-align: <nowiki>{{{align|</nowiki>standard horizontal alignment<nowiki>}}}</nowiki>; <nowiki>{{{style|}}}</nowiki>" class="a class name without prefix table-a class name without prefix"| <nowiki>{{{1|</nowiki>default text<nowiki>}}}</nowiki>

You should leave out the align parameter and often the class 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 Dropped, change that to {{{1|Dropped}}}.