upstream-twenty/packages/twenty-docs/l/fr/developers/extend/apps/layout/navigation-menu-items.mdx

---
title: Éléments de menu de navigation
description: Ajoutez des entrées personnalisées à la barre latérale de l’espace de travail — des liens vers des vues enregistrées ou des URL externes.
icon: bars
---

Un **élément de menu de navigation** est une entrée dans la barre latérale gauche. Utilisez `defineNavigationMenuItem()` pour ajouter des liens personnalisés dans la barre latérale — généralement un par [vue](/l/fr/developers/extend/apps/layout/views) — ou pour pointer vers des URL externes.

```ts src/navigation-menu-items/example-navigation-menu-item.ts
import { defineNavigationMenuItem, NavigationMenuItemType } from 'twenty-sdk/define';
import { EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER } from '../views/example-view';

export default defineNavigationMenuItem({
  universalIdentifier: '9327db91-afa1-41b6-bd9d-2b51a26efb4c',
  name: 'example-navigation-menu-item',
  icon: 'IconList',
  color: 'blue',
  position: 0,
  type: NavigationMenuItemType.VIEW,
  viewUniversalIdentifier: EXAMPLE_VIEW_UNIVERSAL_IDENTIFIER,
});
```

## Points clés

* `type` détermine la destination de l’élément de menu. Chaque type est associé à un champ d’identifiant spécifique :

  | Type                                 | Ce que cela fait                                   | Champ obligatoire                                                                          |
  | ------------------------------------ | -------------------------------------------------- | ------------------------------------------------------------------------------------------ |
  | `NavigationMenuItemType.VIEW`        | Ouvre une vue enregistrée                          | `viewUniversalIdentifier`                                                                  |
  | `NavigationMenuItemType.LINK`        | Ouvre une URL externe                              | `link`                                                                                     |
  | `NavigationMenuItemType.FOLDER`      | Regroupe les éléments imbriqués sous une étiquette | `name` (et les éléments enfants font référence au dossier via `folderUniversalIdentifier`) |
  | `NavigationMenuItemType.OBJECT`      | Ouvre la page d’index par défaut d’un objet        | `targetObjectUniversalIdentifier`                                                          |
  | `NavigationMenuItemType.PAGE_LAYOUT` | Ouvre une mise en page autonome                    | `pageLayoutUniversalIdentifier`                                                            |

* `position` contrôle l’ordre dans la barre latérale.

* L’énumération contient également `NavigationMenuItemType.RECORD`, utilisé en interne pour les favoris d’enregistrements créés par l’utilisateur — il n’est pas utilisable depuis un manifeste d’application (il n’existe aucun champ pour référencer un enregistrement).

* `icon` et `color` sont facultatifs et personnalisent l’apparence de l’entrée.

* `folderUniversalIdentifier` est également disponible sur n’importe quel élément pour l’imbriquer dans un parent de type `FOLDER`.

<Note>
**Piège courant :** créer un objet sans élément de menu de navigation associé rend cet objet inatteignable depuis la barre latérale. À moins qu’il ne s’agisse d’un objet technique/interne, chaque objet personnalisé devrait avoir une entrée dans la barre latérale qui renvoie vers cet objet.
</Note>