Элементы навигационного меню - Twenty Documentation

Элемент навигационного меню — это запись в левой боковой панели. Используйте defineNavigationMenuItem() для добавления пользовательских ссылок на боковую панель — обычно по одной на каждое представление, которое вы поставляете, — или для указания на внешние URL-адреса.

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.

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

⌘I