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

# AX - Navigation

Affichez une barre de navigation personnalisable avec des liens, des menus et des listes déroulantes sur les pages de site Experience Cloud, au-delà de la navigation standard du site.

## Présentation générale

**AX - Navigation** est un composant Experience Cloud qui affiche une barre de navigation personnalisable avec des liens et des menus sur les pages des sites Experience.

Utilisez-le pour créer des structures de navigation personnalisées au-delà de la navigation standard d’Experience Cloud, comme des menus secondaires, une navigation contextuelle ou des groupes de liens spécifiques à une action. Configurez les éléments de menu, le style, les menus déroulants et les destinations des liens dans Experience Builder, sans code.

Idéal pour la navigation personnalisée des pages, les menus contextuels, les liens d’actions rapides ou partout où votre portail a besoin d’une navigation au-delà de l’en-tête de site par défaut.

{% hint style="danger" %}
Ce composant [exploite des emplacements](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/premiers-pas/learning-the-basics.md#understanding-slots) pour une personnalisation avancée, ce qui le rend idéal pour les sites LWR. Les sites Aura ne prennent pas en charge ce niveau de personnalisation.
{% endhint %}

{% hint style="info" %}
Le composant de navigation Avonni est conçu avec une plus grande flexibilité à l’esprit. Contrairement à la navigation Salesforce standard, il permet des structures de menu plus complexes. Vous pouvez créer des menus à plusieurs niveaux — considérez-les comme des couches ou des étapes. Par exemple, vous pouvez avoir des éléments principaux (niveau 1), des sous-éléments en dessous (niveau 2) et même des sous-sous-éléments (niveau 3). Cette approche en couches facilite l’organisation et la présentation d’une grande quantité d’informations de manière structurée et accessible.

De plus, Avonni propose une gamme plus large d’options de style. Cela vous permet de personnaliser de près l’apparence de votre menu de navigation pour l’aligner sur le style de votre marque. Vous disposez de bien plus d’options que la simple couleur principale et les polices. Avonni permet une personnalisation plus poussée, vous aidant à créer une expérience de navigation visuellement attrayante qui semble être une extension naturelle de votre marque.
{% endhint %}

## Configuration

### Configuration générale

**Orientation** choisit `Horizontal` (la valeur par défaut — une barre de navigation traditionnelle en haut) ou `Vertical` (navigation de type barre latérale).

**Afficher le logo du site** active ou désactive l’affichage du logo du site dans le composant de navigation.

**Fixé en haut** maintient la barre de navigation en haut de la fenêtre pendant que les utilisateurs font défiler la page.

**Activer le menu mobile** active un menu optimisé pour mobile pour une meilleure navigation sur les petits écrans.

**Afficher les actions dans le menu mobile** déplace le contenu de l’emplacement `actions` dans le menu mobile, au-dessus des éléments de menu, au lieu de le laisser dans la barre de navigation. Cela s’applique uniquement lorsque le menu mobile est affiché, c’est-à-dire sur les écrans petits et moyens ; sur grand écran, les actions restent dans la barre. Cela n’a aucun effet lorsque **Orientation** est `Vertical`. Désactivé par défaut. Nécessite **Activer le menu mobile**.

<figure><img src="https://3803934262-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>Affichage des actions dans le menu mobile : les actions se placent au-dessus des éléments</p></figcaption></figure>

**Ouvrir le menu au survol** ouvre les menus déroulants lorsque l’utilisateur survole un élément de menu, au lieu d’exiger un clic.

**Ombré (obsolète)** ajoute un léger effet d’ombrage à la barre de navigation pour donner de la profondeur visuelle. Il est conservé pour les pages existantes ; stylisez la barre depuis l’onglet **Style** à la place.

**Afficher le petit triangle du menu déroulant** affiche un petit graphique en forme de flèche qui pointe vers l’élément de menu lorsque son menu déroulant est ouvert.

**Attributs de l’indicateur** ajoutez un indicateur visuel signalant qu’un contenu supplémentaire est disponible sous un élément de menu : activez **Afficher** puis définissez sa **Position**, `Avant` ou `Après` l’élément.

**Nom de l’API** est un identifiant unique utilisé pour référencer le composant. **Variante du menu mobile** choisit la façon dont le menu s’affiche sur les petits écrans (`Tiroir`, la valeur par défaut, ou `Liste déroulante`), et **Lien vers - logo du site** définit une interaction déclenchée lorsque le logo du site est cliqué.

### Source de données

La structure de navigation provient de l’une des trois sources suivantes :

| Type de source de données | Description                                                                                                                                                                              | Cas d’utilisation                                                                 |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| **Manuel**                | Saisissez directement chaque élément, sous-élément et sous-sous-élément dans le générateur.                                                                                              | Navigation fixe, et tout menu nécessitant des avatars ou plus de deux niveaux.    |
| **Requête**               | Créez chaque élément à partir des enregistrements d’un objet Salesforce.                                                                                                                 | Navigation pilotée par les données, comme une liste de catégories ou de produits. |
| **Menu de navigation**    | Réutilisez l’un des menus de navigation du site. Sélectionnez-le dans **Menu de navigation**, et activez **Afficher l’élément de menu Accueil** pour conserver l’entrée Accueil du menu. | Reprise de la navigation du site déjà gérée dans Experience Builder.              |

Avec une **Manuel** source, définissez chaque élément et ses propriétés :

**Libellé** est le texte affiché pour l’élément, et **Description** est un texte secondaire facultatif affiché avec lui. La description s’affiche en orientation verticale ; en orientation horizontale, la description d’un sous-élément s’affiche uniquement dans la variante `Tiroir` de menu.

**Étiquette** ajoute un petit badge à l’élément, **Variante d’étiquette** définit sa couleur (`Base`, `Marque`, `Inverse`, `Inverse alternatif`, `Succès`, `Info`, `Avertissement`, `Erreur` ou `Hors ligne`), **Contour de l’étiquette** dessine un contour autour, et **Info-bulle** définit le texte affiché au survol de l’élément.

**Avatar** configure un avatar facultatif sur l’élément : son **Variante** (`Cercle` ou `Carré`), le remplacement **Nom de l’icône**, la **Taille de l’icône** (`XXS`, `XS`, `Petit`, `Moyen` ou `Grand`) et la **Source de l’image**.

**Masquer le chevron** supprime le chevron de l’élément, de sorte qu’un clic n’importe où sur l’élément affiche ses sous-éléments.

**Libellé des sous-éléments et des sous-sous-éléments** est le texte affiché pour un sous-élément, et **Lien des sous-éléments et des sous-sous-éléments vers** est l’URL ou la page du site vers laquelle il pointe. Les éléments peuvent être imbriqués d’un niveau supplémentaire en « sous-sous-éléments » avec les mêmes paramètres.

Avec une **Requête** source, chaque élément est mappé à partir d’un champ de l’objet interrogé : **Libellé**, l’unique **Valeur**, **Description**, **Étiquette**, **Variante d’étiquette**, **Contour de l’étiquette**, **Info-bulle**, **Nom de l’icône**, **Taille de l’icône** (`XXS`, `XS`, `Petit`, `Moyen` ou `Grand`) et **Lien vers**, l’interaction exécutée lorsque l’élément est sélectionné.

### Apparence du menu

Le **Variante du menu** paramètre du composant Avonni Navigation pour Salesforce Experience Cloud détermine le style général et le comportement du menu.

{% hint style="info" %}
Si votre source de données est définie sur manuel et que votre menu inclut des sous-éléments, vous pouvez utiliser la fonctionnalité '**Variante du menu**' fonctionnalité.
{% 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>

Voici les significations typiques des variantes de menu :

#### Base

Le **Base** La variante représente le style standard d’un menu de navigation. Il est simple, avec des éléments de menu généralement listés sur une ligne en orientation horizontale ou en colonne en orientation verticale. Cette variante est épurée et minimaliste, ce qui en fait un bon choix pour la plupart des sites où un aspect classique est recherché.

#### Tiroir

Le **Tiroir** La variante implique un menu qui glisse depuis le côté, à la manière d’un tiroir ouvert. Ce style est souvent utilisé pour les menus verticaux, surtout sur mobile ou lorsque l’espace à l’écran est limité. Il garde la navigation discrète et accessible via une icône de menu (souvent une icône « hamburger ») jusqu’à ce qu’elle soit nécessaire.

<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>Exemple de variante tiroir</p></figcaption></figure>

#### Colonnes

Avec la **Colonnes** variante, les menus déroulants s’affichent en colonnes, ce qui permet une présentation structurée à plusieurs niveaux au sein même du menu déroulant. C’est particulièrement utile pour organiser une navigation complexe avec de nombreux éléments ou catégories, et facilite l’exploration des options par les utilisateurs.

<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>Exemple de variante colonnes</p></figcaption></figure>

#### Onglets

Le **Onglets** variante convertit les éléments de menu de premier niveau en navigation par onglets. Ce style est souvent utilisé lorsque différentes sections d’un site doivent être délimitées et accessibles directement depuis la barre de navigation. Il offre une interface familière aux utilisateurs, semblable aux onglets d’un classeur ou d’un navigateur web.

Chacune de ces variantes peut aider à définir l’expérience de navigation de votre site ; il est donc important d’en choisir une qui s’aligne sur les principes de conception de votre site et améliore le parcours utilisateur.<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>Exemple de variante onglets</p></figcaption></figure>

## Style

{% tabs %}
{% tab title="Paramètres généraux de navigation" %}

| Nom                                         | Description                                                                              |
| ------------------------------------------- | ---------------------------------------------------------------------------------------- |
| **Taille**                                  | Personnalisez les dimensions globales du menu de navigation.                             |
| **Couleur d’arrière-plan**                  | Définissez la couleur d’arrière-plan pour qu’elle corresponde au thème de votre site.    |
| **Largeur maximale du logo du site**        | Définissez la largeur maximale du logo du site pour une cohérence de marque.             |
| **Taille/couleur de la bordure inférieure** | Personnalisez la taille et la couleur de la bordure inférieure pour un rendu distinctif. |
| {% endtab %}                                |                                                                                          |

{% tab title="Paramètres des éléments de navigation" %}

| Nom                                         | Description                                                                                                                                                                                             |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Largeur de l’élément, largeur min./max.** | Spécifiez les dimensions de largeur de chaque élément de navigation.                                                                                                                                    |
| **Couleur d’arrière-plan de l’élément**     | Définissez des couleurs d’arrière-plan différentes pour les états actif et survol.                                                                                                                      |
| **Libellé de l’élément**                    | Nombreuses options de personnalisation du texte du libellé, notamment la couleur, la taille de police, la famille, la graisse et l’ombre, avec des paramètres distincts pour les états actif et survol. |
| **Description de l’élément**                | Personnalisez la couleur du texte, la taille de police, la famille, la graisse et l’ombre du texte pour les descriptions des éléments.                                                                  |
| **Bordure de l’élément**                    | Ajustez la taille et la couleur de la bordure avec des paramètres supplémentaires pour l’état actif.                                                                                                    |
| {% endtab %}                                |                                                                                                                                                                                                         |

{% tab title="Style des sous-éléments et du menu" %}

| Nom                                                      | Description                                                                                                                                                           |
| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Couleur d’arrière-plan du sous-élément (sélectionné)** | Choisissez une couleur d’arrière-plan pour les sous-éléments sélectionnés.                                                                                            |
| **Espacement des sous-éléments (bloc/en ligne)**         | Ajustez l’espacement autour des sous-éléments.                                                                                                                        |
| **Libellé du sous-élément**                              | Options de personnalisation de la couleur du texte, de la taille de police, de la famille, de la graisse et de l’ombre, y compris les paramètres de l’état au survol. |
| **Dimensions du menu**                                   | Définissez la taille du menu, avec des paramètres de largeur/hauteur min. et max.                                                                                     |
| **Largeur de colonne du menu**                           | Définissez la largeur des colonnes du menu.                                                                                                                           |
| **Espacement du menu (bloc/en ligne)**                   | Ajustez l’espacement dans le menu.                                                                                                                                    |
| **Bordure du menu**                                      | Personnalisez la couleur, la taille, le style et le rayon de la bordure du menu.                                                                                      |
| **Icône du menu**                                        | Définissez les couleurs pour les états normal, actif et au survol.                                                                                                    |
| **Libellé du groupe/colonne de menu**                    | Nombreuses options de personnalisation du texte pour les libellés de groupe et de colonne.                                                                            |
| {% endtab %}                                             |                                                                                                                                                                       |

{% tab title="Style du menu tiroir" %}

| Nom                                      | Description                                                                                                                     |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Couleur d’arrière-plan du tiroir**     | Paramètres distincts pour les couleurs d’arrière-plan de l’élément ouvert et secondaire.                                        |
| **Titre principal/secondaire du tiroir** | Personnalisez la couleur du texte, la taille de police, la famille, la graisse et l’ombre des titres principaux et secondaires. |
| **Description secondaire du tiroir**     | Options pour la couleur du texte, la taille de police, la famille, la graisse et l’ombre.                                       |
| {% endtab %}                             |                                                                                                                                 |

{% tab title="Style du tiroir mobile" %}

| Nom                                             | Description                                                                                                                 |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Titre principal/secondaire du tiroir mobile** | Options de personnalisation similaires à celles du tiroir de bureau, adaptées à l’affichage mobile.                         |
| **Description secondaire du tiroir mobile**     | Ajustez la couleur du texte, la taille de police, la famille, la graisse et l’ombre des descriptions dans le tiroir mobile. |
| {% 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-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.
