Links

@wazapp/helpers

Helpers are utils that are meant to be used mostly in component templates.

API

each(collection, onItem, onEmpty)

each will make your iterations in template a breeze. It takes care of unique keys for each element, as well as simplify the syntax.
It takes 3 arguments:
  • collection - an array of something
  • onItem(item, index) - callback which will be used for each item in the collection
  • onEmpty - optional - ReactNode that will be returned in case the collection is empty.

Example

Before
import Component from "@wazapp/component";
import { each } from '@wazapp/helpers'
export default class MyComponent extends Component {
phrases = ['Maciej', 'was', 'here'];
template({ name }) {
return (
<ul>
{this.phrases.map((phrase) => (
<li key={phrase}>
{phrase}
</li>
))}
</ul>
);
}
}
After
import Component from "@wazapp/component";
import { each } from '@wazapp/helpers'
export default class MyComponent extends Component {
phrases = ['Maciej', 'was', 'here'];
template({ name }) {
return (
<ul>
{each(this.phrases, (phrase) => (
<li>
{phrase}
</li>
))}
</ul>
);
}
}

when(condition, ifTrue, ifFalse)

when is simple if statement which does not require to return null as false case.
It takes 3 arguments:
  • condition
  • ifTrue - value when true
  • ifFalse - value when false

Example

Before
import Component from "@wazapp/component";
import { when } from '@wazapp/helpers'
export default class MyComponent extends Component {
template({ name }) {
return (
<div>
{name === 'Maciej' ? (
<h1>Hi Maciej</h1>
) : null}
</div>
);
}
}
After
import Component from "@wazapp/component";
import { when } from '@wazapp/helpers'
export default class MyComponent extends Component {
template({ name }) {
return (
<div>
{when(name === 'Maciej', (
<h1>Hi Maciej</h1>)
)}
</div>
);
}
}

classNames()

yieldChildren(children, ...args)

yieldChildren allows you to return component's children or in case the children is a function, it will allow you to call it with custom arguments.
Arguments:
  • children: ReactNode | Function
  • ...args: any[] - your custom arguments that will be used on children call (if children is a function)