Skip to content
هذه الصفحة مترجمة: إذا اختلف شيء، فالتوثيق الإنجليزي هو المرجع. اقرأها بالإنجليزية

مرجع الـ API ​

كل ما يلي API عامة، يغطيها الإصدار الدلالي: لا تتغير بشكل يكسر التوافق ضمن 1.x. كل ما ليس مذكورًا هنا داخلي.

الـ traits ​

الـ traitأين يُستخدمماذا يفعل
Concerns\HasRelationPagesresourceيحصل كل relation manager على صفحة خاصة به
Concerns\InteractsWithRelationPagerelation managerيحصل هذا الـ relation manager على صفحة؛ ويقرأ الخصائص الثابتة الاختيارية أدناه
Concerns\HasRelationNavigatorصفحة سجل (عرض، تعديل، مخصصة)قائمة مسار التنقل، وتُدرج الصفحة فيها

كلها في مساحة الأسماء Wit3\FilamentRelationNavigator.

على resource ​

كلها static، وكلها اختيارية.

الدالةالغرض
hasRelationPage(string $slug): boolاستبعاد علاقة
canAccessRelationPage(Model $record, string $slug): boolمنع صفحة علاقة لسجل (الصفحات، القائمة، البحث العام، إعادة التوجيه)
relationPageHeader(Schema $schema): Schemaالترويسة فوق العلاقة في كل صفحات العلاقات
getRelationPageHeaderActions(): arrayإجراءات الترويسة في صفحات العلاقات
getRelationPageHeaderWidgets(): array، getRelationPageFooterWidgets(): arrayالـ widgets في صفحات العلاقات (تتلقى $record)
hasRelationPageLinks(): bool«فتح كصفحة» على الـ relation managers التابعة له
configureRelationPageAction(Action $action, RelationManager $manager): Actionتغيير ذلك الإجراء لهذا الـ resource
hasRelationPageGlobalSearchActions(): boolروابط البحث العام لهذا الـ resource
أي دالة خيار، بصيغة staticالخيار لكل صفحات الـ resource

على relation manager ​

كلها static، وكلها اختيارية. تحتاج الخصائص إلى InteractsWithRelationPage؛ أما الدوال فتعمل من دونه.

الخاصية أو الدالةالغرض
$hasRelationPage، hasRelationPage(): boolصفحة لهذا الـ relation manager أو لا
$relationPageSlug، getRelationPageSlug(): ?stringالـ slug الخاص بصفحته
$hasRelationPageLink، hasRelationPageLink(): bool«فتح كصفحة» على جدوله
$hasRelationPageGlobalSearchAction، hasRelationPageGlobalSearchAction(): boolرابطه تحت نتائج البحث العام
$hasRelationNavigatorBadge، hasRelationNavigatorBadge(): boolشارته في القائمة (يحتفظ التبويب بشارته)
getRelationPageTitle(Model $ownerRecord)عنوان صفحته؛ null يبقي القيمة الافتراضية
getRelationPageSubheading(Model $ownerRecord)العنوان الفرعي لصفحته
getRelationPageBreadcrumb(Model $ownerRecord): ?stringآخر عنصر في مسار التنقل لصفحته
relationPageHeader()، getRelationPageHeaderActions()، getRelationPageHeaderWidgets()، getRelationPageFooterWidgets()كما على الـ resource، لصفحته فقط
configureRelationPageAction(Action $action, RelationManager $manager): Actionتغيير إجراء «فتح كصفحة» الخاص به

دالة Filament نفسها isBadgeLazyLoaded() (أو $isBadgeLazyLoaded) تجعل شارته في القائمة مؤجلة التحميل أيضًا.

على صفحة سجل (HasRelationNavigator) ​

أعد تعريف أي منها على الصفحة:

الدالةالغرض
دوال الخياراتخيارات هذه الصفحة
getRelationNavigatorRecordNavigationQuery(): ?Builderالسجلات التي يتنقل بينها زرا السابق والتالي
withRelationNavigator(array $breadcrumbs): arrayإضافة القائمة إلى عناصر مسار تنقل تبنيها بنفسك

صنف صفحة علاقة خاص بك ​

وسّع Pages\RelationPage (أو شغّل php artisan make:filament-relation-navigator CustomerResource)، وأضف ...CustomerRelationPage::relationRoutes() إلى getPages().

العضوالغرض
protected static ?array $relationsهذه الـ slugs فقط
protected static array $excludedRelationsليس هذه الـ slugs أبدًا
protected static ?string $contextPageمفتاح الصفحة التي يقوم مقامها (الافتراضي: صفحة العرض، وإلا فصفحة التعديل)
$title، $subheading، $breadcrumb، وكل دوال صفحات Filamentكما في أي صفحة Filament

الدوال المساعدة ​

الدوال الثابتة في RelationNavigator:

الدالةالغرض
getItems(string $resource, Model $record, ...)عناصر القائمة لسجل
getRecordSubNavigation(Page $page): arrayالعناصر نفسها بصيغة التنقل الفرعي في Filament
getRelationManagerPageUrl(RelationManager $manager): ?stringصفحة relation manager، لأزرار من عندك
getGlobalSearchResultActions(string $resource, Model $record): arrayروابط البحث العام، لدمجها مع روابطك
configureRelationPageActionUsing(Closure $callback): voidتغيير كل إجراءات «فتح كصفحة»
makeRelationPageAction(RelationManager $manager): Actionبناء ذلك الإجراء
getRelationPageClass(string $resource): ?stringصنف صفحة العلاقات لـ resource
RELATION_PAGE_ACTIONاسم إجراء «فتح كصفحة»

RelationNavigatorItem (في $items): key، label، url، icon، badge، badgeColor، isActive، isBadgeDeferred، isRelationPage().

المسارات والقوالب والأوامر ​

  • أسماء المسارات: {resource route base}.relations.{slug}، لاستخدامها في getUrl('relations.orders', [...]).
  • القوالب: filament-relation-navigator::menu.github، menu.simple، menu.mobile، menu.partials.list، menu.partials.trigger-attributes. متغيراتها مذكورة في نمط خاص بك.
  • الأوامر: make:filament-relation-navigator {resource}، make:filament-relation-navigator-preset {name} --from=github|simple.
  • الترجمات: filament-relation-navigator::navigator.*.

الإصدار 1.8.1، صدر في 2026-11-15 · رخصة MIT.