Assistants gs-helpers

Valeur de secours par défaut default-value

L’helper Default Fallback Value est utilisé pour renvoyer une valeur de secours par défaut si un attribut est vide ou nul. Ce mécanisme fonctionne pour les attributs de profil et les événements de parcours.

Syntaxe

Hello {%=profile.personalEmail.name.firstName ?: "there" %}!

Dans cet exemple, la valeur there s'affiche si l'attribut firstName de ce profil est vide ou nul.

Conditions if-function

L'helper if est utilisé pour définir un bloc conditionnel.
Si l'évaluation de l'expression renvoie true, le bloc est rendu, sinon il est ignoré.

Syntaxe

{%#if contains(profile.personalEmail.address, ".edu")%}
<a href="https://www.adobe.com/academia">Check out this link</a>

À la suite de l'helper if, vous pouvez saisir une instruction else pour spécifier un bloc de code à exécuter, si la même condition est false.
L'instruction elseif spécifie une nouvelle condition à tester si la première instruction renvoie false.

Format

{
    {
        {%#if condition1%} element_1
        {%else if condition2%} element_2
        {%else%} default_element
        {%/if%}
    }
}

Exemples

Unless unless

L'helper unless est utilisé pour définir un bloc conditionnel. Par opposition à l'helper if, si l'évaluation de l'expression renvoie false, le bloc est rendu.

Syntaxe

{%#unless unlessCondition%} element_1 {%else%} default_element {%/unless%}

Exemple

Générer du contenu en fonction de l'extension d'adresse e-mail :

{%#unless endsWith(profile.personalEmail.address, ".edu")%}
Some Normal Content
{%else%}
Some edu specific content Content
{%/unless%}

Each each

L'helper each est utilisé pour effectuer une itération sur un tableau.
La syntaxe de l’assistant est {{#each ArrayName}} YourContent {{/each}}
Il est possible de se référer aux éléments individuels du tableau en utilisant le mot-clé this à l’intérieur du bloc. L’index de l’élément du tableau peut être rendu à l’aide de {{@index}}.

Syntaxe

{{#each profile.productsInCart}}
    <li>{{this.name}}</li>
{{/each}}

Exemple

{{#each profile.homeAddress.city}}
  {{@index}} : {{this}}<br>
{{/each}}

Exemple

Générer une liste de produits que cet utilisateur a dans son panier :

{{#each profile.products as |product|}}
    <li>{{product.productName}} {{product.productRating}}</li>
{{/each}}

Avec with

L'helper with permet de modifier le jeton d'évaluation d'une partie de modèle.

Syntaxe

{{#with profile.person.name}}
{{this.firstName}} {{this.lastName}}
{{/with}}

L'helper with est utile pour définir également une variable de raccourci.

Exemple

Utiliser l'option avec pour attribuer un alias aux noms de variables longs par rapport aux noms plus courts :

{{#with profile.person.name as |name|}}
 Hi {{name.firstName}} {{name.lastName}}!
 Checkout our trending products for today!
{{/with}}

Let let

La fonction let permet à une expression d'être stockée en tant que variable et d'être utilisé ultérieurement dans une requête.

Syntaxe

{% let variable = expression %} {{variable}}

Exemple

L'exemple suivant permet de calculer la somme totale des prix des produits du panier dont les prix sont compris entre 100 et 1 000.

{% let sum = 0%}
    {{#each profile.productsInCart as |p|}}
        {%#if p.price>100 and p.price<1000%}
            {%let sum = sum + p.price %}
        {%/if%}
    {{/each}}
{{sum}}