Array Helpers

Array helpers provide utilities for working with arrays in templates.

Functions

count

Gets the length of an array or array-like object.

Template Syntax

{count itemsArray}

Parameters

Returns

number - The length of the array, or 0 if null/undefined.

Example

<p>You have {count notifications} notifications</p>

first

Gets the first element of an array.

Template Syntax

{first itemsArray}

Parameters

Returns

any - The first element of the array, or undefined if empty.

Example

<p>Primary category: <b>{first categories}</b></p>

last

Gets the last element of an array.

Template Syntax

{last itemsArray}

Parameters

Returns

any - The last element of the array, or undefined if empty.

Example

<p>Most recent item: <b>{last recentItems}</b></p>

join

Joins array elements with a delimiter.

Template Syntax

{join itemsArray ', ' true}

Parameters

Returns

string - The joined string.

Example

<p>Categories: {join categories ', ' false}</p>

joinComma

Joins array elements with commas.

Template Syntax

{joinComma itemsArray true false}

Parameters

Returns

string - The comma-joined string.

Example

<p>This product comes in {joinComma colors true true}.</p>

range

Returns an array with a range of numbers.

Template Syntax

{#each number in range 1 6}
  {number}
{/each}

Parameters

Returns

array - An array containing the range of numbers.

Example

<select name="birthyear">
  {#each range 1900 2024}
    <option value="{this}">{this}</option>
  {/each}
</select>

Examples