模板:Testcase table/doc

该模板生成一个并排测试用例表，比较两个或多个模板。 每个模板都使用相同的参数进行调用。

传递到此模板的所有参数都会传递到测试用例模板，但以下划线字符（“_”）开头的参数除外，这些参数保留供内部使用。

如果未明确指定模板，则模块将使用当前页面的基页面作为第一个模板，使用其 /sandbox 子页面作为第二个模板。 如果仅显式指定一个模板，则其 /sandbox 子页面将用作第二个模板。

用法

基本语法

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

完整语法

{{Testcase table
| _format      = 
| _class       = 
| _style       = 
| _caption     = 
| _rowheader   = 
| _heading0    = 
| _before      = 
| _after       = 
| _collapsible = 
| _resetRefs   = 
| _code        = 
| _showcode    = 
| _showheader  = 

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

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

参数

Parameter	Description
_template1 _template2 （等）	要处理的模板的名称。 _template1 的默认值是当前页面的 {{basepage}}。 如果指定了 _template1，则 _template2 的默认值是其 /sandbox subpage； 如果不是，_template2 的默认值是当前页面基页的 /sandbox 子页面。 应按照在正常模板调用中使用模板名称的方式输入模板名称，即“3x”，而不是“Template:3x”。 如果您需要测试主命名空间中的页面，您可以使用冒号前缀，即“:article name”。
_template	_template1 的别名。 如果同时指定了 _template 和 _template1，则 _template 将优先。
_showtemplate1、_showtemplate2、_showtemplate3...	如果将此设置为“否”，则不会显示该模板的输出。 如果您只想显示主模板，或者只想显示沙箱模板，这非常有用。
_heading1 _heading2 （等）	每个模板的自定义标题。
_showheader	如果将此设置为“否”，则不显示任何标题。
_class	表的 HTML 类。 使用 |_class=wikitable 将表格格式化为 wikitable。
_style	表格的自定义内联 CSS。
_caption	表格的自定义标题。 默认为“并排比较”。
_rowheader	包含模板的行的额外标题。
_heading0	如果提供了 _rowheader，则这是模板行中其上方的可选标题。
_before，_after	该文本分别显示在每个模板的输出之前或之后。 这些参数本身不引入空格。
_collapsible	如果设置为“yes”，则测试用例可折叠。 如果所有模板输出都相同，则测试用例将折叠并给出绿色标题。 如果任何模板输出不同，则测试用例将展开并给出黄色标题。
_resetRefs	如果设置为“yes”，则在扩展每个模板后，将重置由测试的模板生成的任何引用。
_showcode	显示用于制作测试用例的模板代码。 如果使用 _code 参数指定调用，则使用该参数。 否则，将从参数生成近似值。 这种近似并不完美（命名参数中的空格会丢失；重复的参数会被忽略），但对于在一行上全部输入且参数之间没有空格的模板代码来说应该没问题。
_代码	用于指定 <nowiki>...</nowiki> 标签内的模板代码。 这与 _showcode 选项一起使用来显示模板调用，同时保留空格。 您必须使用魔术词“__TEMPLATENAME__”而不是模板名称。 例如：|_code=<nowiki>{{__TEMPLATENAME__|first|second|foo=bar}}</nowiki>。 如果您发现自己经常使用此选项，则可能需要考虑使用 {{Test case nowiki}}，它允许您从 nowiki 标记中的模板代码生成整个测试用例，从而无需输入所有参数 两次。 注意：由于 nowiki 标签的工作方式，模板会处理 HTML 实体 &lt;, &gt; 和&quot; 就好像它们是文字字符 <, > 和 " 与此参数一起使用时。
_format	可以使用此参数来显示完全不同的格式，例如按行排列的测试用例。 并非此处的所有参数都适用于其他格式。 有关详细信息，请参阅模板：测试用例的文档。

例子

示例1

使用 Template:解析数字 和 |_showcode=true

用法

{{Testcase table
|_template=Infobox
|_showcode=true
|_caption= 
|title=title |above=above
|header1=header1
|label2=label2 |data2=data2
|label3=label3 |data3=data3
|below=below
}}

输出

{{Infobox|label2=label2|data2=data2|title=title|below=below|label3=label3|data3=data3|header1=header1|above=above}}

{{Infobox}}	{{Infobox/sandbox}}
title above header1 label2 data2 label3 data3 below	title above header1 label2 data2 label3 data3 below

Example 2

using Template:Infobox, with |_showcode=true and |_caption= 

Usage

{{Testcase table
|_template=Infobox
|_showcode=true
|_caption= 
|title=title |above=above
|header1=header1
|label2=label2 |data2=data2
|label3=label3 |data3=data3
|below=below
}}

Output

{{Infobox|label2=label2|data2=data2|title=title|below=below|label3=label3|data3=data3|header1=header1|above=above}}

{{Infobox}}	{{Infobox/sandbox}}
title above header1 label2 data2 label3 data3 below	title above header1 label2 data2 label3 data3 below

Technical limitations

See Template:Test case#Technical limitations for this template's known technical limitations.

参见

• Template:Parameter names example