> 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-navigation.md).

# AX - Navigation

Zeigen Sie eine anpassbare Navigationsleiste mit Links, Menüs und Dropdowns auf Experience-Cloud-Site-Seiten an – zusätzlich zur standardmäßigen Seitennavigation.

## Überblick

**AX - Navigation** ist eine Experience-Cloud-Komponente, die auf Experience-Sites-Seiten eine anpassbare Navigationsleiste mit Links und Menüs anzeigt.

Verwenden Sie sie, um benutzerdefinierte Navigationsstrukturen über die standardmäßige Experience-Cloud-Navigation hinaus zu erstellen – etwa sekundäre Menüs, kontextbezogene Navigation oder linkgruppen für bestimmte Aktionen. Konfigurieren Sie Menüpunkte, Styling, Dropdowns und Linkziele in Experience Builder ohne Code.

Ideal für benutzerdefinierte Seitennavigation, kontextbezogene Menüs, Schnellaktionslinks oder überall dort, wo Ihr Portal Navigation über die standardmäßige Website-Kopfzeile hinaus benötigt.

{% hint style="danger" %}
Diese Komponente [nutzt Slots](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/erste-schritte/learning-the-basics.md#understanding-slots) für erweiterte Anpassungen und ist damit ideal für LWR-Sites. Aura-Sites unterstützen diesen Grad an Anpassung nicht.
{% endhint %}

{% hint style="info" %}
Die Avonni Navigation-Komponente ist mit Blick auf größere Flexibilität konzipiert. Im Gegensatz zur standardmäßigen Salesforce-Navigation ermöglicht sie komplexere Menüstrukturen. Sie können Menüs mit mehreren Ebenen erstellen – stellen Sie sich diese als Schichten oder Schritte vor. Beispielsweise können Sie Hauptpunkte (Ebene 1), darunterliegende Unterpunkte (Ebene 2) und sogar Unter-Unterpunkte (Ebene 3) haben. Dieser mehrschichtige Ansatz erleichtert es, eine große Menge an Informationen strukturiert und zugänglich zu organisieren und darzustellen.

Außerdem bietet Avonni eine breitere Auswahl an Styling-Optionen. Dadurch können Sie das Erscheinungsbild Ihres Navigationsmenüs eng an den Stil Ihrer Marke anpassen. Sie haben mehr als nur Optionen für Primärfarbe und Schriftart. Avonni ermöglicht tiefere Anpassungen und erlaubt Ihnen, ein Navigationserlebnis zu schaffen, das visuell ansprechend ist und sich wie eine natürliche Erweiterung Ihrer Marke anfühlt.
{% endhint %}

## Konfiguration

### Allgemeine Konfiguration

**Ausrichtung** wählt `Horizontal` (die Standardeinstellung – eine traditionelle obere Navigationsleiste) oder `Vertikal` (Navigation im Seitenleisten-Stil).

**Website-Logo anzeigen** schaltet die Anzeige des Website-Logos innerhalb der Navigationskomponente um.

**Oben fixiert** hält die Navigationsleiste beim Herunterscrollen auf der Seite oben im Sichtbereich.

**Mobiles Menü aktivieren** aktiviert ein für Mobilgeräte optimiertes Menü für eine bessere Navigation auf kleineren Bildschirmen.

**Aktionen im mobilen Menü anzeigen** verschiebt den Inhalt des `Aktionen` -Slots in das mobile Menü über den Menüpunkten, anstatt ihn in der Navigationsleiste zu belassen. Dies gilt nur, solange das mobile Menü angezeigt wird, also auf kleinen und mittleren Bildschirmen; auf einem großen Bildschirm bleiben die Aktionen in der Leiste. Es hat keine Wirkung, wenn **Ausrichtung** ist `Vertikal`. Standardmäßig deaktiviert. Erfordert **Mobiles Menü aktivieren**.

<figure><img src="https://4175360472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FBURkMJ0R6nZULofuF1eP%2Fexperience-ax-navigation-mobile-menu-actions.png?alt=media" alt="Phone preview of the mobile menu open with the account avatar action above the menu items" width="320"><figcaption><p>Aktionen im mobilen Menü anzeigen: Die Aktionen stehen über den Einträgen</p></figcaption></figure>

**Menü bei Hover öffnen** öffnet Dropdown-Menüs, wenn der Benutzer mit der Maus über einen Menüpunkt fährt, anstatt einen Klick zu erfordern.

**Schattiert (veraltet)** fügt der Navigationsleiste einen dezenten Schattierungseffekt für visuelle Tiefe hinzu. Es bleibt für bestehende Seiten erhalten; gestalten Sie die Leiste stattdessen über die **Stil** Registerkarte.

**Dropdown-Nubbin anzeigen** zeigt eine kleine pfeilartige Grafik an, die auf den Menüpunkt zeigt, wenn dessen Dropdown geöffnet ist.

**Indikatorattribute** fügen einen visuellen Indikator hinzu, der signalisiert, dass unter einem Menüpunkt weitere Inhalte verfügbar sind: Aktivieren Sie **Anzeigen** und legen Sie dann seine **Position**, `Vor` oder `Nach` dem Eintrag.

**API-Name** ist eine eindeutige Kennung, die zur Referenzierung der Komponente verwendet wird. **Variante des mobilen Menüs** wählt aus, wie das Menü auf kleinen Bildschirmen dargestellt wird (`Schublade`, die Standardeinstellung, oder `Dropdown`), und **Verknüpfen mit – Website-Logo** definiert eine Interaktion, die ausgelöst wird, wenn auf das Website-Logo geklickt wird.

### Datenquelle

Die Navigationsstruktur stammt aus einer von drei Quellen:

| Typ der Datenquelle | Beschreibung                                                                                                                                                                                              | Anwendungsfall                                                                   |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| **Manuell**         | Geben Sie jeden Eintrag, Untereintrag und Unteruntereintrag direkt im Builder ein.                                                                                                                        | Feste Navigation und jedes Menü, das Avatare oder mehr als zwei Ebenen benötigt. |
| **Abfrage**         | Erstellen Sie jeden Eintrag aus den Datensätzen eines Salesforce-Objekts.                                                                                                                                 | Datengetriebene Navigation, etwa eine Liste von Kategorien oder Produkten.       |
| **Navigationsmenü** | Verwenden Sie eines der eigenen Navigationsmenüs der Website erneut. Wählen Sie es in **Navigationsmenü** und aktivieren Sie **Startmenüeintrag anzeigen** , um den Home-Eintrag des Menüs beizubehalten. | Spiegelung der bereits in Experience Builder gepflegten Seitennavigation.        |

Mit einer **Manuell** Quelle definieren Sie jeden Eintrag und seine Eigenschaften:

**Bezeichnung** ist der für den Eintrag angezeigte Text, und **Beschreibung** ist optionaler sekundärer Text, der zusammen mit ihm angezeigt wird. Die Beschreibung wird in der vertikalen Ausrichtung angezeigt; in der horizontalen Ausrichtung wird die Beschreibung eines Untereintrags nur in der `Schublade` Menüvariante angezeigt.

**Tag** fügt dem Eintrag ein kleines Badge hinzu, **Tag-Variante** legt seine Farbe fest (`Basis`, `Marke`, `Invers`, `Alt-Invers`, `Erfolg`, `Info`, `Warnung`, `Fehler` oder `Offline`), **Tag-Umrandung** zeichnet eine Umrandung darum, und **Tooltip** legt den Text fest, der angezeigt wird, wenn Sie mit der Maus über den Eintrag fahren.

**Avatar** konfiguriert einen optionalen Avatar für den Eintrag: dessen **Variante** (`Kreis` oder `Quadrat`), den Fallback **Symbolname**, die **Symbolgröße** (`Sehr klein`, `Extra klein`, `Klein`, `Mittel` oder `Groß`) und die **Bildquelle**.

**Chevron ausblenden** entfernt das Chevron des Eintrags, sodass ein Klick irgendwo auf dem Eintrag dessen Untereinträge anzeigt.

**Bezeichnung für Untereinträge und Unteruntereinträge** ist der für einen Untereintrag angezeigte Text, und **Verknüpfen von Untereinträgen und Unteruntereinträgen mit** ist die URL oder Seite der Website, auf die verlinkt wird. Einträge können mit denselben Einstellungen noch eine Ebene weiter in „Unteruntereinträge“ verschachtelt werden.

Mit einer **Abfrage** Quelle wird jeder Eintrag einem Feld des abgefragten Objekts zugeordnet: **Bezeichnung**, die eindeutige **Wert**, **Beschreibung**, **Tag**, **Tag-Variante**, **Tag-Umrandung**, **Tooltip**, **Symbolname**, **Symbolgröße** (`Xxs`, `Xs`, `Klein`, `Mittel` oder `Groß`) und **Verknüpfen mit**, die Interaktion, die beim Auswählen des Eintrags ausgeführt wird.

### Erscheinungsbild des Menüs

Die **Menüvariante** Einstellung in der Avonni-Navigationskomponente für Salesforce Experience Cloud bestimmt den allgemeinen Stil und das Verhalten des Menüs.

{% hint style="info" %}
Wenn Ihre Datenquelle auf manuell eingestellt ist und Ihr Menü Untereinträge enthält, können Sie die Funktion „**Menüvariante**“ verwenden.
{% endhint %}

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-e2fb8e6c6de07edb9816cf714e46cca8d4c96a0b%2F2023-11-21_08-13-43.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Hier sind die typischen Bedeutungen der Menüvarianten:

#### Basis

Die **Basis** Die Variante steht für den Standardstil eines Navigationsmenüs. Sie ist unkompliziert, wobei Menüpunkte typischerweise in einer Zeile bei horizontaler Ausrichtung oder in einer Spalte bei vertikaler Ausrichtung aufgelistet werden. Diese Variante ist klar und minimalistisch und daher eine gute Wahl für die meisten Websites, auf denen ein klassisches Erscheinungsbild gewünscht ist.

#### Schublade

Die **Schublade** Die Variante impliziert ein Menü, das von der Seite hereingleitet, ähnlich einer geöffneten Schublade. Dieser Stil wird häufig für vertikale Menüs verwendet, insbesondere in mobilen Ansichten oder wenn Bildschirmfläche knapp ist. Die Navigation bleibt verborgen und ist über ein Menüsymbol (oft ein „Hamburger“-Symbol) zugänglich, bis sie benötigt wird.

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-3c6246c3ce6ac52a497ff1bdc120df8f59b26e68%2F2023-11-21_08-10-29.png?alt=media" alt=""><figcaption><p>Beispiel für die Schubladen-Variante</p></figcaption></figure>

#### Spalten

Mit der **Spalten** Variante werden Dropdown-Menüs in Spalten angezeigt, was innerhalb des Dropdowns selbst ein mehrstufiges, strukturiertes Layout ermöglicht. Dies ist besonders nützlich, um komplexe Navigation mit vielen Einträgen oder Kategorien zu organisieren und Benutzern das Durchsuchen der Optionen zu erleichtern.

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-794aefdc392c5dcd3656aeee3173b568091836b7%2F2023-11-21_08-09-24.jpg?alt=media" alt=""><figcaption><p>Beispiel für die Spalten-Variante</p></figcaption></figure>

#### Registerkarten

Die **Registerkarten** Die Variante wandelt die Menüpunkte der obersten Ebene in eine Navigation mit Registerkarten um. Dieser Stil wird häufig verwendet, wenn verschiedene Bereiche einer Website klar abgegrenzt und direkt über die Navigationsleiste zugänglich sein sollen. Er bietet Benutzern eine vertraute Oberfläche, ähnlich wie Registerkarten in einem Ordner oder in einem Webbrowser.

Jede dieser Varianten kann dazu beitragen, das Navigationserlebnis Ihrer Website zu gestalten. Daher ist es wichtig, eine auszuwählen, die mit den Designprinzipien Ihrer Website übereinstimmt und die Benutzerführung verbessert.<br>

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-7e84f7c8e2d88f0da6072a7e31522a47a8000274%2F2023-11-21_08-08-26.jpg?alt=media" alt=""><figcaption><p>Beispiel für die Registerkarten-Variante</p></figcaption></figure>

## Gestaltung

{% tabs %}
{% tab title="Allgemeine Navigationseinstellungen" %}

| Name                                  | Beschreibung                                                                                  |
| ------------------------------------- | --------------------------------------------------------------------------------------------- |
| **Größe**                             | Passen Sie die Gesamtabmessungen des Navigationsmenüs an.                                     |
| **Hintergrundfarbe**                  | Legen Sie die Hintergrundfarbe passend zum Design Ihrer Website fest.                         |
| **Maximale Breite des Website-Logos** | Definieren Sie die maximale Breite des Website-Logos für ein einheitliches Branding.          |
| **Größe/Farbe des unteren Rahmens**   | Passen Sie Größe und Farbe des unteren Rahmens für ein unverwechselbares Erscheinungsbild an. |
| {% endtab %}                          |                                                                                               |

{% tab title="Einstellungen für Navigationseinträge" %}

| Name                                 | Beschreibung                                                                                                                                                                                         |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Eintragsbreite, Min./Max.-Breite** | Geben Sie die Breitenmaße für jeden Navigationseintrag an.                                                                                                                                           |
| **Hintergrundfarbe des Eintrags**    | Legen Sie unterschiedliche Hintergrundfarben für aktive und Hover-Zustände fest.                                                                                                                     |
| **Bezeichnung des Eintrags**         | Umfangreiche Anpassungsoptionen für den Bezeichnungstext, einschließlich Farbe, Schriftgröße, Schriftfamilie, Schriftstärke und Schatten, mit separaten Einstellungen für aktive und Hover-Zustände. |
| **Beschreibung des Eintrags**        | Passen Sie Textfarbe, Schriftgröße, Schriftfamilie, Schriftstärke und Schatten für Eintragsbeschreibungen an.                                                                                        |
| **Rahmen des Eintrags**              | Passen Sie Rahmengröße und -farbe mit zusätzlichen Einstellungen für den aktiven Zustand an.                                                                                                         |
| {% endtab %}                         |                                                                                                                                                                                                      |

{% tab title="Gestaltung von Untereinträgen und Menüs" %}

| Name                                                | Beschreibung                                                                                                                                       |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Hintergrundfarbe des Untereintrags (ausgewählt)** | Wählen Sie eine Hintergrundfarbe für ausgewählte Untereinträge.                                                                                    |
| **Abstand der Untereinträge (Block/Inline)**        | Passen Sie den Abstand um Untereinträge an.                                                                                                        |
| **Bezeichnung des Untereintrags**                   | Optionen zum Anpassen von Textfarbe, Schriftgröße, Schriftfamilie, Schriftstärke und Schatten, einschließlich Einstellungen für den Hover-Zustand. |
| **Menüabmessungen**                                 | Legen Sie die Menügröße mit Einstellungen für minimale und maximale Breite/Höhe fest.                                                              |
| **Spaltenbreite des Menüs**                         | Definieren Sie die Breite der Spalten im Menü.                                                                                                     |
| **Menüabstand (Block/Inline)**                      | Passen Sie den Abstand innerhalb des Menüs an.                                                                                                     |
| **Menürahmen**                                      | Passen Sie Farbe, Größe, Stil und Radius des Menürahmens an.                                                                                       |
| **Menüsymbol**                                      | Legen Sie Farben für normalen, aktiven und Hover-Zustand fest.                                                                                     |
| **Bezeichnung der Menügruppe / Spalte**             | Umfangreiche Optionen zur Anpassung des Textes für Gruppen- und Spaltenbezeichnungen.                                                              |
| {% endtab %}                                        |                                                                                                                                                    |

{% tab title="Gestaltung des Schubladenmenüs" %}

| Name                                     | Beschreibung                                                                                                    |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Hintergrundfarbe der Schublade**       | Unterschiedliche Einstellungen für die geöffnete Eintrags- und die sekundäre Hintergrundfarbe.                  |
| **Haupt-/Sekundärtitel der Schublade**   | Passen Sie Textfarbe, Schriftgröße, Schriftfamilie, Schriftstärke und Schatten für Haupt- und Sekundärtitel an. |
| **Sekundäre Beschreibung der Schublade** | Optionen für Textfarbe, Schriftgröße, Schriftfamilie, Schriftstärke und Schatten.                               |
| {% endtab %}                             |                                                                                                                 |

{% tab title="Gestaltung der mobilen Schublade" %}

| Name                                             | Beschreibung                                                                                                                   |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| **Haupt-/Sekundärtitel der mobilen Schublade**   | Anpassungsoptionen ähnlich wie bei der Desktop-Schublade, auf die mobile Ansicht zugeschnitten.                                |
| **Sekundäre Beschreibung der mobilen Schublade** | Passen Sie Textfarbe, Schriftgröße, Schriftfamilie, Schriftstärke und Schatten für Beschreibungen in der mobilen Schublade an. |
| {% 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-navigation.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.
