> 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/experience-components/ax-avatar.md).

# AX - Avatar

## Vue d'ensemble

**AX - Avatar** est un composant Experience Cloud qui affiche des photos de profil, des initiales ou des icônes sur les pages des sites Experience afin de représenter des utilisateurs, des contacts, des comptes ou tout autre enregistrement Salesforce.

Utilisez-le pour afficher des profils d’utilisateurs du portail, des représentants de compte, des listes de contacts ou des identifiants d’entité avec un style visuel cohérent. Le composant affiche automatiquement des images lorsqu’elles sont disponibles ou, à défaut, des initiales ou des icônes.

Parfait pour les en-têtes de profil utilisateur, les listes de membres de la communauté, les annuaires de contacts ou partout où les utilisateurs du portail ont besoin d’une identification visuelle des personnes ou des entités.

## Configuration

Le composant Avonni Avatar vous aide à créer des représentations visuellement cohérentes des utilisateurs ou des entités dans votre site Salesforce Experience Cloud. Voici un guide étape par étape pour personnaliser l’Avatar selon vos besoins :

### Affichage des initiales

Le composant Avatar offre de la flexibilité dans la manière d’afficher les initiales :

#### **Saisie manuelle**

Si vous connaissez les initiales que vous souhaitez afficher, saisissez-les directement dans le champ « Initiales ».

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-ca965bbba84ed16677c25378f8fef8583743cbfa%2F2024-03-16_10-45-41.png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Génération dynamique (expressions)**

