{if}

Quick Overview Video

Settings

The {if} command lets you conditionally include or exclude content based on a condition. That condition is a Text Blaze Formula that must evaluate to either yes or no.

Everything within the {if} command and the required {endif} command will be inserted if the condition evaluates to yes.

See also the {=} (Formula Command) command and the {repeat} command for additional tools to help you build dynamic snippets.

The required {endif} command

The if command is similar to the {note} command in that the closing command must be present. In this case, it's the {endif} command.

Everything inside of these two commands will or will not get rendered depending on the output of the condition, the if command's positional setting.

The optional {else} command

What if you would like to do something different if the condition evaluates to no?

In that case, you have access to an {else} command. The {else} command must be placed within the starting if command and the closing {endif} command.

There can only be one {else} command.

Here's an example:

Multiple if conditions with the optional {elseif} command

It's possible to test for multiple conditions with the help of the {elseif} command.

Similar to the {if} command, the {elseif} also takes a condition as its positional setting that is a Blaze Formula.

Also, just like the {else} command, they must be placed within the starting if command and the ending {endif} command.

You can have multiple {elseif} commands.

Here's an example:

Here's what we're telling Text Blaze in the snippet above:

1. If the form name called number contains the text "one", then give us the text "The number one"
2. If the above isn't true, check whether it contains the text "two".
3. If the above is true, then give us the text "The number two". If not, check whether it contains the text "three".

And so on.

At the very end, you'll need to end with an {endif} command. The {endif} command is always placed at the very end.

If the initial if conditional evaluates to no, Text Blaze will look for the next {elseif} command and evaluate its condition. It evaluates to yes, its contents will be shown, otherwise, Text Blaze will move on to the next {elseif}.

If all {elseif} commands within the if command are evaluated to no and there is an {else} command, the contents of the {else} command will be shown. The following examples illustrate the use of {elseif} and {else}.

Dynamic content using the if command

Text Blaze becomes incredibly powerful when you start combining different commands like {formmenu}, {if} and {import}.

For this example, try saving the following three snippets below into your Text Blaze dashboard. This will help you understand better how Text Blaze uses these functions by seeing them in action.

To copy the snippet examples to your dashboard, click the “Copy to Text Blaze” button in the top right of the interactive snippet.

First, save the snippet below and give it the shortcut /example1.

Now, save this second snippet below and give it the shortcut /example2.

Finally, save this third snippet below and give it any shortcut you please.

Now try running the third snippet somewhere in a text field.

Depending on the option you choose in the drop-down menu, Text Blaze will give you the contents of the respective snippet.

Now here's how that works.

1. We created a drop-down menu with {formmenu} and gave it two options – Example 1 and Example 2. We also gave it the name "options".
2. We created an if command and gave it the following instructions:
   • If the form name called options is equal to "Example 1", then you should import the contents of the snippet with the shortcut /example1
   • If the above is not true, then you should import the contents of the snippet with the shortcut /example2 (that's where the {else} command comes in).

You don't have to use an {import} command when using {if} commands, but they can help you better manage your snippets.