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 manager: '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 manager, как в их вкладках. По умолчанию они загружаются при открытии меню: до этого меню закрыто, поэтому страница рендерится без их запросов, в том числе при каждом запросе Livewire, который перерисовывает хлебные крошки. Пока они загружаются, виден спиннер.

php
'badges' => 'lazy', // по умолчанию; true: вместе со страницей; false: без бейджей

Отключите их там, где нужно:

php
// Страница или ресурс (static): без бейджей в этом меню
public function hasRelationNavigatorBadges(): bool
{
    return false;
}

// Relation manager (с InteractsWithRelationPage): его бейдж остаётся
// во вкладке, но не в меню
protected static bool $hasRelationNavigatorBadge = false;

Relation manager, у которого бейдж вкладки в 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 печатает ‰);
  • оно ничего не делает, пока вы печатаете в поле;
  • сочетание глобального поиска панели (globalSearchKeyBindings()) никогда не перехватывается: тогда у меню просто нет сочетания;
  • открывается только видимое меню (в хлебных крошках или на маленьких экранах).

Поддерживаемые клавиши: alt, shift, ctrl, meta, mod плюс буква, цифра или / . , ;.

Пресет github с полем поиска

Страница, ресурс или конфиг ​

У каждой опции три уровня. Приоритет у страницы, затем у ресурса, затем у конфига:

Метод страницы (static на ресурсе)Ключ конфига
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
// На ресурсе: тот же метод, 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',
],

В 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.