Jump to content

Template:Testcase rows/doc

From Simple English Wikipedia, the free encyclopedia

This template generates a test case table containing two or more templates arranged in rows. Each template is called with the same parameters. All parameters passed to this template are passed through to the test-case templates, with the exception of parameters starting with an underscore character ("_"), which are reserved for internal use.

If no templates are specified explicitly, the default templates are the base page of the current page and its /sandbox subpage. If only one template is specified explicitly, its /sandbox subpage is used as the second template.

Basic syntax

{{testcase rows
| [param1] = [value1]
| [param2] = [value2]
| [param3] = [value3]
...
}}

Full syntax

{{testcase rows
| _format      = 
| _class       = 
| _style       = 
| _caption     = 
| _collapsible = 
| _resetRefs   = 
| _code        = 
| _showcode    = 
| _showheader  = 

| _template      = 
| _template1     = 
| _showtemplate1 = 
| _heading1      = 
| _template2     = 
| _showtemplate2 = 
| _heading2      = 
| _template3     = 
| _showtemplate3 = 
| _heading3      = 
...

| [param1] = [value1]
| [param2] = [value2]
| [param3] = [value3]
...
}}

Parameters

[change source]
Parameter Description
_template1, _template2, _template3... The names of the templates to be processed. The default of _template1 is the base page of the current page. If _template1 is specified, the default for _template2 is its /sandbox subpage; if not, the default for _template2 is the /sandbox subpage of the base page of the current page. Template names should be entered as you would use them in a normal template invocation, i.e. "3x", not "Template:3x". If you need to test a page in the main namespace you can use a colon prefix, i.e. ":article name".
_template An alias for _template1. If both _template and _template1 are specified, _template will take precedence.
_showtemplate1, _showtemplate2, _showtemplate3... If this is set to "no", then no output is shown for that template. This is useful if you only want to show the main template, or if you only want to show the sandbox template.
_heading1, _heading2, _heading3... Custom headings for each of the templates.
_showheader If this is set to "no", then no headers are shown.
_class HTML classes for the table. Use |_class=wikitable to format the table as a wikitable.
_style Custom inline CSS for the table.
_caption Custom caption for the table. The default is "Side by side comparison".
_collapsible If set to "yes", the test case is made collapsible. The test case is collapsed and given a green heading if all the template outputs are the same. If any of the template outputs differ, the test case is expanded and given a yellow heading.
_resetRefs If set to "yes", any references generated by the templates tested are reset after each template is expanded.
_showcode Show the template code used to make the test case. If an invocation is specified with the _code parameter, then that is used. Otherwise, an approximation is generated from the arguments. This approximation is not perfect - whitespace in named arguments is lost, and duplicate arguments are ignored - but it should be fine for template code that is input all on one line without spaces between parameters.
_code Used to specify template code inside <nowiki>...</nowiki> tags. This is used with the _showcode option to display the template invocation while preserving whitespace. You must use the magic word "__TEMPLATENAME__" instead of the template name. For example: | _code = <nowiki>{{__TEMPLATENAME__|first|second|foo=bar}}</nowiki>. If you find yourself using this option a lot, you may want to consider using {{test case nowiki}}, which allows you to generate the entire test case from template code in nowiki tags, saving you from typing in all the arguments twice.

Note: due to the way nowiki tags work, the template treats the HTML entities &lt;, &gt; and &quot; as if they were the literal characters <, > and " when used with this parameter.

_format It is possible to use this parameter to display completely different formats, for example test cases arranged in rows. Different formats may accept different parameters from the ones listed above. For details, see the documentation of Template:Test case.

Example

[change source]
Usage
{{testcase rows
| _template = ombox
| image = [[File:Bad Title Example.png|40px]]
| imageright = [[File:Bad Title Example.png|40px]]
| text = Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut tristique sagittis cursus. Cras nibh elit, consectetur sed semper sollicitudin, lobortis nec elit. Morbi vitae neque non diam commodo faucibus. Phasellus volutpat diam orci. Praesent tempor scelerisque dapibus. Duis consectetur eros ut elit semper rutrum.
}}
Output
{{ombox}}
{{ombox/sandbox}}
[change source]

Templates invoking Module:Template test case: