Opérateurs

Les opérateurs sont des éléments essentiels des expressions dynamiques, vous permettant d'effectuer des calculs, des comparaisons et des évaluations logiques. Ces symboles permettent à votre espace de travail de traiter les données, de prendre des décisions et de créer du contenu interactif.

Opérateurs Arithmétiques‍

Effectuent des opérations mathématiques de base.

• + (Addition): Additionne deux nombres ou concatène des chaînes de texte.
  • Exemple : {{ 2 + 3 }} → 5
  • Exemple : {{ "Hello, " + sessionUser.name }} → Hello, John
• - (Soustraction): Soustrait un nombre à un autre.
  • Exemple : {{ 10 - 4 }} → 6
• * (Multiplication): Multiplie deux nombres.
  • Exemple : {{ 5 * 3 }} → 15
• / (Division): Divise un nombre par un autre.
  • Exemple : {{ 10 / 2 }} → 5
  • Remarque : La division par zéro renverra une erreur.
• % (Reste): Renvoie le reste d’une division.
  • Exemple : {{ 10 % 3 }} → 1
• ** (Exponentiation): Élève un nombre à la puissance d’un autre.
  • Exemple : {{ 2 ** 3 }} → 8

Opérateurs de Comparaison‍

Utilisés pour comparer des valeurs et retourner vrai ou faux.

• == (Égalité): Vérifie si deux valeurs sont égales.
  • Exemple : {{ 2 + 2 == 4 }} → true
• != (Inégalité): Vérifie si deux valeurs ne sont pas égales.
  • Exemple : {{ sessionUser.stats.ideas != 0 }} → true
• > (Supérieur à): Vérifie si la valeur de gauche est supérieure à celle de droite.
  • Exemple : {{ sessionUser.stats.likes > 10 }} → true
• >= (Supérieur ou égal à): Vérifie si la valeur de gauche est supérieure ou égale à celle de droite.
  • Exemple : {{ 5 >= 5 }} → true
• < (Inférieur à): Vérifie si la valeur de gauche est inférieure à celle de droite.
  • Exemple : {{ 3 < 10 }} → true
• <= (Inférieur ou égal à): Vérifie si la valeur de gauche est inférieure ou égale à celle de droite.
  • Exemple : {{ sessionUser.stats.ideas <= 20 }} → true

Opérateurs Logiques

‍Utilisés pour combiner plusieurs conditions.

• && (ET): Renvoie vrai si les deux conditions sont vraies.
  • Exemple : {{ sessionUser.stats.likes > 10 && sessionUser.stats.ideas > 5 }} → true si les deux conditions sont remplies.
• || (OU): Renvoie vrai si au moins une condition est vraie.
  • Exemple : {{ sessionUser.rank == 3000 || sessionUser.rank == 5000 }} → true si l'utilisateur est un administrateur ou un propriétaire.
• ! (NON): Inverse la valeur de vérité d’une condition.
  • Exemple : {{ !(2 + 2 == 5) }} → true

‍Opérateur Conditionnel

Parfois, vous souhaiterez exécuter des branches conditionnelles de vos formules, en fonction des données contextuelles. Par exemple, vous pouvez vouloir :

• Utiliser différentes clés de traduction dans la description de votre collecte d'idées en fonction du rang de l'utilisateur actuel.
• Définir différentes valeurs sur une idée dans une action d'automatisation selon qu'elle a plus ou moins qu'une quantité spécifiée de commentaires par exemple.

Vous pouvez utiliser l'opérateur conditionnel dans vos expressions dynamiques pour accomplir ces tâches. L'opérateur conditionnel est particulier car il accepte trois opérandes.

Il a la structure suivante : <condition> ? <quand-vrai> : <quand-faux>

Voici un exemple simple : {{ sessionUser.stats.likes > 10 ? "Top-contributor" : "Rookie" }}

Vous pouvez insérer n'importe quoi dans les deux branches de l'opérateur conditionnel, y compris des variables de traduction personnalisées ou des formules imbriquées complexes.

Par exemple, vous pouvez vouloir utiliser différentes variables de traduction personnalisées, en fonction du rang de l'utilisateur actuel :

{{ sessionUser.rank >= 3000 ? (sessionUser.stats.ideas > 20 ? "Super Admin" : "Admin") : "Member" }}

Opérateurs de Groupement

Utilisés pour contrôler l'ordre des opérations en regroupant les expressions avec des parenthèses ().

• Exemple : {{ (2 + 3) * 4 }} → 20
• Sans parenthèses : {{ 2 + 3 * 4 }} → 14
• Remarque : La multiplication est prioritaire.

Conseils de Gestion des Erreurs pour les Opérateurs

• Éviter la division par zéro : Pour éviter les erreurs lors d’une division par une variable susceptible d’être égale à zéro, utilisez une logique de repli avec des fonctions telles que MAX() ou des conditions.
  • Exemple : au lieu de {{ 10 / variable }}, utilisez :{{ 10 / MAX(variable, 1) }} — garantit que le diviseur est au moins égal à 1.
  • Exemple avec une condition : {{ variable != 0 ? 10 / variable : "Undefined (Division by zero)" }} — affiche un message de remplacement lorsque le diviseur est égal à zéro.‍
• Vérifiez vos parenthèses : Assurez-vous de fermer toutes les parenthèses ouvrantes.
• Utilisez les opérateurs logiques avec soin : Vérifiez attentivement les conditions pour éviter des résultats inattendus.

En maîtrisant les opérateurs, vous pouvez créer des expressions dynamiques plus complexes et attrayantes, permettant à votre espace de travail de réagir intelligemment aux données et aux interactions des utilisateurs.