#Conditional Statements

Conditional statements allow you to dynamically control the display or hiding of content in the document based on data values. There are three main ways to write conditions:

• Inline conditions: Directly output text (or replace it with other text).
• Conditional blocks: Display or hide a section of the document, suitable for multiple tags, paragraphs, tables, etc.
• Smart conditions: Directly remove or keep target elements (like rows, paragraphs, images, etc.) with a single tag, for a more concise syntax.

All conditions begin with a logical evaluation formatter (e.g., ifEQ, ifGT, etc.), followed by action formatters (such as show, elseShow, drop, keep, etc.).

#Overview

The logical operators and action formatters supported in conditional statements include:

• Logical Operators

  • ifEQ(value): Checks if the data is equal to the specified value.
  • ifNE(value): Checks if the data is not equal to the specified value.
  • ifGT(value): Checks if the data is greater than the specified value.
  • ifGTE(value): Checks if the data is greater than or equal to the specified value.
  • ifLT(value): Checks if the data is less than the specified value.
  • ifLTE(value): Checks if the data is less than or equal to the specified value.
  • ifIN(value): Checks if the data is contained in an array or string.
  • ifNIN(value): Checks if the data is not contained in an array or string.
  • ifEM(): Checks if the data is empty (e.g., null, undefined, an empty string, an empty array, or an empty object).
  • ifNEM(): Checks if the data is non-empty.
  • ifTE(type): Checks if the data type is equal to the specified type (for example, "string", "number", "boolean", etc.).
  • and(value): Logical "and", used to connect multiple conditions.
  • or(value): Logical "or", used to connect multiple conditions.

• Action Formatters

  • :show(text) / :elseShow(text): Used in inline conditions to directly output the specified text.
  • :hideBegin / :hideEnd and :showBegin / :showEnd: Used in conditional blocks to hide or show sections of the document.
  • :drop(element) / :keep(element): Used in smart conditions to remove or keep specified document elements.

The following sections introduce the detailed syntax, examples, and results for each usage.

#Inline Conditions

#1. :show(text) / :elseShow(text)

#Syntax

{data:condition:show(text)}
{data:condition:show(text):elseShow(alternative text)}

#Example

Assume the data is:

{
  "val2": 2,
  "val5": 5
}

The template is as follows:

val2 = {d.val2:ifGT(3):show('high')}
val2 = {d.val2:ifGT(3):show('high'):elseShow('low')}
val5 = {d.val5:ifGT(3):show('high')}

#Result

val2 = 2
val2 = low
val5 = high

#2. Switch Case (Multiple Conditionals)

#Syntax

Use consecutive condition formatters to build a structure similar to a switch-case:

{data:ifEQ(value1):show(result1):ifEQ(value2):show(result2):elseShow(default result)}

Or achieve the same with the or operator:

{data:ifEQ(value1):show(result1):or(data):ifEQ(value2):show(result2):elseShow(default result)}

#Example

Data:

{
  "val1": 1,
  "val2": 2,
  "val3": 3
}

Template:

val1 = {d.val1:ifEQ(1):show(A):ifEQ(2):show(B):elseShow(C)}
val2 = {d.val2:ifEQ(1):show(A):ifEQ(2):show(B):elseShow(C)}
val3 = {d.val3:ifEQ(1):show(A):ifEQ(2):show(B):elseShow(C)}

#Result

val1 = A
val2 = B
val3 = C

#3. Multi-variable Conditionals

#Syntax

Use the logical operators and/or to test multiple variables:

{data1:ifEQ(condition1):and(.data2):ifEQ(condition2):show(result):elseShow(alternative result)}
{data1:ifEQ(condition1):or(.data2):ifEQ(condition2):show(result):elseShow(alternative result)}

#Example

Data:

{
  "val2": 2,
  "val5": 5
}

Template:

and = {d.val2:ifEQ(1):and(.val5):ifEQ(5):show(OK):elseShow(KO)}
or = {d.val2:ifEQ(1):or(.val5):ifEQ(5):show(OK):elseShow(KO)}

#Result

and = KO
or = OK

#Logical Operators and Formatters

In the following sections, the described formatters use the inline condition syntax with the following format:

{data:formatter(parameter):show(text):elseShow(alternative text)}

#1. :and(value)

#Syntax

{data:ifEQ(value):and(new data or condition):ifGT(another value):show(text):elseShow(alternative text)}

#Example

{d.car:ifEQ('delorean'):and(.speed):ifGT(80):show('TravelInTime'):elseShow('StayHere')}

#Result

If d.car equals 'delorean' and d.speed is greater than 80, the output is TravelInTime; otherwise, the output is StayHere.

#2. :or(value)

#Syntax

{data:ifEQ(value):or(new data or condition):ifGT(another value):show(text):elseShow(alternative text)}

#Example

{d.car:ifEQ('delorean'):or(.speed):ifGT(80):show('TravelInTime'):elseShow('StayHere')}

