Пресеты и опции меню
Опубликуйте конфиг:
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 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.

Бейджи
Меню показывает бейджи relation manager, как в их вкладках. По умолчанию они загружаются при открытии меню: до этого меню закрыто, поэтому страница рендерится без их запросов, в том числе при каждом запросе Livewire, который перерисовывает хлебные крошки. Пока они загружаются, виден спиннер.
'badges' => 'lazy', // по умолчанию; true: вместе со страницей; false: без бейджейОтключите их там, где нужно:
// Страница или ресурс (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 в остальных системах. Измените его в конфиге или для отдельной страницы:
'shortcut' => 'mod+shift+p', // mod — это ⌘ на Mac и Ctrl в остальных системахpublic function getRelationNavigatorShortcut(): ?string
{
return null; // на этой странице без сочетания клавиш
}Оно сделано так, чтобы не мешать:
- оно привязано к физической клавише, поэтому работает с любой раскладкой и с Option на Mac (где ⌥⇧R печатает ‰);
- оно ничего не делает, пока вы печатаете в поле;
- сочетание глобального поиска панели (
globalSearchKeyBindings()) никогда не перехватывается: тогда у меню просто нет сочетания; - открывается только видимое меню (в хлебных крошках или на маленьких экранах).
Поддерживаемые клавиши: alt, shift, ctrl, meta, mod плюс буква, цифра или / . , ;.

Страница, ресурс или конфиг
У каждой опции три уровня. Приоритет у страницы, затем у ресурса, затем у конфига:
| Метод страницы (static на ресурсе) | Ключ конфига |
|---|---|
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;
}// На ресурсе: тот же метод, 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',
],В 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.