Skip to content

Ember HTMLBars Helpers for {{if}} & {{unless}}: not, and, or, eq & is-array

License

Notifications You must be signed in to change notification settings

jmurphyau/ember-truth-helpers

Repository files navigation

Ember Truth Helpers CI

HTMLBars template helpers for additional truth logic in if and unless statements.

Compatibility

  • Ember.js v3.28 or above
  • Embroider or ember-auto-import >= 2 (this is v2 addon)

Installation

ember install ember-truth-helpers

Usage

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

API

is-equal

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.

Other Helpers

Usage with Glint

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.

Usage in Single File Components

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>

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.