Esta plantilla genera un caso de prueba para dos o más plantillas. Cada plantilla se llama con los mismos parámetros y el caso de prueba se puede mostrar en distintos formatos.
Todos los parámetros pasados a esta plantilla se pasan a las plantillas de casos de prueba, con la excepción de los parámetros que comienzan con un carácter de subrayado ("_"), que están reservados para uso interno.
Si no se especifica ninguna plantilla explícitamente, el módulo utiliza la página base de la página actual como primera plantilla y su subpágina /sandbox como segunda plantilla. Si solo se especifica una plantilla explícitamente, se utiliza su subpágina /sandbox como segunda plantilla.
Sintaxis básica
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
{{caso de prueba| [param1] = [valor1]|[param2] = [valor2]|[param3] = [valor3]...}}Sintaxis común
Las siguientes opciones funcionarán con todos los diferentes formatos de casos de prueba.
{{caso de prueba| _formato =|_salida=|_plegable=|_resetRefs=|_código=| _mostrar código =|_plantilla=|_plantilla1=| _encabezado1 =|_plantilla2=| _encabezado2 =|_plantilla3=| _encabezado3 =...| [param1] = [valor1]|[param2] = [valor2]|[param3] = [valor3]...}}Algunos formatos de casos de prueba también aceptan parámetros adicionales. Consulta sus secciones para obtener documentación.
Este formato se utiliza cuando _formatno se especifica o cuando |_format=defaultno tiene parámetros adicionales.
Ejemplo
{{ ombox }}
{{ ombox/sandbox }}
Se utiliza |_format=columnspara organizar los casos de prueba uno al lado del otro en una tabla. Esto resulta útil para comparar plantillas largas y delgadas, como los cuadros de información. Tiene los siguientes parámetros adicionales:
Ejemplo
Utilice |_format=rowso |_format=tablerowspara organizar los casos de prueba uno encima del otro en una tabla. Estos dos formatos se diferencian en la ubicación de los encabezados: rowslos coloca arriba, mientras que tablerowsa la izquierda de los resultados de la plantilla. Tiene los siguientes parámetros adicionales:
Ejemplo – filas
Ejemplo – hileras de árboles
Úselo |_format=inlinepara casos de prueba que se puedan mostrar completamente en una línea. Si se usa con plantillas que se muestran en varias líneas, puede producir resultados inesperados. Este formato crea una lista con viñetas al colocarla *antes de cada línea de salida. Tiene los siguientes parámetros adicionales:
Nota: Como este formato comienza con una viñeta, siempre se insertará una nueva línea al comienzo de la salida de la plantilla debido al error 14974.
Ejemplos (utilizando la plantilla:3x )
Por defecto:
Con |_showcode=yes:
{{3x|Lorem ipsum }}→ Lorem ipsum Lorem ipsum Lorem ipsum{{3x/sandbox|Lorem ipsum }}→ Lorem ipsum Lorem ipsum Lorem ipsumEjemplo (usando Template:Height )
Con |_prefix=#y |_addline=:
{{Height|m=1.51}}→ 1,51 m (4 pies 11 pulgadas)+1 ⁄ 2 pulgada){{Height/sandbox|m=1.51}}→ 1,51 m (4 pies 11 pulgadas)+1 ⁄ 2 pulgada){{Cvt|1.51|m|frac=2}}→ 1,51 m (4 pies 11 pulgadas)+1 ⁄ 2 pulgada)El _outputparámetro permite realizar cambios en la forma en que se muestra la salida de la plantilla. Debería funcionar con cualquiera de los formatos de casos de prueba; los siguientes ejemplos utilizan |format=tablerows.
La salida predeterminada se muestra cuando _outputno se especifica el parámetro o cuando se establece en cualquier valor no admitido; este ejemplo utiliza |_output=default.
Se muestra una versión nowiki|_output=nowiki del resultado de la plantilla cuando se ejecuta . Esto resulta útil si existen diferencias en el wikitexto subyacente que no son visibles en el resultado predeterminado.
Tanto la salida predeterminada como la versión nowiki se muestran cuando |_output=nowiki+.
Si _collapsiblese establece en "y" o "sí", el caso de prueba se vuelve contraíble. El caso de prueba se contrae y se le asigna un encabezado verde si todas las salidas de plantilla son iguales. Si alguna de las salidas de plantilla difiere, el caso de prueba se expande y se le asigna un encabezado amarillo. Tiene los siguientes parámetros adicionales:
Ejemplos
{{ ombox }}
{{ ombox/sandbox }}
Esto es útil para plantillas con una pequeña cantidad de parámetros. Muestra el código de la plantilla en el título, lo que elimina la necesidad de utilizar tanto |_title=y |_showcode=yes. Para ver las pruebas reales implementadas con |_titlecode=yes, consulte Template:URL/testcases .
Si |_notcollapsed=yes, el caso de prueba siempre se expandirá al cargar la página. Esta configuración anula la funcionalidad predeterminada en la que el caso de prueba se contrae a menos que dos o más salidas no coincidan. El siguiente ejemplo normalmente estaría contraído, como lo indica el fondo verde del título:
Si |_notcollapsed=no, el caso de prueba siempre se contraerá al cargar la página. Esta configuración anula la funcionalidad predeterminada en la que el caso de prueba se contrae a menos que dos o más salidas no coincidan. Lo siguiente normalmente se expandiría, como lo indica el fondo amarillo del título:
{{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.}}{{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 }}
{{caso de prueba|_template1=ombox|_showcode=sí|_código =<nowiki>{{__NOMBREDEPLANTILLA__| 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.}}{{buzón de entrada| 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 }}
{{caso de prueba|_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.}}{{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 }}
La plantilla tiene las siguientes limitaciones técnicas conocidas:
|_showcode=Al generar el código de plantilla , se ignoran los espacios en blanco utilizados en los parámetros nombrados, los parámetros numerados como |1=pueden mostrarse incorrectamente como parámetros posicionales y se ignoran los parámetros duplicados. Esto se debe a la forma en que se procesan los parámetros de plantilla antes de pasarlos al caso de prueba Módulo:Plantilla .|_code=parámetro, las entidades HTML <, > y " se convierten en los caracteres literales <, > y ". Esto se debe a la forma en que funcionan las etiquetas nowiki.<ref>, <references>, <gallery>o <nowiki>) se trata como igual. Estas etiquetas se convierten en marcadores de tira antes de pasarlas a la plantilla, y todos los marcadores de tira incluyen una cadena hexadecimal única. Incluso si los marcadores de tira se despojaran antes de compararlos, no se garantizaría que el mismo wikitexto dé como resultado exactamente el mismo código despojado. Por lo tanto, este módulo ignora el contenido de los marcadores de tira a los efectos de probar la igualdad. Esto tiene el efecto secundario no deseado de que, por ejemplo, todas <ref>...</ref>las etiquetas se tratan como si fueran iguales, pero debería ser adecuado para la mayoría de los usos.Plantillas que invocan el caso de prueba Módulo:Plantilla :
<nowiki>...</nowiki>etiquetas