> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/tutoriels/general/expressions-for-lwr-sites.md).

# Expressions pour les sites LWR

## Aperçu

Avec les expressions, vous pouvez effectuer des calculs et accéder aux valeurs de propriétés et à d’autres données à transmettre aux attributs du composant. Utilisez les expressions pour un affichage dynamique ou pour transmettre des valeurs aux composants en les assignant à des attributs.

Une expression est tout ensemble de valeurs littérales, de variables, de sous-expressions ou d'opérateurs pouvant être résolu en une seule valeur. Les appels de méthode ne sont pas autorisés dans les expressions.

La syntaxe des expressions est : **`{!expression}`** où expression est un espace réservé.

## Expressions de liaison de données

| Expression                        | Description                                                                                               | Pages et composants pris en charge                                                                                                                                                                                                                                                                                                                                                                               |
| --------------------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`{!Item.field}`**               | Récupère les données du champ dans les données liées actuelles.                                           | Tout élément lié à des données. Peut inclure du contenu Salesforce CMS ou des données d’enregistrement.                                                                                                                                                                                                                                                                                                          |
| **`{!Item.field._rawValue}`**     | Récupère la valeur brute du champ de données.                                                             | Tout élément lié à des données CRM.                                                                                                                                                                                                                                                                                                                                                                              |
| **`{!Item.field._displayValue}`** | Récupère la valeur formatée et localisée du champ de données.                                             | Tout élément lié à des données CRM.                                                                                                                                                                                                                                                                                                                                                                              |
| **`{!Item._detailURL}`**          | Récupère l’URL d’un élément de données Salesforce CMS.                                                    | Tout élément lié à un élément CMS, y compris les pages de détail CMS.                                                                                                                                                                                                                                                                                                                                            |
| **`{!Label.namespace.name}`**     | Définit la valeur localisée de l’étiquette lorsque vous spécifiez des étiquettes dans Experience Builder. | Commencez par créer une étiquette personnalisée traduite dans la configuration Salesforce. Pour plus d’informations, consultez [Traduire les étiquettes personnalisées](https://help.salesforce.com/s/articleView?id=cl_translate_edit.htm\&language=en_US\&type=5). Ensuite, utilisez l’expression d’étiquette dans tout composant Experience Builder doté d’un champ de texte pour voir l’étiquette localisée. |

## Autres expressions

Utilisez d’autres expressions pour interroger des paramètres, résoudre le bon basePath pour un site ou exploiter des champs utilisateur dans les expressions.

| Expression                                | Description                                                                                                                                     | Pages et composants pris en charge                                                                                                                                                                            |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`{!Route.param}`**                      | Récupère un paramètre de requête à partir de l’URL.                                                                                             | <ul><li>Toutes les pages</li><li>Composants standard et personnalisés avec des propriétés de chaîne</li><li>Éditeur HTML</li><li>Éditeur de contenu riche</li></ul>                                           |
| **`{!param}`**                            | Récupère une valeur de paramètre d’une URL où : précède le paramètre. Par exemple, récupère {!term} à partir de l’URL /global-search/:term.     | <ul><li>Toutes les pages avec un paramètre dynamique dans leur URL</li><li>Composants standard et personnalisés avec des propriétés de chaîne</li><li>Éditeur HTML</li><li>Éditeur de contenu riche</li></ul> |
| **`{!Site.basePath}`**                    | Se résout en le basePath du site LWR.                                                                                                           | <ul><li>Toutes les pages</li><li>Composants standard et personnalisés avec des propriétés de chaîne</li><li>Éditeur HTML</li><li>Éditeur de contenu riche</li></ul>                                           |
| **`{!User.userId}`**                      | Se résout en l’ID Salesforce de l’utilisateur.                                                                                                  | <ul><li>Toutes les pages</li><li>Composants standard et personnalisés avec des propriétés de chaîne</li><li>Éditeur HTML</li><li>Éditeur de contenu riche</li></ul>                                           |
| **`{!User.isGuest}`**                     | Renvoie TRUE ou FALSE selon que l’utilisateur est un utilisateur invité.                                                                        | <ul><li>Toutes les pages</li><li>Composants standard et personnalisés avec des propriétés de chaîne</li><li>Éditeur HTML</li><li>Éditeur de contenu riche</li></ul>                                           |
| **`{!User.Record.<User sObject Field>}`** | Se résout en la valeur d’un champ de l’objet utilisateur Salesforce.                                                                            | <ul><li>Toutes les pages</li><li>Composants standard et personnalisés avec des propriétés de chaîne</li><li>Éditeur HTML</li><li>Éditeur de contenu riche</li></ul>                                           |
| **`{!User.Commerce.BuyerGroups}`**        | Renvoie une liste des groupes d’acheteurs associés à l’utilisateur lorsqu’elle est utilisée dans des sites créés à l’aide des modèles Commerce. | <ul><li>Toutes les pages</li><li>Composants standard et personnalisés avec des propriétés de chaîne</li><li>Éditeur HTML</li><li>Éditeur de contenu riche</li></ul>                                           |

* Lorsque vous utilisez l’expression {!param} ou {!Route.param} dans les composants Éditeur HTML ou Éditeur de contenu enrichi, certains caractères spéciaux HTML sont échappés, ou remplacés par d’autres valeurs, à des fins de sécurité. Ces caractères incluent <, > et &.
* Les sites LWR ne prennent pas en charge les expressions qui affichent des informations sur l’utilisateur authentifié, à partir de {!CurrentUser.
* Les expressions avec des données utilisateur sont résolues pour l’Éditeur de contenu enrichi uniquement sur les sites de prévisualisation et les sites publiés.
* Lorsque vous liez des données utilisateur, vous pouvez accéder à tous les champs de l’objet User à l’aide de l’expression {!User.Record.\<User sObject Field>}. Vous pouvez également utiliser l’expression {!User.Commerce.\<Commerce Field>} pour accéder aux données utilisateur liées à Commerce dans les sites créés à l’aide des modèles Commerce. Dans la version Summer ’23, seul BuyerGroups est pris en charge en tant que champ Commerce.

### Source

<https://developer.salesforce.com/docs/atlas.en-us.exp_cloud_lwr.meta/exp_cloud_lwr/advanced_expressions.htm><br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/tutoriels/general/expressions-for-lwr-sites.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
