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