Bản mẫu:Test case

Tài liệu bản mẫu[xem] [sửa] [lịch sử] [làm mới]

Đối với phiên bản cú pháp kế thừa của bản mẫu này, xem Bản mẫu:Testcase.

This template generates a test case for two or more templates. Each template is called with the same parameters, and the test case can be displayed in various different formats.

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 module uses the base page of the current page as the first template, and its /sandbox subpage as the second template. If only one template is specified explicitly, its /sandbox subpage is used as the second template.

Cách sử dụng

Cú pháp cơ bản

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

Cú pháp phổ thông

The following options will work with all different test case formats.

{{test case
| _format      = 
| _collapsible = 
| _resetRefs   = 
| _code        = 
| _showcode    = 

| _template  = 
| _template1 = 
| _heading1  = 
| _template2 = 
| _heading2  = 
| _template3 = 
| _heading3  = 
...

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

Some test case formats accept additional parameters as well. See their sections for documentation.

Các tham số phổ thông

Tham số	Miêu tả
_format	The format to display the test cases in. This can be "columns", "rows", "inline" or "default".
_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 "Bản mẫu: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.
_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.

Định dạng trường hợp kiểm thử

Mặc định

The default test case format looks like this:

{{ombox}}

{{ombox/sandbox}}

It doesn't have any extra parameters.

Cột

The columns format arranges the test cases side by side in a table. This is useful for comparing long and thin templates such as infoboxes. It has the following extra parameters:

Tham số	Miêu tả
_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".
_rowheader	An extra heading for the row containing the templates.
_heading0	If _rowheader is supplied, this is an optional heading above it in the template row.
_before	This text is displayed before the output of each template.
_after	This text is displayed after the output of each template.

Ví dụ

So sánh hai bên

{{ombox}}	{{ombox/sandbox}}

Hàng

The rows format arranges the test cases in rows in a table. It has the following extra parameters:

Tham số	Miêu tả
_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.

Ví dụ

{{ombox}}

{{ombox/sandbox}}

Nội tuyến

The inline format is for test cases that can be displayed entirely on one line. If used with templates that display on multiple lines it may produce unexpected results. It doesn't have any extra parameters.

Ví dụ (sử dụng Bản mẫu:3x)

Mặc định:

• Lorem ipsum Lorem ipsum Lorem ipsum

Có _showcode:

• {{3x|Lorem ipsum }} → Lorem ipsum Lorem ipsum Lorem ipsum
• {{3x/sandbox|Lorem ipsum }} →

Note: As this format starts with a bullet, a newline will always be inserted at the start of the template output due to bug 14974.

Các trường hợp kiểm thử đóng mở

You can use |_collapsible=yes with any format to turn it into a collapsible test case. If all the template outputs are the same the test case is collapsed and given a green heading. If any of the template outputs differ, the test case is expanded and given a yellow heading. You can set a custom title for collapsible test cases with the |_title= parameter.

Ví dụ

{{ombox}}

{{ombox}}

{{ombox/sandbox}}

Using the columns format

So sánh hai bên

{{ombox}}	{{ombox/sandbox}}

Using the rows format

{{ombox}}

{{ombox/sandbox}}

Ví dụ về đầu ra khác nhau

{{ombox}}

{{tmbox}}

Các ví dụ

Có _showcode

Cách sử dụng

{{test case|_template1=ombox|_showcode=yes|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.}}

Đầu ra

{{ombox|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.}}

{{ombox}}

{{ombox/sandbox}}

Có _showcode, sử dụng 1 nowiki đang gọi qua _code

Cách sử dụng

{{test case|_template1=ombox|_showcode=yes
|_code = 
<nowiki>{{__TEMPLATENAME__
| text = Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
}}</nowiki>
|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
}}

Đầu ra

{{ombox
| text = Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
}}

{{ombox}}

{{ombox/sandbox}}

Có _showcode và _collapsible

Cách sử dụng

{{test case|_template1=ombox|_showcode=yes|_collapsible=yes|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.}}

Đầu ra

{{ombox}}

{{ombox|text=Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.}}

{{ombox}}

{{ombox/sandbox}}

Hạn chế kỹ thuật

The template has the following known technical limitations:

• An error will be generated if processing the entire page takes more than 10 seconds. This is an intentional limit in the Scribunto extension that runs Mô đun:Template test case, on which this template is based. If a test cases page takes more than 10 seconds to load, you may need to split it up into different pages.
• When generating the template code used with |_showcode= whitespace in named parameters is ignored, numbered parameters like |1= may be incorrectly displayed as positional parameters, and duplicate parameters are ignored. This is due to how template parameters are processed before they are passed to Mô đun:Template test case.
• When using a template invocation inside nowiki tags with the |_code= parameter, the HTML entities &lt;, &gt; and &quot; are converted to the literal characters <, > and ". This is due to the way nowiki tags work.
• For collapsible test cases, all text inside extension tags (e.g. <ref>, <references>, <gallery> and <nowiki>) is treated as equal. These tags are converted to strip markers before they are passed to the template, and all strip markers include a random string as they have to be unique. Even if strip markers were unstripped before being compared, the same wikitext would not be guaranteed to result in exactly the same unstripped code. So this module ignores the content of strip markers for the purposes of testing equality. This has the unwanted side effect that, e.g. Some text<ref>foo</ref> is treated as equal to Some text<gallery>bar</gallery>, but should be adequate for most uses.

Xem thêm

Bản mẫu đang gọi Mô đun:Template test case:

• Bản mẫu:Testcase rows – cho một bảng của các trường hợp kiểm thử được sắp xếp thành hàng
• Bản mẫu:Testcase table – cho một bảng của các trường hợp kiểm thử được sắp xếp thành cột
• Bản mẫu:Inline test case – cho các trường hợp kiểm thử với đang gọi nhỏ và đầu ra nhỏ
• Bản mẫu:Collapsible test case – cho các trường hợp kiểm thử bị sập theo mặc định nếu kết quả tương tự
• Bản mẫu:Test case nowiki – cho các trường hợp kiểm thử từ bản mẫu đang gọi đính kèm trong thẻ <nowiki>...</nowiki>

Tài liệu bên trên được truyền tải từ Bản mẫu:Test case/doc. (sửa | lịch sử)
Biên tập viên sửa đổi có thể thử nghiệm trong các trang chỗ thử (tạo | sao) và trường hợp kiểm thử (tạo) của bản mẫu này.
Xin hãy bổ sung các thể loại vào trang con /doc. Các trang con của bản mẫu này.