Presets e opções do menu
Publique a config:
php artisan vendor:publish --tag=filament-relation-navigator-config'menu' => [
'preset' => 'github', // 'simple', um preset seu ou o nome de uma view
'presets' => [
'simple' => 'filament-relation-navigator::menu.simple',
'github' => 'filament-relation-navigator::menu.github',
],
'searchable' => true, // um campo de pesquisa acima da lista, com qualquer preset
'search_from' => 0, // ...a partir desta quantidade de itens
'badges' => 'lazy', // os badges dos relation managers: 'lazy' quando o menu abre, true com a página, false desligados
'max_height' => '24rem',
'separator' => true, // páginas do registro e páginas das relações em dois blocos
'mobile' => true, // o menu acima do título em telas pequenas
'shortcut' => 'alt+shift+r', // abre o menu; null desliga
],github (o padrão): o último item do breadcrumb continua sendo texto e uma setinha ao lado abre um painel com um título, um campo de pesquisa e um check na página atual, como o seletor de repositórios do GitHub. O campo recebe o foco quando o menu abre e Enter abre o primeiro resultado.
simple: o próprio último item do breadcrumb abre a lista. Para o menu da 1.2 e anteriores, defina 'preset' => 'simple' e 'searchable' => false.

Badges
O menu mostra os badges dos relation managers, como nas abas deles. Por padrão eles são carregados quando o menu abre: até lá o menu está fechado, então a página é renderizada sem as queries deles, também em cada requisição do Livewire que redesenha os breadcrumbs. Um spinner aparece durante o instante que eles levam.
'badges' => 'lazy', // padrão; true: com a página; false: sem badgesDesligue onde precisar:
// Uma página, ou um resource (static): sem badges neste menu
public function hasRelationNavigatorBadges(): bool
{
return false;
}
// Um relation manager (com InteractsWithRelationPage): o badge dele fica na
// aba, não no menu
protected static bool $hasRelationNavigatorBadge = false;Um relation manager cujo badge da aba é lazy no Filament (protected static ?bool $isBadgeLazyLoaded = true;, ou $isBadgeDeferred no Filament 4.13) também é lazy no menu, mesmo com 'badges' => true.
Views do menu que não conseguem carregar os badges depois (views do pacote publicadas antes da 1.3, ou presets seus que renderizam $item->badge por conta própria) recebem os badges com a página, como antes: nada desaparece.
Teclado: no campo de pesquisa, a seta para baixo entra na lista; as setas para cima e para baixo passam pelas páginas, Enter abre uma, Esc fecha o menu.
Atalho e tooltip

O botão que abre o menu tem um tooltip com o atalho, mostrado com as teclas do Mac ou do Windows/Linux. O atalho abre o menu de qualquer ponto da página, com o campo de pesquisa pronto, como o seletor de repositórios do GitHub: ⌥ ⇧ R no Mac, Alt Shift R nos outros sistemas. Mude na config ou por página:
'shortcut' => 'mod+shift+p', // mod é ⌘ no Mac e Ctrl nos outros sistemaspublic function getRelationNavigatorShortcut(): ?string
{
return null; // nenhum atalho nesta página
}Ele foi feito para não atrapalhar:
- reconhece a tecla física, então funciona com qualquer layout de teclado e com Option no Mac (onde ⌥⇧R digita ‰);
- não faz nada enquanto você digita em um campo;
- um atalho da pesquisa global do painel (
globalSearchKeyBindings()) nunca é tomado: nesse caso o menu fica sem atalho; - só o menu visível abre (breadcrumbs ou telas pequenas).
Teclas suportadas: alt, shift, ctrl, meta, mod mais uma letra, um dígito ou / . , ;.

Página, resource ou config
Cada opção tem três níveis. Vale primeiro a página, depois o resource, depois a config:
| Método da página (static no resource) | Chave da config |
|---|---|
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 |
// Em uma página
public function isRelationNavigatorSearchable(): bool
{
return false;
}// Em um resource: o mesmo método, static, para todas as suas páginas
public static function hasRelationNavigatorRecordNavigation(): bool
{
return true;
}Telas pequenas
O Filament esconde os breadcrumbs abaixo de 40rem. Nesse caso o menu aparece acima do título da página, em toda página que usa HasRelationNavigator, com as mesmas opções do preset. Desligue com 'mobile' => false, ou por página:
public function hasRelationNavigatorMobileMenu(): bool
{
return false;
}
Traduções
32 idiomas, com os mesmos códigos do Filament: alemão, árabe, búlgaro, catalão, chinês (simplificado e tradicional), coreano, dinamarquês, eslovaco, espanhol, finlandês, francês, grego, hebraico, holandês, húngaro, indonésio, inglês, italiano, japonês, norueguês, persa, polonês, português (Portugal e Brasil), romeno, russo, sueco, tcheco, turco, ucraniano e vietnamita. Nos idiomas da direita para a esquerda, as setas de anterior e próximo se invertem. Publique as traduções para mudá-las ou adicionar um idioma:
php artisan vendor:publish --tag=filament-relation-navigator-translationsUm preset só seu
Comece de um dos presets do pacote:
php artisan make:filament-relation-navigator-preset compact --from=githubO comando copia o preset para resources/views/filament/relation-navigator/compact.blade.php. Registre-o e mude como quiser:
'preset' => 'compact',
'presets' => [
// ...
'compact' => 'filament.relation-navigator.compact',
],Qualquer nome de view também funciona como preset. Para mudar os próprios presets do pacote, publique as views deles:
php artisan vendor:publish --tag=filament-relation-navigator-viewsUma view de preset recebe:
| Variável | Conteúdo |
|---|---|
$label | O último item do breadcrumb |
$items | Os itens do menu: key, label, url, icon, badge, badgeColor, isActive |
$heading | "Switch page", traduzido |
$isSearchable | Se o campo de pesquisa aparece |
$hasSeparator | Se as páginas do registro e as das relações ficam em dois blocos |
$shortcut | O atalho, ou null |
$shortcutKeys | As teclas do atalho a mostrar: ['mac' => [...], 'other' => [...]] |
$searchPlaceholder | "Find a page…", traduzido |
$emptyLabel | "No pages found.", traduzido |
$maxHeight | menu.max_height |
Para dar ao seu botão o tooltip e o atalho, inclua filament-relation-navigator::menu.partials.trigger-attributes dentro da tag dele. Cada item também tem isRelationPage(). Para reaproveitar o campo de pesquisa, a lista (com o separador e a navegação por teclado) e a linha de "nenhum resultado", inclua filament-relation-navigator::menu.partials.list com showCheck.