عناصر قائمة التنقّل

​

نظرة عامة

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: 'IconCompass',
  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
  NavigationMenuItemType.NATIVE_PAGE	يفتح صفحة مضمنة	nativePageKey: 'workflows' أو 'agents'

• position يتحكّم في الترتيب ضمن الشريط الجانبي.
• يُخفى عنصر NATIVE_PAGE عن الأعضاء الذين لا يملكون إذن الصفحة (سير العمل لـ 'workflows'، والذكاء الاصطناعي لـ 'agents').
• يحتوي التعداد أيضًا على NavigationMenuItemType.RECORD، ويُستخدم داخليًا لمفضّلات السجلات التي ينشئها المستخدم، وعلى NavigationMenuItemType.AGENT_CHAT_CHANNEL، ويُستخدم لقنوات الدردشة المثبّتة في المفضّلات. لا يمكن استخدام أيٍّ منهما من بيان التطبيق (إذ لا يوجد حقل للإشارة إلى سجل أو قناة).
• icon وcolor اختياريان ويخصّصان مظهر الإدخال.
• folderUniversalIdentifier متاح أيضًا على أي عنصر لوضعه متداخلًا داخل عنصر أب من النوع FOLDER.
• يقوم twenty app pull بكتابة عناصر قائمة التنقل الخاصة بك مرة أخرى كملفات defineNavigationMenuItem(). ينتمي عنصر أضافه عضو مساحة عمل إلى شريطه الجانبي الخاص، وعنصر مثبّت إلى سجل، إلى مساحة العمل تلك بدلاً من تطبيقك، ويُبلّغ عنهما بدلاً من ذلك؛ راجع ما لا تكتبه عملية السحب.