أنماط القائمة وخياراتها
انشر ملف الإعدادات:
php artisan vendor:publish --tag=filament-relation-navigator-config'menu' => [
'preset' => 'github', // 'simple'، أو نمط من عندك، أو اسم قالب
'presets' => [
'simple' => 'filament-relation-navigator::menu.simple',
'github' => 'filament-relation-navigator::menu.github',
],
'searchable' => true, // حقل بحث أعلى القائمة، أيًا كان النمط
'search_from' => 0, // ...ابتداء من هذا العدد من العناصر
'badges' => 'lazy', // شارات الـ relation managers: 'lazy' عند فتح القائمة، true مع الصفحة، false معطلة
'max_height' => '24rem',
'separator' => true, // صفحات السجل وصفحات العلاقات في كتلتين
'mobile' => true, // القائمة فوق عنوان الصفحة في الشاشات الصغيرة
'shortcut' => 'alt+shift+r', // يفتح القائمة؛ null يعطله
],النمط github (الافتراضي): يبقى آخر عنصر في مسار التنقل نصًا، ويفتح سهم صغير بجانبه لوحة فيها عنوان وحقل بحث وعلامة على الصفحة الحالية، مثل مبدّل المستودعات في GitHub. يحصل الحقل على التركيز عند فتح القائمة، ويفتح Enter أول نتيجة مطابقة.
النمط simple: آخر عنصر في مسار التنقل نفسه هو الذي يفتح القائمة. للحصول على قائمة الإصدار 1.2 وما قبله، اضبط 'preset' => 'simple' و 'searchable' => false.

الشارات
تعرض القائمة شارات الـ relation managers، كما في تبويباتها. افتراضيًا تُحمَّل عند فتح القائمة: تبقى القائمة مغلقة حتى ذلك الحين، فتُعرض الصفحة من دون استعلامات الشارات، وكذلك في كل طلب Livewire يعيد رسم مسار التنقل. يظهر مؤشر تحميل خلال اللحظة التي تستغرقها.
'badges' => 'lazy', // الافتراضي؛ true: مع الصفحة؛ false: بلا شاراتأوقفها حيث تحتاج:
// صفحة، أو resource (static): بلا شارات في هذه القائمة
public function hasRelationNavigatorBadges(): bool
{
return false;
}
// relation manager (مع InteractsWithRelationPage): تبقى شارته في
// التبويب، لا في القائمة
protected static bool $hasRelationNavigatorBadge = false;الـ relation manager الذي تكون شارة تبويبه مؤجلة التحميل (lazy) في Filament (protected static ?bool $isBadgeLazyLoaded = true;، أو $isBadgeDeferred في Filament 4.13) تكون شارته مؤجلة في القائمة أيضًا، حتى مع 'badges' => true.
قوالب القائمة التي لا تستطيع تحميل الشارات لاحقًا (قوالب الحزمة المنشورة قبل 1.3، أو أنماطك الخاصة التي تعرض $item->badge بنفسها) تحصل عليها مع الصفحة، كما في السابق: لا شيء يختفي.
لوحة المفاتيح: من حقل البحث، ينقلك السهم للأسفل إلى القائمة؛ ويتنقل السهمان للأعلى وللأسفل بين الصفحات، ويفتح Enter إحداها، ويغلق Escape القائمة.
الاختصار والتلميح

للزر الذي يفتح القائمة تلميح يعرض الاختصار، بمفاتيح Mac أو Windows/Linux. يفتح الاختصار القائمة من أي مكان في الصفحة، مع حقل البحث جاهزًا، مثل مبدّل المستودعات في GitHub: ⌥ ⇧ R على Mac، و Alt Shift R في غيره. غيّره في الإعدادات أو لكل صفحة:
'shortcut' => 'mod+shift+p', // mod هو ⌘ على Mac و Ctrl في غيرهpublic function getRelationNavigatorShortcut(): ?string
{
return null; // لا اختصار في هذه الصفحة
}صُمم كي لا يعترض طريقك:
- يطابق المفتاح الفعلي، فيعمل مع أي تخطيط للوحة المفاتيح ومع Option على Mac (حيث تكتب ⌥⇧R الرمز ‰)؛
- لا يفعل شيئًا أثناء الكتابة في حقل؛
- لا يأخذ أبدًا اختصارًا يستخدمه البحث العام في الـ panel (
globalSearchKeyBindings()): عندها تبقى القائمة بلا اختصار؛ - لا تُفتح إلا القائمة الظاهرة (في مسار التنقل أو في الشاشات الصغيرة).
المفاتيح المدعومة: alt وshift وctrl وmeta وmod مع حرف أو رقم أو / . , ;.

