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

---
title: Элементы навигационного меню
description: Добавляйте на боковую панель рабочего пространства пользовательские элементы — ссылки на сохраненные представления или внешние URL-адреса.
icon: bars
---

**Элемент навигационного меню** — это запись в левой боковой панели. Используйте `defineNavigationMenuItem()` для добавления пользовательских ссылок на боковую панель — обычно по одной на каждое [представление](/l/ru/developers/extend/apps/layout/views), которое вы поставляете, — или для указания на внешние URL-адреса.

```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,
});
```

## Основные моменты

* `type` определяет, на что указывает элемент меню. Каждый тип сопоставляется с определенным полем идентификатора:

  | Тип                                  | Что делает                                      | Обязательное поле                                                                 |
  | ------------------------------------ | ----------------------------------------------- | --------------------------------------------------------------------------------- |
  | `NavigationMenuItemType.VIEW`        | Открывает сохраненное представление             | `viewUniversalIdentifier`                                                         |
  | `NavigationMenuItemType.LINK`        | Открывает внешний URL-адрес                     | `link`                                                                            |
  | `NavigationMenuItemType.FOLDER`      | Группирует вложенные элементы под меткой        | `name` (а дочерние элементы ссылаются на папку через `folderUniversalIdentifier`) |
  | `NavigationMenuItemType.OBJECT`      | Открывает страницу индекса по умолчанию объекта | `targetObjectUniversalIdentifier`                                                 |
  | `NavigationMenuItemType.PAGE_LAYOUT` | Открывает отдельный макет страницы              | `pageLayoutUniversalIdentifier`                                                   |

* `position` управляет порядком в боковой панели.

* Перечисление также содержит `NavigationMenuItemType.RECORD`, используемый внутренне для добавляемых пользователем в «Избранное» записей — он не может использоваться из манифеста приложения (нет поля для ссылки на запись).

* `icon` и `color` являются необязательными и настраивают внешний вид элемента.

* `folderUniversalIdentifier` также доступен для любого элемента, чтобы поместить его внутрь родительского элемента типа `FOLDER`.

<Note>
**Распространенная ошибка:** создание объекта без связанного элемента навигационного меню делает этот объект недоступным через боковую панель. Если только это не технический/внутренний объект, у каждого настраиваемого объекта должен быть элемент боковой панели, указывающий на него.
</Note>