github-actions[bot]
b754e15331
Created by Github action Co-authored-by: github-actions <github-actions@twenty.com>
47 lines
3.4 KiB
Plaintext
47 lines
3.4 KiB
Plaintext
---
|
||
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>
|