الصفحة ثم resource ثم config
لكل خيار ثلاثة مستويات. تفوز الصفحة، ثم الـ resource، ثم ملف الإعدادات (config):
| دالة الصفحة (static على الـ resource) | مفتاح الإعدادات |
|---|---|
getRelationNavigatorPreset(): string | menu.preset |
isRelationNavigatorSearchable(): bool | menu.searchable |
hasRelationNavigatorBadges(): bool | menu.badges |
hasDeferredRelationNavigatorBadges(): bool | menu.badges = 'lazy' |
getRelationNavigatorShortcut(): ?string | menu.shortcut |
hasRelationNavigatorMobileMenu(): bool | menu.mobile |
hasRelationNavigatorRecordNavigation(): bool | record_navigation |
shouldRelationNavigatorRecordNavigationFollowList(): bool | record_navigation_follows_list |
shouldRedirectRelationNavigatorTabs(): bool | redirect_relation_tabs |
// على صفحة واحدة
public function isRelationNavigatorSearchable(): bool
{
return false;
}// على resource: الدالة نفسها، static، لكل صفحاته
public static function hasRelationNavigatorRecordNavigation(): bool
{
return true;
}الشاشات الصغيرة
يخفي Filament مسار التنقل تحت عرض 40rem. هناك تظهر القائمة فوق عنوان الصفحة بدلًا من ذلك، في كل صفحة تستخدم HasRelationNavigator، بخيارات النمط نفسها. أوقفها بـ 'mobile' => false، أو لكل صفحة:
public function hasRelationNavigatorMobileMenu(): bool
{
return false;
}
الترجمات
32 لغة، بالرموز نفسها التي يستخدمها Filament: الألمانية، والإسبانية، والإندونيسية، والإنجليزية، والأوكرانية، والإيطالية، والبرتغالية (البرتغال والبرازيل)، والبلغارية، والبولندية، والتركية، والتشيكية، والدنماركية، والروسية، والرومانية، والسلوفاكية، والسويدية، والصينية (المبسطة والتقليدية)، والعبرية، والعربية، والفارسية، والفرنسية، والفنلندية، والفيتنامية، والكاتالونية، والكورية، والمجرية، والنرويجية، والهولندية، واليابانية، واليونانية. في اللغات التي تُكتب من اليمين إلى اليسار ينعكس اتجاه سهمي السابق والتالي. انشر الترجمات لتغييرها أو لإضافة لغة:
php artisan vendor:publish --tag=filament-relation-navigator-translationsنمط خاص بك
ابدأ من أحد أنماط الحزمة:
php artisan make:filament-relation-navigator-preset compact --from=githubينسخ الأمر النمط إلى resources/views/filament/relation-navigator/compact.blade.php. سجّله وغيّره كما تشاء:
'preset' => 'compact',
'presets' => [
// ...
'compact' => 'filament.relation-navigator.compact',
],يصلح أي اسم قالب (view) قيمةً لـ preset أيضًا. لتغيير أنماط الحزمة نفسها، انشر قوالبها:
php artisan vendor:publish --tag=filament-relation-navigator-viewsيتلقى قالب النمط:
| المتغير | المحتوى |
|---|---|
$label | آخر عنصر في مسار التنقل |
$items | عناصر القائمة: key، label، url، icon، badge، badgeColor، isActive |
$heading | «Switch page»، مترجمًا |
$isSearchable | هل يُعرض حقل البحث |
$hasSeparator | هل تُقسم صفحات السجل وصفحات العلاقات في كتلتين |
$shortcut | الاختصار، أو null |
$shortcutKeys | مفاتيح الاختصار المعروضة: ['mac' => [...], 'other' => [...]] |
$searchPlaceholder | «Find a page…»، مترجمًا |
$emptyLabel | «No pages found.»، مترجمًا |
$maxHeight | menu.max_height |
لمنح زرك التلميح والاختصار، ضمّن filament-relation-navigator::menu.partials.trigger-attributes داخل وسمه. لكل عنصر أيضًا isRelationPage(). لإعادة استخدام حقل البحث والقائمة (مع الفاصل والتنقل بلوحة المفاتيح) وسطر «لا نتائج»، ضمّن filament-relation-navigator::menu.partials.list مع showCheck.