#Result

If d.car equals 'delorean' or d.speed is greater than 80, the output is TravelInTime; otherwise, the output is StayHere.

#3. :ifEM()

#Syntax

{data:ifEM():show(text):elseShow(alternative text)}

#Example

null:ifEM():show('Result true'):elseShow('Result false')
[]:ifEM():show('Result true'):elseShow('Result false')

#Result

For null or an empty array, the output is Result true; otherwise, it is Result false.

#4. :ifNEM()

#Syntax

{data:ifNEM():show(text):elseShow(alternative text)}

#Example

0:ifNEM():show('Result true'):elseShow('Result false')
'homer':ifNEM():show('Result true'):elseShow('Result false')

#Result

For non-empty data (such as the number 0 or the string 'homer'), the output is Result true; for empty data, the output is Result false.

#5. :ifEQ(value)

#Syntax

{data:ifEQ(value):show(text):elseShow(alternative text)}

#Example

100:ifEQ(100):show('Result true'):elseShow('Result false')
'homer':ifEQ('homer'):show('Result true'):elseShow('Result false')

#Result

If the data equals the specified value, the output is Result true; otherwise, it is Result false.

#6. :ifNE(value)

#Syntax

{data:ifNE(value):show(text):elseShow(alternative text)}

#Example

100:ifNE(100):show('Result true'):elseShow('Result false')
100:ifNE(101):show('Result true'):elseShow('Result false')

#Result

The first example outputs Result false, while the second example outputs Result true.

#7. :ifGT(value)

#Syntax

{data:ifGT(value):show(text):elseShow(alternative text)}

#Example

1234:ifGT(1):show('Result true'):elseShow('Result false')
-23:ifGT(19):show('Result true'):elseShow('Result false')

#Result

The first example outputs Result true, and the second outputs Result false.

#8. :ifGTE(value)

#Syntax

{data:ifGTE(value):show(text):elseShow(alternative text)}

#Example

50:ifGTE(-29):show('Result true'):elseShow('Result false')
1:ifGTE(768):show('Result true'):elseShow('Result false')

#Result

The first example outputs Result true, while the second outputs Result false.

#9. :ifLT(value)

#Syntax

{data:ifLT(value):show(text):elseShow(alternative text)}

#Example

-23:ifLT(19):show('Result true'):elseShow('Result false')
1290:ifLT(768):show('Result true'):elseShow('Result false')

#Result

The first example outputs Result true, and the second outputs Result false.

#10. :ifLTE(value)

#Syntax

{data:ifLTE(value):show(text):elseShow(alternative text)}

#Example

5:ifLTE(5):show('Result true'):elseShow('Result false')
1290:ifLTE(768):show('Result true'):elseShow('Result false')

#Result

The first example outputs Result true, and the second outputs Result false.

#11. :ifIN(value)

#Syntax

{data:ifIN(value):show(text):elseShow(alternative text)}

#Example

'car is broken':ifIN('is'):show('Result true'):elseShow('Result false')
[1,2,'toto']:ifIN(2):show('Result true'):elseShow('Result false')

#Result

Both examples output Result true (because the string contains 'is', and the array contains 2).

#12. :ifNIN(value)

#Syntax

{data:ifNIN(value):show(text):elseShow(alternative text)}

#Example

'car is broken':ifNIN('is'):show('Result true'):elseShow('Result false')
[1,2,'toto']:ifNIN(2):show('Result true'):elseShow('Result false')

#Result

The first example outputs Result false (because the string contains 'is'), and the second example outputs Result false (because the array contains 2).

#13. :ifTE(type)

#Syntax

{data:ifTE('type'):show(text):elseShow(alternative text)}

#Example

'homer':ifTE('string'):show('Result true'):elseShow('Result false')
10.5:ifTE('number'):show('Result true'):elseShow('Result false')

#Result

The first example outputs Result true (since 'homer' is a string), and the second outputs Result true (since 10.5 is a number).

#Conditional Blocks

Conditional blocks are used to display or hide a section of the document, typically to enclose multiple tags or an entire block of text.

#1. :showBegin / :showEnd

#Syntax

{data:ifEQ(condition):showBegin}
Document block content
{data:showEnd}

#Example

Data:

{
  "toBuy": true
}

Template:

Banana{d.toBuy:ifEQ(true):showBegin}
Apple
Pineapple
{d.toBuy:showEnd}Grapes

#Result

When the condition is met, the content in between is displayed:

Banana
Apple
Pineapple
Grapes

#2. :hideBegin / :hideEnd

#Syntax

{data:ifEQ(condition):hideBegin}
Document block content
{data:hideEnd}

#Example

Data:

{
  "toBuy": true
}

Template:

Banana{d.toBuy:ifEQ(true):hideBegin}
Apple
Pineapple
{d.toBuy:hideEnd}Grapes

#Result

When the condition is met, the content in between is hidden, resulting in:

Banana
Grapes