Cuando generas un documento Slides, es posible que algunas variables no tengan un valor en todos los proyectos. Esto puede hacer que permanezcan etiquetas, líneas vacías o filas de tablas que ya no tienen sentido.
Los modificadores te permiten controlar qué ocurre con estos elementos cuando falta la información asociada a una variable.
Slides admite tres modificadores:
Modificador | Qué hace |
| Oculta el texto estático asociado a una variable vacía |
| Añade un salto de línea únicamente cuando la variable siguiente tiene un valor |
| Elimina una fila completa de una tabla cuando una variable no tiene ningún valor |
⚠️ Estos modificadores son específicos de las plantillas de Slides. No los utilices en plantillas HTML.
1. Ocultar texto estático con && ... &&
Utiliza && ... && cuando una variable vaya acompañada de texto estático que solo deba aparecer cuando la variable tenga un valor.
Por ejemplo, imagina que tu plantilla contiene:
Día 6: $$days.6.title$$
Si el proyecto solo tiene cinco días, $$days.6.title$$ no tiene ningún valor. Sin embargo, el texto estático “Día 6:” podría seguir apareciendo.
Para evitarlo, coloca todo el contenido entre &&:
&&Día 6: $$days.6.title$$&&
Si existe el Día 6, el documento generado mostrará, por ejemplo:
Día 6: Salida
Si el Día 6 no existe, el contenido situado entre && se oculta. Por lo tanto, si esta es la única variable de la diapositiva, como en el ejemplo, la diapositiva no se generará.
⚠️ Todo el contenido situado entre && ... && debe utilizar la misma fuente, tamaño de fuente y color de fuente que la variable para que el modificador funcione correctamente.
💡 Utiliza && ... && para etiquetas, prefijos, signos de puntuación u otros textos fijos que solo tengan sentido cuando la variable asociada contenga información.
2. Evitar saltos de línea innecesarios con @@
Utiliza @@ cuando quieras que aparezca una nueva línea únicamente si la variable siguiente contiene información.
Coloca @@ inmediatamente antes de la variable.
Por ejemplo:
@@$$steps.1.description$$
⚠️ @@ debe utilizar la misma fuente, tamaño de fuente y color de fuente que la variable sobre la que queremos que actúe.
Si $$steps.1.description$$ tiene un valor, Ezus añade el salto de línea y muestra la descripción.
Si la variable no tiene ningún valor, no se añade el salto de línea innecesario.
Esto resulta útil cuando se muestran varios elementos de información opcionales en la misma área de texto y quieres evitar líneas vacías en el documento generado.
💡 Utiliza @@ cuando la información opcional aparezca en líneas separadas, como descripciones o detalles adicionales que pueden no estar completados en todos los proyectos.
3. Eliminar una fila vacía de una tabla con #--#
Utiliza #--# cuando una variable esté situada dentro de una tabla y quieras que desaparezca toda la fila si esa variable no tiene ningún valor.
Coloca #--# antes de la variable que determina si debe mostrarse la fila.
Por ejemplo:
#--#$$days.6.title$$
Si $$days.6.title$$ tiene un valor, la fila permanece en el documento generado.
Si la variable no tiene ningún valor, Ezus elimina toda la fila de la tabla.
Esto evita que las tablas contengan filas vacías cuando no hay información opcional disponible.
💡 Utiliza #--# cuando toda la fila dependa de una información concreta. Elige la variable que mejor determine si esa fila debe existir.
4. ¿Qué modificador debo utilizar?
Elige el modificador según el elemento que quieras controlar:
Si quieres... | Utiliza |
Ocultar una etiqueta u otro texto estático cuando su variable esté vacía |
|
Evitar un salto de línea innecesario cuando la información opcional esté vacía |
|
Eliminar una fila completa de una tabla cuando la información esté vacía
|
|
5. Prueba tus modificadores
Después de añadir un modificador, genera el documento para comprobar su comportamiento.
Para realizar una prueba fiable, utiliza:
Un proyecto en el que la variable tenga un valor.
Un proyecto en el que esa misma variable no tenga ningún valor.
Comprueba que el contenido aparezca correctamente cuando exista información y desaparezca de forma limpia cuando no exista.
⚠️ Probar únicamente con un proyecto en el que todos los campos estén completos no confirma que un modificador funcione correctamente. También debes comprobar qué ocurre cuando falta la información correspondiente.
💡 Si un modificador no se comporta como esperabas, comprueba primero si la variable asociada realmente tiene un valor en el proyecto. Para && ... && y @@, comprueba también que el contenido y la variable utilicen el mismo formato.