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

أنماط القائمة وخياراتها ​

انشر ملف الإعدادات:

bash
php artisan vendor:publish --tag=filament-relation-navigator-config
php
'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.

النمط simple في صفحة العرض

الشارات ​

تعرض القائمة شارات الـ relation managers، كما في تبويباتها. افتراضيًا تُحمَّل عند فتح القائمة: تبقى القائمة مغلقة حتى ذلك الحين، فتُعرض الصفحة من دون استعلامات الشارات، وكذلك في كل طلب Livewire يعيد رسم مسار التنقل. يظهر مؤشر تحميل خلال اللحظة التي تستغرقها.

php
'badges' => 'lazy', // الافتراضي؛ true: مع الصفحة؛ false: بلا شارات

أوقفها حيث تحتاج:

php
// صفحة، أو 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 في غيره. غيّره في الإعدادات أو لكل صفحة:

php
'shortcut' => 'mod+shift+p', // mod هو ⌘ على Mac و Ctrl في غيره
php
public function getRelationNavigatorShortcut(): ?string
{
    return null; // لا اختصار في هذه الصفحة
}

صُمم كي لا يعترض طريقك:

  • يطابق المفتاح الفعلي، فيعمل مع أي تخطيط للوحة المفاتيح ومع Option على Mac (حيث تكتب ⌥⇧R الرمز ‰)؛
  • لا يفعل شيئًا أثناء الكتابة في حقل؛
  • لا يأخذ أبدًا اختصارًا يستخدمه البحث العام في الـ panel (globalSearchKeyBindings()): عندها تبقى القائمة بلا اختصار؛
  • لا تُفتح إلا القائمة الظاهرة (في مسار التنقل أو في الشاشات الصغيرة).

المفاتيح المدعومة: alt وshift وctrl وmeta وmod مع حرف أو رقم أو / . , ;.

النمط github مع حقل البحث

الصفحة ثم resource ثم config ​

لكل خيار ثلاثة مستويات. تفوز الصفحة، ثم الـ resource، ثم ملف الإعدادات (config):

دالة الصفحة (static على الـ resource)مفتاح الإعدادات
getRelationNavigatorPreset(): stringmenu.preset
isRelationNavigatorSearchable(): boolmenu.searchable
hasRelationNavigatorBadges(): boolmenu.badges
hasDeferredRelationNavigatorBadges(): boolmenu.badges = 'lazy'
getRelationNavigatorShortcut(): ?stringmenu.shortcut
hasRelationNavigatorMobileMenu(): boolmenu.mobile
hasRelationNavigatorRecordNavigation(): boolrecord_navigation
shouldRelationNavigatorRecordNavigationFollowList(): boolrecord_navigation_follows_list
shouldRedirectRelationNavigatorTabs(): boolredirect_relation_tabs
php
// على صفحة واحدة
public function isRelationNavigatorSearchable(): bool
{
    return false;
}
php
// على resource: الدالة نفسها، static، لكل صفحاته
public static function hasRelationNavigatorRecordNavigation(): bool
{
    return true;
}

الشاشات الصغيرة ​

يخفي Filament مسار التنقل تحت عرض 40rem. هناك تظهر القائمة فوق عنوان الصفحة بدلًا من ذلك، في كل صفحة تستخدم HasRelationNavigator، بخيارات النمط نفسها. أوقفها بـ 'mobile' => false، أو لكل صفحة:

php
public function hasRelationNavigatorMobileMenu(): bool
{
    return false;
}
القائمة على هاتف، فوق عنوان الصفحة

الترجمات ​

32 لغة، بالرموز نفسها التي يستخدمها Filament: الألمانية، والإسبانية، والإندونيسية، والإنجليزية، والأوكرانية، والإيطالية، والبرتغالية (البرتغال والبرازيل)، والبلغارية، والبولندية، والتركية، والتشيكية، والدنماركية، والروسية، والرومانية، والسلوفاكية، والسويدية، والصينية (المبسطة والتقليدية)، والعبرية، والعربية، والفارسية، والفرنسية، والفنلندية، والفيتنامية، والكاتالونية، والكورية، والمجرية، والنرويجية، والهولندية، واليابانية، واليونانية. في اللغات التي تُكتب من اليمين إلى اليسار ينعكس اتجاه سهمي السابق والتالي. انشر الترجمات لتغييرها أو لإضافة لغة:

bash
php artisan vendor:publish --tag=filament-relation-navigator-translations

نمط خاص بك ​

ابدأ من أحد أنماط الحزمة:

bash
php artisan make:filament-relation-navigator-preset compact --from=github

ينسخ الأمر النمط إلى resources/views/filament/relation-navigator/compact.blade.php. سجّله وغيّره كما تشاء:

php
'preset' => 'compact',
'presets' => [
    // ...
    'compact' => 'filament.relation-navigator.compact',
],

يصلح أي اسم قالب (view) قيمةً لـ preset أيضًا. لتغيير أنماط الحزمة نفسها، انشر قوالبها:

bash
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.»، مترجمًا
$maxHeightmenu.max_height

لمنح زرك التلميح والاختصار، ضمّن filament-relation-navigator::menu.partials.trigger-attributes داخل وسمه. لكل عنصر أيضًا isRelationPage(). لإعادة استخدام حقل البحث والقائمة (مع الفاصل والتنقل بلوحة المفاتيح) وسطر «لا نتائج»، ضمّن filament-relation-navigator::menu.partials.list مع showCheck.

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