> 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/application-shell.md).

# Shell d’application

Utilisez la mise en page du thème Application Shell pour donner à un site Experience Cloud un en-tête, des panneaux latéraux et un panneau inférieur, avec un panneau de gauche qui devient un tiroir sur les téléphones et les tablettes.

## Aperçu

Le **Shell d’application** est une mise en page de thème pour les sites Experience Cloud. Au lieu de construire la structure de votre site à partir de l’en-tête et du pied de page standard, vous disposez d’une mise en page avec un en-tête, un panneau gauche, un panneau droit et un panneau inférieur, autour du contenu de chaque page. Un cas d’utilisation typique est un portail interne où un menu de navigation reste à gauche, un flux de notifications se trouve à droite et une barre d’état s’étend en bas.

Vous placez des composants Avonni dans chaque panneau dans Experience Builder, par exemple un [**AX - Navigation**](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/experience-components/ax-navigation.md) dans le panneau gauche.

Sur un téléphone ou une tablette, le panneau gauche est masqué et s’ouvre comme un tiroir depuis un bouton dans l’en-tête, de sorte que la navigation n’occupe jamais la largeur d’un petit écran.

***

## Utilisez le Shell d’application comme mise en page de thème

1. Dans Experience Builder, ouvrez **Paramètres** et sélectionnez **Thème**.
2. Créez une nouvelle mise en page de thème, ou modifiez-en une existante, et choisissez **Shell d’application** comme composant.
3. Affectez cette mise en page de thème aux pages qui doivent l’utiliser, dans les propriétés de la page.
4. Sélectionnez la mise en page dans le canevas et définissez ses propriétés (voir ci-dessous). Ajoutez ensuite des composants à chaque région.

Si l’enregistrement de la mise en page de thème échoue avec le message « Pour utiliser la mise en page sélectionnée, ajoutez la ou les région(s) requise(s) suivante(s) », cela signifie que la mise en page ne contient pas ses régions de panneau droit et de panneau inférieur. Ajoutez `rightPanelRegion` et `bottomPanelRegion` à la mise en page de thème, puis enregistrez à nouveau. Elles doivent exister même lorsque **Afficher le panneau droit** et **Afficher le panneau inférieur** sont désactivés.

***

## Configuration

| Propriété                         | Description                                                                                              | Par défaut |
| --------------------------------- | -------------------------------------------------------------------------------------------------------- | ---------- |
| **Afficher l’en-tête**            | Affiche la région d’en-tête, en haut de la page.                                                         | Activé     |
| **Afficher le panneau gauche**    | Affiche le panneau gauche.                                                                               | Désactivé  |
| **Afficher le panneau droit**     | Affiche le panneau droit.                                                                                | Désactivé  |
| **Afficher le panneau inférieur** | Affiche le panneau inférieur.                                                                            | Désactivé  |
| **Largeur du panneau gauche**     | Largeur du panneau gauche, en pixels. C’est aussi la largeur du tiroir sur un téléphone ou une tablette. | `250`      |
| **Largeur du panneau droit**      | Largeur du panneau droit, en pixels.                                                                     | `250`      |
| **Hauteur du panneau inférieur**  | Hauteur du panneau inférieur, en pixels.                                                                 | `250`      |

Le contenu de la page occupe toujours l’espace laissé entre les panneaux et défile de manière autonome, de sorte que l’en-tête et les panneaux restent en place.

***

## Mise en page pour téléphone et tablette

Lorsqu’un visiteur ouvre le site sur un téléphone ou une tablette et que **Afficher le panneau gauche** est activé, la mise en page change :

* Le panneau gauche est masqué.
* Un bouton de menu apparaît au début de l’en-tête.
* La sélection du bouton ouvre le panneau gauche sous forme de tiroir au-dessus de la page, avec un arrière-plan sombre derrière lui et un bouton de fermeture en haut du tiroir.

Le tiroir se ferme lorsque le visiteur sélectionne le bouton de fermeture, sélectionne l’arrière-plan, appuie sur Échap ou accède à une autre page. Si **Afficher le panneau gauche** est désactivé, aucun bouton de menu n’apparaît.

La mise en page dépend du type d’appareil, et non de la largeur de l’écran. Une fenêtre de navigateur étroite sur un ordinateur conserve la mise en page de bureau. En dessous de 800 pixels de largeur, les panneaux gauche et droit se superposent au-dessus du contenu de la page au lieu d’être placés à côté de lui.

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Ffws3ZXhHTuwgXMV5xjzE%2Fexperience-application-shell-phone-drawer.png?alt=media" alt="Phone view of a site with the left panel open as a drawer, its close button at the top and a dark backdrop beside it" width="320"><figcaption><p>Sur un téléphone, le panneau gauche s’ouvre comme un tiroir</p></figcaption></figure>

***

## Conseils

* Pour vérifier la mise en page pour téléphone pendant votre travail, basculez l’aperçu d’Experience Builder sur le **mobile** mode d’affichage.
* Placez la navigation de votre site dans le panneau gauche. Sur un téléphone, une navigation placée là est accessible via le tiroir. L’option **Afficher les actions dans le menu mobile** du composant Navigation est un paramètre distinct pour le propre menu mobile de la navigation.


---

# 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/application-shell.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.
