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

# AX - Avatar

## Überblick

**AX - Avatar** ist eine Experience-Cloud-Komponente, die Profilbilder, Initialen oder Symbole auf Experience-Sites-Seiten anzeigt, um Benutzer, Kontakte, Konten oder beliebige Salesforce-Datensätze darzustellen.

Verwende sie, um Portal-Benutzerprofile, Ansprechpartner, Kontaktlisten oder Entitätskennungen mit einheitlichem visuellen Stil anzuzeigen. Die Komponente zeigt automatisch Bilder an, wenn sie verfügbar sind, oder weicht andernfalls auf Initialen oder Symbole aus.

Perfekt für Benutzerprofil-Kopfzeilen, Listen von Community-Mitgliedern, Kontaktverzeichnisse oder überall dort, wo Portal-Benutzer eine visuelle Identifikation von Personen oder Entitäten benötigen.

## Konfiguration

Die Avonni-Avatar-Komponente hilft dir, visuell einheitliche Darstellungen von Benutzern oder Entitäten innerhalb deiner Salesforce-Experience-Cloud-Site zu erstellen. Hier ist eine Schritt-für-Schritt-Anleitung, um den Avatar an deine Bedürfnisse anzupassen:

### Initialen anzeigen

Die Avatar-Komponente bietet Flexibilität bei der Anzeige von Initialen:

#### **Manuelle Eingabe**

Wenn du die anzuzeigenden Initialen kennst, gib sie direkt in das Feld „Initialen“ ein.

<figure><img src="https://4175360472-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>

#### **Dynamische Generierung (Ausdrücke)**

