Skip to content
Esta página é uma tradução: se algo estiver diferente, a documentação em inglês é a referência. Ler em inglês

Presets e opções do menu ​

Publique a config:

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

O preset simple na página de visualização

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.

php
'badges' => 'lazy', // padrão; true: com a página; false: sem badges

Desligue onde precisar:

php
// 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 tooltip do botão do menu com o atalho dele

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:

php
'shortcut' => 'mod+shift+p', // mod é ⌘ no Mac e Ctrl nos outros sistemas
php
public 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 / . , ;.

O preset github com o campo de pesquisa

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(): 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
// Em uma página
public function isRelationNavigatorSearchable(): bool
{
    return false;
}
php
// 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:

php
public function hasRelationNavigatorMobileMenu(): bool
{
    return false;
}
O menu em um celular, acima do título da página

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:

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

Um preset só seu ​

Comece de um dos presets do pacote:

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

O comando copia o preset para resources/views/filament/relation-navigator/compact.blade.php. Registre-o e mude como quiser:

php
'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:

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

Uma view de preset recebe:

VariávelConteúdo
$labelO último item do breadcrumb
$itemsOs itens do menu: key, label, url, icon, badge, badgeColor, isActive
$heading"Switch page", traduzido
$isSearchableSe o campo de pesquisa aparece
$hasSeparatorSe as páginas do registro e as das relações ficam em dois blocos
$shortcutO atalho, ou null
$shortcutKeysAs teclas do atalho a mostrar: ['mac' => [...], 'other' => [...]]
$searchPlaceholder"Find a page…", traduzido
$emptyLabel"No pages found.", traduzido
$maxHeightmenu.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.

Versão 1.8.1, lançada em 2026-11-15 · Licença MIT.