輔助程式 gs-helpers
預設遞補值 default-value
如果屬性為空白或null,則會使用Default Fallback Value
協助程式傳回預裝置援值。 此機制適用於設定檔屬性和歷程事件。
語法
Hello {%=profile.personalEmail.name.firstName ?: "there" %}!
在此範例中,如果此設定檔的firstName
屬性為空白或Null,則會顯示值there
。
條件 if-function
if
協助程式用於定義條件區塊。
如果運算式評估傳回true,則會轉譯區塊,否則會略過該區塊。
語法
{%#if contains(profile.personalEmail.address, ".edu")%}
<a href="https://www.adobe.com/academia">Check out this link</a>
在if
協助程式之後,您可以輸入else
陳述式,以指定要執行的程式碼區塊(如果相同條件為false)。elseif
陳述式將指定新條件來測試第一個陳述式是否傳回false。
格式
{
{
{%#if condition1%} element_1
{%else if condition2%} element_2
{%else%} default_element
{%/if%}
}
}
範例
-
根據條件運算式演算不同的存放區連結
code language-sql {%#if profile.homeAddress.countryCode = "FR"%} <a href="https://www.somedomain.com/fr">Consultez notre catalogue</a> {%else%} <a href="https://www.somedomain.com/en">Checkout our catalogue</a> {%/if%}
-
決定電子郵件地址副檔名
code language-sql {%#if contains(profile.personalEmail.address, ".edu")%} <a href="https://www.adobe.com/academia">Checkout our page for Academia personals</a> {%else if contains(profile.personalEmail.address, ".org")%} <a href="https://www.adobe.com/orgs">Checkout our page for Non Profits</a> {%else%} <a href="https://www.adobe.com/users">Checkout our page</a> {%/if%}
-
新增條件式連結
下列作業會將連結新增至僅含有'.edu'電子郵件地址之設定檔的「www.adobe.com/academia'」網站、含有'.org'電子郵件地址之設定檔的「www.adobe.com/org'」網站,以及所有其他設定檔的預設URL「www.adobe.com/users'」:
code language-sql {%#if contains(profile.personalEmail.address, ".edu")%} <a href="https://www.adobe.com/academia">Checkout our page for Academia personals</a> {%else if contains(profile.personalEmail.address, ".org")%} <a href="https://www.adobe.com/orgs">Checkout our page for Non Profits</a> {%else%} <a href="https://www.adobe.com/users">Checkout our page</a> {%/if%}
-
以對象成員資格為基礎的條件式內容
code language-sql {%#if profile.segmentMembership.get("ups").get("5fd513d7-d6cf-4ea2-856a-585150041a8b").status = "existing"%} Hi! Esteemed gold member. <a href="https://www.somedomain.com/gold">Checkout your exclusive perks </a> {%else%} if 'profile.segmentMembership.get("ups").get("5fd513d7-d6cf-4ea2-856a-585150041a8c").status = "existing"'%} Hi! Esteemed silver member. <a href="https://www.somedomain.com/silver">Checkout your exclusive perks </a> {%/if%}
Unless unless
unless
協助程式用於定義條件區塊。 藉由與The if
協助程式對立,如果運算式評估傳回false,則會轉譯區塊。
語法
{%#unless unlessCondition%} element_1 {%else%} default_element {%/unless%}
範例
根據電子郵件地址副檔名轉譯某些內容:
{%#unless endsWith(profile.personalEmail.address, ".edu")%}
Some Normal Content
{%else%}
Some edu specific content Content
{%/unless%}
Each each
each
協助程式是用來反複處理陣列。
協助程式的語法為{{#each ArrayName}}
YourContent {{/each}}
我們可以在區塊內使用關鍵字 this 來參照個別陣列專案。 可以使用{{@index}}轉譯陣列專案的索引。
語法
{{#each profile.productsInCart}}
<li>{{this.name}}</li>
{{/each}}
範例
{{#each profile.homeAddress.city}}
{{@index}} : {{this}}<br>
{{/each}}
範例
呈現此使用者在購物車中擁有的產品清單:
{{#each profile.products as |product|}}
<li>{{product.productName}} {{product.productRating}}</li>
{{/each}}
With with
with
協助程式可用來變更範本部分的評估權杖。
語法
{{#with profile.person.name}}
{{this.firstName}} {{this.lastName}}
{{/with}}
with
協助程式也可用來定義捷徑變數。
範例
搭配使用,將長變數名稱等同為短變數名稱:
{{#with profile.person.name as |name|}}
Hi {{name.firstName}} {{name.lastName}}!
Checkout our trending products for today!
{{/with}}
Let let
let
函式允許將運算式儲存為變數,以便稍後在查詢中使用。
語法
{% let variable = expression %} {{variable}}
範例
下列範例可讓您計算購物車中價格介於100到1000之間的產品的總價。
{% let sum = 0%}
{{#each profile.productsInCart as |p|}}
{%#if p.price>100 and p.price<1000%}
{%let sum = sum + p.price %}
{%/if%}
{{/each}}
{{sum}}