Quick-search for anything
⌘F

unless

Usage: {{#unless featured}}{{/unless}}

The {{#unless}} block helper comes built in with Handlebars.

Description

{{#unless}} is essentially the opposite of {{#if}}. If you want to test a negative conditional only, i.e. if you only need the {{else}} part of an {{#if}} statement, then {{#unless}} is what you need.

It works exactly the same as {{#if}} and supports both {{else}} and ^ negation if you want to get really confusing!

Unless also uses the exact same conditional evaluation rules as {{#if}}.

Example code

Basic unless example, will execute the template between its start and end tags only if featured evaluates to false.

{{#unless featured}}
  ...do something...
{{/unless}}

If you want, you can also include an else block, although in the majority of cases, if you need an else, then using {{#if}} is more readable:

<!-- This is identical to if, but with the blocks reversed -->
{{#unless featured}}
  ...do thing 1...
{{else}}
  ...do thing 2...
{{/unless}}