HTMLBars template helpers for additional truth logic in if and unless statements.
- Ember.js v4.8 or above
- Embroider or ember-auto-import >= 2 (this is v2 addon)
ember install ember-truth-helpers
| Helper | JavaScript | HTMLBars | Import | Variable argument count allowed |
|---|---|---|---|---|
| eq | if (a === b) |
{{if (eq a b)}} |
import { eq } from 'ember-truth-helpers'; | No |
| not-eq | if (a !== b) |
{{if (not-eq a b)}} |
import { notEq } from 'ember-truth-helpers'; | No |
| not | if (!a) |
{{if (not a)}} |
import { not } from 'ember-truth-helpers'; | Yes |
| and | if (a && b) |
{{if (and a b)}} |
import { and } from 'ember-truth-helpers'; | Yes |
| or | if (a || b) |
{{if (or a b)}} |
import { or } from 'ember-truth-helpers'; | Yes |
| xor | if (a !== b) |
{{if (xor a b)}} |
import { xor } from 'ember-truth-helpers'; | No |
| gt | if (a > b) |
{{if (gt a b)}} |
import { gt } from 'ember-truth-helpers'; | No |
| gte | if (a >= b) |
{{if (gte a b)}} |
import { gte } from 'ember-truth-helpers'; | No |
| lt | if (a < b) |
{{if (lt a b)}} |
import { lt } from 'ember-truth-helpers'; | No |
| lte | if (a <= b) |
{{if (lte a b)}} |
import { eq } from 'ember-truth-helpers'; | No |
| is-array | if (Ember.isArray(a)) |
{{if (is-array a)}} |
import { isArray } from 'ember-truth-helpers'; | Yes |
| is-empty | if (Ember.isEmpty(a)) |
{{if (is-empty a)}} |
import { isEmpty } from 'ember-truth-helpers'; | No |
| is-equal | if (Ember.isEqual(a, b)) |
{{if (is-equal a b)}} |
import { isEqual } from 'ember-truth-helpers'; | No |
is-equal uses Ember.isEqual helper to evaluate equality of two values.
eq should be sufficient for most applications. is-equal is necessary when trying to compare a complex object to
a primitive value.
ember-truth-helpers is a glint enabled addon. Add this to your
types/global.d.ts file:
import '@glint/environment-ember-loose';
import type EmberTruthRegistry from 'ember-truth-helpers/template-registry';
declare module '@glint/environment-ember-loose/registry' {
export default interface Registry extends EmberTruthRegistry, /* other addon registries */ {
// local entries
}
}For the entire guide, please refer to Using Addons section on the glint handbook.
Types are made available through package.json exports field. In order for TS
to recognize this (beginning from TS 4.7), you must set
moduleResolution
to node16 or nodenext.
For usage in gts or gjs files, all helpers are exported from the index:
import { or } from 'ember-truth-helpers';
<template>
{{#if (or @admin @user)}}
Admin Controls are going here
{{/if}}
</template>See the Contributing guide for details.
This project is licensed under the MIT License.