Pour rendre vos composants Avonni dynamiques, vous pouvez utiliser [Expressions Experience Cloud](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/premiers-pas/learning-the-basics.md#expressions). Par exemple, dans le composant Avatar ci-dessous, vous pouvez utiliser l’expression suivante pour afficher automatiquement le nom de l’utilisateur actuellement connecté :

```
{!User.Record.Name} 
```

Vous pouvez remplacer `Name` par le nom de champ réel qui stocke le nom de l’utilisateur dans votre org Salesforce.

Si vous souhaitez générer automatiquement des initiales à partir d’un nom complet, activez l’option « Initiales formatées automatiquement ». Cela utilisera des expressions Experience Cloud pour extraire et mettre en forme la première lettre de chaque mot du nom.

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-2bda35c2e283ed9d1c4beb49eda4a7f9931c4d90%2F2024-06-30_07-36-45.png?alt=media" alt=""><figcaption><p>Affichage dynamique des initiales à partir du nom de l’utilisateur actuel</p></figcaption></figure>

### Image personnalisée

Ajoutez une photo de profil, un logo ou toute autre image pour rendre l’Avatar immédiatement reconnaissable. Téléchargez votre image à l’aide de l’option  **Contenu sélectionné**  — le composant la recadre et la met automatiquement au format adapté à la forme de l’Avatar.

Si aucune image n’est ajoutée, l’Avatar affiche des initiales à la place

### Variante (forme)

Choisissez entre **Carré** (la valeur par défaut) et **Cercle** à l’aide du **Variante** champ afin de correspondre au design de votre portail. Les avatars circulaires conviennent bien aux personnes, tandis que les formes carrées conviennent aux logos ou aux icônes d’entité

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-d1b2d151de0ec7dd71d0a0d106272d5e1f32c6a6%2F2024-03-16_10-48-53.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

### Taille

Contrôlez la taille à laquelle l’Avatar apparaît sur la page à l’aide de la **Taille** propriété. Les options vont de **Très petit** jusqu’à **Petit**, **Moyen** (par défaut), **Grand** et **Très grand** à **Très, très grand**, afin de l’harmoniser avec le contenu environnant — plus petit pour les listes en ligne, plus grand pour les en-têtes de profil.

### Texte principal et secondaire

Affichez un contexte supplémentaire à côté de l’Avatar en ajoutant des champs de texte. Utilisez **Texte principal** pour l’information la plus importante (comme un nom complet) et **Texte secondaire** pour les détails complémentaires (comme l’intitulé du poste ou l’e-mail).

Vous pouvez également définir des styles de police pour chaque niveau de texte afin de créer une hiérarchie visuelle entre les informations principale et secondaire.

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-63991fcebc8f46a6ac3cbbf0770a6d47cab60581%2F2024-03-16_10-52-44.png?alt=media" alt=""><figcaption></figcaption></figure>

### Étiquettes

Ajoutez des libellés visuels pour catégoriser ou mettre en évidence des informations sur l’Avatar. Chaque étiquette possède un **Libellé** et une **Variante** qui colore le badge — `Inverse alternatif`, `Base`, `Marque`, `Erreur`, `Info`, `Inverse`, `Hors ligne`, `Succès` ou `Avertissement` — utile pour afficher l’état, le service, le rôle ou tout autre identifiant rapide.

### Propriétés

**Initiales** affiche des initiales spécifiques pour un utilisateur ou une entité, et **Initiales formatées automatiquement** les génère automatiquement à partir d’un nom complet fourni pour une représentation cohérente sans saisie manuelle.

**Nom de l’icône de secours** définit l’icône de secours affichée lorsque les données principales (une image ou des initiales) sont absentes, garantissant la continuité visuelle. Elle prend par défaut la valeur `standard:account`.

**Image CMS** et **URL de l’image ou expression** définit l’image de l’avatar — faites référence à un actif géré par le CMS ou fournissez une URL/une expression. **Href** transforme l’avatar en lien vers l’adresse indiquée.

**Variante** choisit une `Carré` (par défaut) ou `Cercle` forme, et **Taille** ajuste les dimensions globales (`Très petit`, `Petit`, `Moyen` (par défaut), `Grand`, `Très grand`, `Très, très grand`). **Position de l’icône** aligne l’icône de secours à l’intérieur de l’avatar (`Début`, `Centre` (par défaut), `Fin`).

**Texte principal**, **Texte secondaire**, et **Texte tertiaire** affiche le texte principal, le texte complémentaire et le texte de troisième niveau à côté de l’avatar (souvent un nom, puis un rôle, puis un détail supplémentaire). Chacun dispose de son propre **Style de texte** paramètre juste en dessous dans le panneau — `Titre 1` à `Titre 4`, ou `Paragraphe 1` / `Paragraphe 2`. **Position du texte** spécifie l’alignement de ces textes par rapport à l’avatar (`Gauche`, `Centre`, `Droite` (par défaut)).

**Masquer les détails de l’avatar** affiche ou masque les détails supplémentaires associés à l’avatar, tels que les textes ou les étiquettes.

**Étiquettes** ajoute des étiquettes de badge à l’avatar comme marqueurs ou indicateurs catégoriels.

**Nom de l’icône d’entité**, **Initiales de l’entité**, **Source de l’image de l’entité**, **Variante de l’entité**, et **Position de l’entité** configure un badge secondaire « entité » superposé sur l’avatar — son icône, ses initiales, son image, sa forme (`Carré`, la valeur par défaut, ou `Cercle`), et la position dans le coin (`En haut à gauche` (par défaut), `En haut à droite`, `En bas à gauche`, `En bas à droite`).

**Actions** ajoute des boutons d’action à l’avatar — chacun avec un libellé, une icône, un nom et une interaction au clic — ainsi qu’une icône de menu et une position de menu (`En bas à gauche`, `En bas à droite`, `En haut à gauche`, `En haut à droite`) utilisée lorsqu’il y a plus d’une action. **Lier à** définit une interaction déclenchée lorsque l’avatar est cliqué.

## Cas d'utilisation

**Profils utilisateur** – Créez des en-têtes de profil complets en combinant une image personnalisée avec un texte principal pour le nom de l’utilisateur et un texte secondaire pour son intitulé de poste ou son département. Cela donne aux utilisateurs du portail une représentation claire et professionnelle sur leurs pages de profil.

**Forums de la communauté** – Affichez les avatars à côté des publications et des commentaires afin que les membres de la communauté puissent identifier rapidement qui contribue. Cela ajoute une touche personnelle qui encourage l’engagement et facilite le suivi des conversations.

**Pages d’équipe** – Mettez en valeur les membres de l’équipe avec des avatars incluant les noms, les rôles et des étiquettes pour le service ou l’expertise. Cela aide les utilisateurs du portail à trouver le bon contact et à comprendre la structure de l’équipe en un coup d’œil.

## Style

{% tabs %}
{% tab title="Texte principal" %}

| Nom de la propriété                      | Description                                             | Valeurs possibles                                           |
| ---------------------------------------- | ------------------------------------------------------- | ----------------------------------------------------------- |
| **Couleur du texte principal**           | Définit la couleur du texte principal dans l’Avatar     | Valeurs de couleur standard, classes utilitaires de couleur |
| **Taille de police du texte principal**  | Modifie la taille du texte principal                    | Valeurs de taille de police (par ex. 12px, 1rem)            |
| **Style de police du texte principal**   | Contrôle le style de police (par ex. italique, oblique) | Options de style de police standard                         |
| **Graisse de police du texte principal** | Définit le niveau de gras du texte principal            | Valeurs de graisse de police (par ex. normal, gras)         |
| {% endtab %}                             |                                                         |                                                             |

{% tab title="Texte secondaire" %}

| Nom de la propriété                       | Description                                             | Valeurs possibles                                           |
| ----------------------------------------- | ------------------------------------------------------- | ----------------------------------------------------------- |
| **Couleur du texte secondaire**           | Définit la couleur du texte complémentaire              | Valeurs de couleur standard, classes utilitaires de couleur |
| **Taille de police du texte secondaire**  | Modifie la taille du texte secondaire                   | Valeurs de taille de police (par ex. 12px, 1rem)            |
| **Style de police du texte secondaire**   | Contrôle le style de police (par ex. italique, oblique) | Options de style de police standard                         |
| **Graisse de police du texte secondaire** | Définit le niveau de gras du texte secondaire           | Valeurs de graisse de police (par ex. normal, gras)         |
| {% endtab %}                              |                                                         |                                                             |

{% tab title="Texte tertiaire" %}

| Nom de la propriété                      | Description                                             | Valeurs possibles                                           |
| ---------------------------------------- | ------------------------------------------------------- | ----------------------------------------------------------- |
| **Couleur du texte tertiaire**           | Définit la couleur du texte de troisième niveau         | Valeurs de couleur standard, classes utilitaires de couleur |
| **Taille de police du texte tertiaire**  | Modifie la taille du texte tertiaire                    | Valeurs de taille de police (par ex. 12px, 1rem)            |
| **Style de police du texte tertiaire**   | Contrôle le style de police (par ex. italique, oblique) | Options de style de police standard                         |
| **Graisse de police du texte tertiaire** | Définit le niveau de gras du texte tertiaire            | Valeurs de graisse de police (par ex. normal, gras)         |
| {% endtab %}                             |                                                         |                                                             |

{% tab title="Icône" %}

| Nom de la propriété                                  | Description                                                    | Valeurs possibles                                           |
| ---------------------------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------- |
| **Couleur d’arrière-plan de l’icône**                | Définit la couleur d’arrière-plan de la zone d’icône           | Valeurs de couleur standard, classes utilitaires de couleur |
| **Couleur de premier plan de l’icône**               | Définit la couleur de l’image de l’icône ou des initiales      | Valeurs de couleur standard, classes utilitaires de couleur |
| **Utilitaire de couleur de premier plan de l’icône** | Applique un schéma de couleurs prédéfini à l’icône             | Noms spécifiques de classes utilitaires                     |
| **Ajustement de l’objet de l’image de l’icône**      | Contrôle la façon dont une image d’icône s’adapte à son espace | remplir, contenir, couvrir, aucun, réduire                  |
| {% endtab %}                                         |                                                                |                                                             |

{% tab title="Bordure" %}

| Nom de la propriété       | Description                                                   | Valeurs possibles                                           |
| ------------------------- | ------------------------------------------------------------- | ----------------------------------------------------------- |
| **Taille de la bordure**  | Spécifie la largeur de la bordure de l’Avatar                 | Valeurs en pixels (par ex. 1px, 2px)                        |
| **Rayon de bordure**      | Contrôle l’arrondi des coins de l’Avatar                      | Valeurs en pixels, % (par ex. 50 % pour un cercle)          |
| **Couleur de la bordure** | Définit la couleur de la bordure de l’Avatar                  | Valeurs de couleur standard, classes utilitaires de couleur |
| **Style de bordure**      | Définit l’apparence de la bordure (par ex. solide, en tirets) | Styles de bordure CSS standard                              |
| {% endtab %}              |                                                               |                                                             |

{% tab title="Initiales" %}

| Nom de la propriété                 | Description                                                    | Valeurs possibles                                           |
| ----------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------- |
| **Couleur des initiales**           | Définit la couleur du texte des initiales affichées            | Valeurs de couleur standard, classes utilitaires de couleur |
| **Couleur des initiales au survol** | Couleur des initiales lorsque l’Avatar est survolé             | Valeurs de couleur standard, classes utilitaires de couleur |
| **Graisse de police des initiales** | Contrôle le niveau de gras du texte des initiales              | Valeurs de graisse de police (par ex. normal, gras)         |
| **Couleur de l’entité**             | Couleur d’arrière-plan lorsque des initiales sont générées     | Valeurs de couleur standard, classes utilitaires de couleur |
| **Graisse de police de l’entité**   | Graisse de police des initiales générées à partir d’une entité | Valeurs de graisse de police (par ex. normal, gras)         |
| {% endtab %}                        |                                                                |                                                             |
| {% endtabs %}                       |                                                                |                                                             |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/experience-components/ax-avatar.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
