Skip to main content
يُعَدّ عنصر قائمة التنقّل إدخالًا في الشريط الجانبي الأيسر. استخدم defineNavigationMenuItem() لتوفير روابط شريط جانبي مخصّصة — عادةً واحدًا لكل عرض توفّره — أو للإشارة إلى عناوين URL خارجية.
src/navigation-menu-items/example-navigation-menu-item.ts

النقاط الرئيسية

  • يحدّد type ما الذي يرتبط به عنصر القائمة. كل نوع يقترن بحقل معرّف محدّد:
  • position يتحكّم في الترتيب ضمن الشريط الجانبي.
  • يحتوي التعداد أيضًا على NavigationMenuItemType.RECORD، ويُستخدم داخليًا للمفضّلات التي ينشئها المستخدم للسجلات — ولا يمكن استخدامه من بيان التطبيق (app manifest) لعدم وجود حقل للإشارة إلى سجل.
  • icon وcolor اختياريان ويخصّصان مظهر الإدخال.
  • folderUniversalIdentifier متاح أيضًا على أي عنصر لوضعه متداخلًا داخل عنصر أب من النوع FOLDER.
مشكلة شائعة: إنشاء كائن بدون عنصر قائمة تنقّل مرتبط يجعل ذلك الكائن غير قابل للوصول من الشريط الجانبي. ما لم يكن كائنًا تقنيًا/داخليًا، يجب أن يحتوي كل كائن مخصّص على عنصر في الشريط الجانبي يشير إليه.