내비게이션 메뉴 항목

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 유형의 상위 항목 안에 중첩할 수 있습니다.