模板: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