Этот шаблон генерирует тестовый случай для двух или более шаблонов. Каждый шаблон вызывается с теми же параметрами, и тестовый случай может отображаться в различных форматах.
Все параметры, переданные в этот шаблон, передаются в шаблоны тестовых случаев, за исключением параметров, начинающихся с символа подчеркивания («_»), которые зарезервированы для внутреннего использования.
Если явно не указаны шаблоны, модуль использует базовую страницу текущей страницы в качестве первого шаблона, а ее подстраницу /sandbox — в качестве второго шаблона. Если явно указан только один шаблон, его подстраница /sandbox используется в качестве второго шаблона.
Базовый синтаксис
{{тестовый случай| [параметр1] = [значение1]| [параметр2] = [значение2]| [параметр3] = [значение3]...}}
Общий синтаксис
Следующие параметры будут работать со всеми различными форматами тестовых случаев.
{{тестовый случай| _формат =| _вывод =| _складной =| _resetRefs =| _код =| _showcode =| _шаблон =| _шаблон1 =| _заголовок1 =| _шаблон2 =| _heading2 =| _шаблон3 =| _heading3 =...| [параметр1] = [значение1]| [параметр2] = [значение2]| [параметр3] = [значение3]...}}
Некоторые форматы тестовых случаев также принимают дополнительные параметры. Смотрите их разделы для документации.
Этот формат используется, когда _format
не указан или когда |_format=default
. Он не имеет дополнительных параметров.
Пример
{{ ombox }}
{{ ombox/песочница }}
Используйте |_format=columns
для размещения тестовых случаев рядом в таблице. Это полезно для сравнения длинных и тонких шаблонов, таких как инфобоксы. Имеет следующие дополнительные параметры:
Пример
Используйте |_format=rows
или |_format=tablerows
для расположения тестовых случаев друг над другом в таблице. Эти два формата отличаются размещением заголовков: rows
помещает их выше, тогда как tablerows
слева от шаблона выводит. Имеет следующие дополнительные параметры:
Пример – строки
Пример – строки таблиц
Используйте |_format=inline
для тестовых случаев, которые могут быть отображены полностью на одной строке. Если использовать с шаблонами, которые отображаются на нескольких строках, это может привести к неожиданным результатам. Этот формат создает маркированный список , помещая его *
перед каждой строкой вывода. Он имеет следующие дополнительные параметры:
Примечание: поскольку этот формат начинается с маркера, в начале вывода шаблона всегда будет вставлена новая строка из-за ошибки 14974.
Примеры (используя Template:3x )
По умолчанию:
С |_showcode=yes
:
{{3x|Lorem ipsum }}
→ Lorem ipsum Lorem ipsum Lorem ipsum{{3x/sandbox|Lorem ipsum }}
→ Lorem ipsum Lorem ipsum Lorem ipsumПример (используя Template:Height )
С |_prefix=#
и |_addline=
:
{{Height|m=1.51}}
→ 1,51 м (4 фута 11 дюймов)+1 ⁄ 2 дюйма){{Height/sandbox|m=1.51}}
→ 1,51 м (4 фута 11 дюймов)+1 ⁄ 2 дюйма){{Cvt|1.51|m|frac=2}}
→ 1,51 м (4 фута 11 дюймов)+1 ⁄ 2 дюйма)Параметр _output
позволяет изменять способ отображения выходных данных шаблона. Он должен работать с любым из форматов тестовых случаев; в следующих примерах используется |format=tablerows
.
Выходные данные по умолчанию отображаются, если _output
параметр не указан или ему присвоено неподдерживаемое значение; в этом примере используется |_output=default
.
Версия шаблона nowiki отображается, когда . Это полезно, если в базовом вики-тексте|_output=nowiki
есть различия , которые не видны в выводе по умолчанию.
При этом отображаются как вывод по умолчанию, так и версия nowiki |_output=nowiki+
.
Если _collapsible
установлено значение "y" или "yes", тестовый случай делается сворачиваемым. Тестовый случай сворачивается и получает зеленый заголовок, если все выходные данные шаблона одинаковы. Если какие-либо выходные данные шаблона отличаются, тестовый случай разворачивается и получает желтый заголовок. Он имеет следующие дополнительные параметры:
Примеры
{{ ombox }}
{{ ombox/песочница }}
Это полезно для шаблонов с небольшим количеством параметров. Он отображает код шаблона в заголовке, устраняя необходимость в обоих |_title=
и |_showcode=yes
. Для реальных тестов, реализованных с |_titlecode=yes
, см. Template:URL/testcases .
Если |_notcollapsed=yes
, то тестовый случай всегда будет развернут при загрузке страницы. Эта настройка переопределяет функциональность по умолчанию, в которой тестовый случай сворачивается, если только два или более выходных данных не совпадают. Следующий пример обычно сворачивается, как указано зеленым фоном заголовка:
Если |_notcollapsed=no
, то тестовый случай всегда будет сворачиваться при загрузке страницы. Эта настройка переопределяет функциональность по умолчанию, в которой тестовый случай сворачивается, если только два или более выходных данных не совпадают. Обычно следующее будет развернуто, как указано желтым фоном заголовка:
{{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 nostrum ullamco Laboris Nisi ut aliquip ex ea commodo consequat.}}
{{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 nostrum ullamco Laboris Nisi ut aliquip ex ea commodo consequat.}}
{{ ombox }}
{{ ombox/песочница }}
{{тестовый случай|_template1=ombox|_showcode=yes|_код =<nowiki>{{__TEMPLATENAME__| текст = 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 nostrum 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 nostrum ullamco Laboris Nisi ut aliquip ex ea commodo consequat.}}
{{омбокс| текст = 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 nostrum ullamco Laboris Nisi ut aliquip ex ea commodo consequat.}}
{{ ombox }}
{{ ombox/песочница }}
{{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 nostrum ullamco Laboris Nisi ut aliquip ex ea commodo consequat.}}
{{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 nostrum ullamco Laboris Nisi ut aliquip ex ea commodo consequat.}}
{{ ombox }}
{{ ombox/песочница }}
Шаблон имеет следующие известные технические ограничения:
|_showcode=
пробелами в именованных параметрах, игнорируется, нумерованные параметры, такие как, |1=
могут быть неправильно отображены как позиционные параметры, а дублирующиеся параметры игнорируются. Это связано с тем, как параметры шаблона обрабатываются перед передачей в тестовый случай Module:Template .|_code=
параметром HTML-сущности <, > и " преобразуются в буквенные символы <, > и ". Это связано со способом работы тегов nowiki.<ref>
, <references>
, <gallery>
или <nowiki>
) рассматривается как равный. Эти теги преобразуются в маркеры полосы перед передачей в шаблон, и все маркеры полосы включают уникальную шестнадцатеричную строку. Даже если маркеры полосы были неразделены перед сравнением, тот же викитекст не гарантированно приведет к точно такому же неразделенному коду. Поэтому этот модуль игнорирует содержимое маркеров полосы для целей проверки равенства. Это имеет нежелательный побочный эффект, например, все <ref>...</ref>
теги рассматриваются как равные, но должно быть достаточно для большинства случаев использования.Шаблоны, вызывающие тестовый пример Module:Template :
<nowiki>...</nowiki>
теги