陣列和清單功能 arrays

使用這些函式可讓與陣列、清單和字串的互動更容易。

只計算null count-only-null

countOnlyNull函式用於計算清單中null值的數目。

語法

{%= countOnlyNull(array) %}

範例

{%= countOnlyNull([4,0,1,6,0,0]) %}

傳回3。

Null計數 count-with-null

countWithNull函式用於計算包含null值的清單的所有元素。

語法

{%= countWithNull(array) %}

範例

{%= countOnlyNull([4,0,1,6,0,0]) %}

傳回6。

Distinct distinct

distinct函式用於從移除重複值的陣列或清單中取得值。

語法

{%= distinct(array) %}

範例

下列作業會指定在多個商店下訂單的人員。

{%= distinct(person.orders.storeId).count() > 1 %}

Null的相異計數 distinct-count-with-null

distinctCountWithNull函式用於計算清單中包括null值的不同值數目。

語法

{%= distinctCountWithNull(array) %}

範例

{%= distinctCountWithNull([10,2,10,null]) %}

傳回3。

第一個專案 head

head函式用來傳回陣列或清單中的第一個專案。

語法

{%= head(array) %}

範例

下列作業會傳回價格最高的前五個訂單中的第一個。 有關topN函式的詳細資訊可在陣列🔗區段的第一個n中找到。

{%= head(topN(orders,price, 5)) %}

排序並取得陣列中的前N個 first-n

topN函式根據給定的數值運算式以遞減順序排序陣列，並傳回前N個專案。 如果陣列大小小於N，則會傳回整個已排序陣列。

此函式
語法

{%= topN(array, value, amount) %}

範例

下列作業會傳回價格最低的前五個訂單。

{%= topN(orders,price, 5) %}

在 in

in函式是用來判斷專案是陣列或清單的成員。

語法

{%= in(value, array) %}

範例

下列作業會定義3月、6月或9月有生日的人員。

{%= in (person.birthMonth, [3, 6, 9]) %}

包含 includes

includes函式是用來判斷陣列或清單是否包含指定的專案。

語法

{%= includes(array,item) %}

範例

下列作業會定義哪些人最喜愛的顏色包括紅色。

{%= includes(person.favoriteColors,"red") %}

相交 intersects

intersects函式是用來判斷兩個陣列或清單是否至少有一個通用成員。

語法

{%= intersects(array1, array2) %}

範例

下列作業會定義哪些人最喜愛的顏色至少包括紅色、藍色或綠色之一。

{%= intersects(person.favoriteColors,["red", "blue", "green"]) %}

排序並取得陣列中的最後N個 last-n

bottomN函式根據給定的數值運算式以遞增順序排序陣列，並傳回前N個專案。 如果陣列大小小於N，則會傳回整個已排序陣列。

語法

{%= bottomN(array, value, amount) %}

範例

下列作業會傳回價格最高的前5個訂單。

{%= bottomN(orders,price, 5) %}

不在 notin

notIn函式是用來判斷專案是否不是陣列或清單的成員。

語法

{%= notIn(value, array) %}

範例

下列作業會定義非三月、六月或九月的人員生日。

{%= notIn(person.birthMonth ,[3, 6, 9]) %}

子集： subset

subsetOf函式是用來判斷特定陣列（陣列A）是否是另一個陣列（陣列B）的子集。 換句話說，陣列A中的所有元素都是陣列B的元素。

語法

{%= subsetOf(array1, array2) %}

範例

下列作業會定義造訪過其所有最喜愛城市的人。

{%= subsetOf(person.favoriteCities,person.visitedCities) %}

超集 superset

supersetOf函式是用來判斷特定陣列（陣列A）是否是另一個陣列（陣列B）的超集。 換句話說，該陣列A包含陣列B中的所有元素。

語法

{%= supersetOf(array1, array2) %}

範例

下列作業會定義已吃過至少一次壽司和比薩的人。

{%= supersetOf(person.eatenFoods,["sushi", "pizza"]) %}

反複處理陣列 each-loop

使用Handlebars {{#each}}區塊協助程式來循環陣列並轉譯​個人化內容 （電子郵件、簡訊、推播）中每個專案的內容。

語法

{{#each arrayAttribute}}
  {{this}}
{{/each}}

{{#each profile.purchases.items}}
  - {{this.name}}: {{this.price}}€
{{/each}}

- Running shoes: 89€
- Water bottle: 15€
- Gym bag: 45€

{{#each profile.preferences.languages}}
  {{@index}}: {{this}}
{{/each}}

0: English
1: French
2: Spanish

{{#each profile.orders as |order|}}
  {%#if order.status = "pending"%}
  Your order {{order.id}} is still pending.
  {%/if%}
{{/each}}