Um deine Avonni-Komponenten dynamisch zu machen, kannst du [Experience-Cloud-Ausdrücke](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/erste-schritte/learning-the-basics.md#expressions)verwenden. Im folgenden Avatar-Beispiel kannst du beispielsweise den folgenden Ausdruck verwenden, um automatisch den Namen des aktuell angemeldeten Benutzers anzuzeigen:

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

Du kannst `Name` durch den tatsächlichen Feldnamen ersetzen, in dem der Name des Benutzers in deiner Salesforce-Organisation gespeichert ist.

Wenn du Initialen automatisch aus einem vollständigen Namen generieren möchtest, aktiviere die Option „Initialen automatisch formatiert“. Dadurch werden Experience-Cloud-Ausdrücke verwendet, um den ersten Buchstaben jedes Wortes im Namen zu extrahieren und zu formatieren.

<figure><img src="https://4175360472-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>Initialen dynamisch aus dem Namen des aktuellen Benutzers anzeigen</p></figcaption></figure>

### Benutzerdefiniertes Bild

Füge ein Profilfoto, ein Logo oder ein beliebiges Bild hinzu, damit der Avatar sofort erkennbar ist. Lade dein Bild über die **Ausgewählte Inhalte** -Option hoch; die Komponente beschneidet und formatiert es automatisch so, dass es in die Avatar-Form passt.

Wenn kein Bild hinzugefügt wird, zeigt der Avatar stattdessen Initialen an

### Variante (Form)

Wähle zwischen **Quadrat** (die Standardoption) und **Kreis** über das Feld **Variante** aus, um es an das Design deines Portals anzupassen. Runde Avatare eignen sich gut für Personen, während quadratische Formen sich für Logos oder Entitätssymbole eignen

<figure><img src="https://4175360472-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>

### Größe

Steuere, wie groß der Avatar auf der Seite angezeigt wird, über die **Größe** Eigenschaft. Die Optionen reichen von **X-Klein** bis **Klein**, **Mittel** (Standard), **Groß** und **X-Groß** bis **XX-Groß**und lassen sich so mit dem umgebenden Inhalt ausbalancieren – kleiner für Inline-Listen, größer für Profil-Kopfzeilen.

### Primär- und Sekundärtext

Zeige zusätzlichen Kontext neben dem Avatar an, indem du Textfelder hinzufügst. Verwende **Primärtext** für die wichtigsten Informationen (z. B. einen vollständigen Namen) und **Sekundärtext** für ergänzende Details (z. B. Berufsbezeichnung oder E-Mail).

Du kannst außerdem für jede Textebene Schriftstile festlegen, um eine visuelle Hierarchie zwischen den primären und sekundären Informationen zu schaffen.

<figure><img src="https://4175360472-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>

### Tags

Füge visuelle Labels hinzu, um Informationen über den Avatar zu kategorisieren oder hervorzuheben. Jeder Tag hat einen **Beschriftung** und einen **Variante** der das Badge einfärbt — `Alt Inverse`, `Basis`, `Marke`, `Fehler`, `Info`, `Invertiert`, `Offline`, `Erfolgreich` oder `Warnung` — nützlich, um Status, Abteilung, Rolle oder einen beliebigen Kurzbezeichner anzuzeigen.

### Eigenschaften

**Initialen** zeigt bestimmte Initialen für einen Benutzer oder eine Entität an, und **Initialen automatisch formatiert** generiert sie automatisch aus einem angegebenen vollständigen Namen, um eine konsistente Darstellung ohne manuelle Eingabe zu ermöglichen.

**Fallback-Symbolname** legt das Ersatzsymbol fest, das angezeigt wird, wenn Primärdaten (ein Bild oder Initialen) fehlen, und sorgt so für visuelle Kontinuität. Standardmäßig ist `standard:account`.

**CMS-Bild** und **Bild-URL oder Ausdruck** legt das Bild des Avatars fest — verweise auf ein CMS-verwaltetes Asset oder gib eine URL/einen Ausdruck an. **Href** macht den Avatar zu einem Link zur angegebenen Adresse.

**Variante** wählt eine `Quadrat` (Standard) oder `Kreis` Form und **Größe** passt die Gesamtgröße an (`X-Klein`, `Klein`, `Mittel` (Standard), `Groß`, `X-Groß`, `XX-Groß`). **Symbolposition** richtet das Fallback-Symbol innerhalb des Avatars aus (`Start`, `Mitte` (Standard), `Ende`).

**Primärtext**, **Sekundärtext**, und **Tertiärtext** zeigt den Haupt-, den ergänzenden und den Text der dritten Ebene neben dem Avatar an (oft ein Name, dann eine Rolle und dann ein Zusatzdetail). Jeder hat eine eigene **Textstil** Einstellung direkt darunter im Bereich — `Überschrift 1` bis `Überschrift 4`, oder `Absatz 1` / `Absatz 2`. **Textposition** gibt die Ausrichtung dieser Texte relativ zum Avatar an (`Links`, `Mitte`, `Rechts` (Standard)).

**Avatar-Details ausblenden** zeigt zusätzliche Details, die dem Avatar zugeordnet sind, wie Texte oder Tags, an oder blendet sie aus.

**Tags** füge dem Avatar Badge-Tags als Kategoriemarker oder Indikatoren hinzu.

**Entitätssymbolname**, **Entitätsinitialen**, **Entitätsbildquelle**, **Entitätsvariante**, und **Entitätsposition** konfiguriere ein sekundäres „Entitäts“-Badge, das über dem Avatar eingeblendet wird — sein Symbol, seine Initialen, sein Bild, seine Form (`Quadrat`, die Standardoption, oder `Kreis`) und seine Eckposition (`oben links` (Standard), `oben rechts`, `Unten links`, `Unten rechts`).

**Aktionen** füge dem Avatar Aktionsschaltflächen hinzu — jede mit Beschriftung, Symbol, Name und Klickaktion — sowie ein Menüsymbol und eine Menüposition (`Unten links`, `Unten rechts`, `oben links`, `oben rechts`) werden verwendet, sobald mehr als eine Aktion vorhanden ist. **Verlinken auf** definiert eine Aktion, die ausgelöst wird, wenn auf den Avatar geklickt wird.

## Anwendungsfälle

**Benutzerprofile** – Erstelle vollständige Profil-Kopfzeilen, indem du ein benutzerdefiniertes Bild mit Primärtext für den Namen des Benutzers und Sekundärtext für seine Berufsbezeichnung oder Abteilung kombinierst. So erhalten Portal-Benutzer eine klare, professionelle Darstellung auf ihren Profilseiten.

**Community-Foren** – Zeige Avatare neben Beiträgen und Kommentaren an, damit Community-Mitglieder schnell erkennen können, wer etwas beiträgt. Das verleiht eine persönliche Note, fördert die Interaktion und macht Unterhaltungen leichter nachvollziehbar.

**Teamseiten** – Präsentiere Teammitglieder mit Avataren, die Namen, Rollen und Tags für Abteilung oder Fachgebiet enthalten. So finden Portal-Benutzer schnell den richtigen Kontakt und verstehen die Teamstruktur auf einen Blick.

## Formatierung

{% tabs %}
{% tab title="Primärtext" %}

| Eigenschaftsname              | Beschreibung                                              | Mögliche Werte                           |
| ----------------------------- | --------------------------------------------------------- | ---------------------------------------- |
| **Primäre Textfarbe**         | Legt die Farbe des Haupttextes innerhalb des Avatars fest | Standard-Farbwerte, Farb-Utility-Klassen |
| **Primäre Textschriftgröße**  | Ändert die Größe des Primärtexts                          | Schriftgrößenwerte (z. B. 12px, 1rem)    |
| **Primärer Textfontstil**     | Steuert den Schriftstil (z. B. kursiv, schräg)            | Standard-Schriftstiloptionen             |
| **Primäre Textschriftstärke** | Definiert die Fettstärke des Primärtexts                  | Schriftstärkewerte (z. B. normal, fett)  |
| {% endtab %}                  |                                                           |                                          |

{% tab title="Sekundärtext" %}

| Eigenschaftsname                | Beschreibung                                   | Mögliche Werte                           |
| ------------------------------- | ---------------------------------------------- | ---------------------------------------- |
| **Sekundäre Textfarbe**         | Legt die Farbe des ergänzenden Textes fest     | Standard-Farbwerte, Farb-Utility-Klassen |
| **Sekundäre Textschriftgröße**  | Ändert die Größe des Sekundärtexts             | Schriftgrößenwerte (z. B. 12px, 1rem)    |
| **Sekundärer Textfontstil**     | Steuert den Schriftstil (z. B. kursiv, schräg) | Standard-Schriftstiloptionen             |
| **Sekundäre Textschriftstärke** | Definiert die Fettstärke des Sekundärtexts     | Schriftstärkewerte (z. B. normal, fett)  |
| {% endtab %}                    |                                                |                                          |

{% tab title="Tertiärtext" %}

| Eigenschaftsname               | Beschreibung                                     | Mögliche Werte                           |
| ------------------------------ | ------------------------------------------------ | ---------------------------------------- |
| **Tertiäre Textfarbe**         | Legt die Farbe des Textes der dritten Ebene fest | Standard-Farbwerte, Farb-Utility-Klassen |
| **Tertiäre Textschriftgröße**  | Ändert die Größe des Tertiärtexts                | Schriftgrößenwerte (z. B. 12px, 1rem)    |
| **Tertiärer Textfontstil**     | Steuert den Schriftstil (z. B. kursiv, schräg)   | Standard-Schriftstiloptionen             |
| **Tertiäre Textschriftstärke** | Definiert die Fettstärke des Tertiärtexts        | Schriftstärkewerte (z. B. normal, fett)  |
| {% endtab %}                   |                                                  |                                          |

{% tab title="Symbol" %}

| Eigenschaftsname                           | Beschreibung                                                 | Mögliche Werte                                  |
| ------------------------------------------ | ------------------------------------------------------------ | ----------------------------------------------- |
| **Symbol-Hintergrundfarbe**                | Legt die Hintergrundfarbe des Symbolbereichs fest            | Standard-Farbwerte, Farb-Utility-Klassen        |
| **Vordergrundfarbe des Symbols**           | Legt die Farbe des Symbolbilds oder der Initialen fest       | Standard-Farbwerte, Farb-Utility-Klassen        |
| **Vordergrundfarbe des Symbols – Utility** | Wendet ein vordefiniertes Farbschema auf das Symbol an       | Spezifische Utility-Klassennamen                |
| **Objektanpassung des Symbolbilds**        | Steuert, wie ein Symbolbild in seinen verfügbaren Raum passt | füllen, enthalten, abdecken, keine, verkleinern |
| {% endtab %}                               |                                                              |                                                 |

{% tab title="Rahmen" %}

| Eigenschaftsname | Beschreibung                                                                 | Mögliche Werte                             |
| ---------------- | ---------------------------------------------------------------------------- | ------------------------------------------ |
| **Rahmenstärke** | Gibt die Breite des Avatar-Rahmens an                                        | Pixelwerte (z. B. 1px, 2px)                |
| **Rahmenradius** | Steuert, wie stark die Ecken des Avatars abgerundet sind                     | Pixelwerte, % (z. B. 50 % für einen Kreis) |
| **Rahmenfarbe**  | Legt die Farbe des Avatar-Rahmens fest                                       | Standard-Farbwerte, Farb-Utility-Klassen   |
| **Rahmenstil**   | Definiert das Erscheinungsbild des Rahmens (z. B. durchgezogen, gestrichelt) | Standard-CSS-Rahmenstile                   |
| {% endtab %}     |                                                                              |                                            |

{% tab title="Initialen" %}

| Eigenschaftsname             | Beschreibung                                                           | Mögliche Werte                           |
| ---------------------------- | ---------------------------------------------------------------------- | ---------------------------------------- |
| **Initialenfarbe**           | Legt die Textfarbe für die angezeigten Initialen fest                  | Standard-Farbwerte, Farb-Utility-Klassen |
| **Initialenfarbe bei Hover** | Farbe der Initialen, wenn der Avatar mit der Maus darübergefahren wird | Standard-Farbwerte, Farb-Utility-Klassen |
| **Initialen-Schriftstärke**  | Steuert die Fettstärke des Initialentextes                             | Schriftstärkewerte (z. B. normal, fett)  |
| **Entitätsfarbe**            | Hintergrundfarbe, wenn Initialen generiert werden                      | Standard-Farbwerte, Farb-Utility-Klassen |
| **Entitäts-Schriftstärke**   | Schriftstärke der aus einer Entität generierten Initialen              | Schriftstärkewerte (z. B. normal, fett)  |
| {% 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-de/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.
