Presets y opciones del menú
Publica la config:
php artisan vendor:publish --tag=filament-relation-navigator-config'menu' => [
'preset' => 'github', // 'simple', un preset tuyo o el nombre de una vista
'presets' => [
'simple' => 'filament-relation-navigator::menu.simple',
'github' => 'filament-relation-navigator::menu.github',
],
'searchable' => true, // un campo de búsqueda encima de la lista, con cualquier preset
'search_from' => 0, // ...a partir de este número de elementos
'badges' => 'lazy', // los badges de los relation managers: 'lazy' al abrir el menú, true con la página, false desactivados
'max_height' => '24rem',
'separator' => true, // páginas del registro y páginas de relación en dos bloques
'mobile' => true, // el menú encima del título en pantallas pequeñas
'shortcut' => 'alt+shift+r', // abre el menú; null lo desactiva
],github (el predeterminado): el último elemento del breadcrumb sigue siendo texto y una flecha a su lado abre un panel con un título, un campo de búsqueda y una marca en la página actual, como el selector de repositorios de GitHub. El campo recibe el foco al abrirse el menú y Enter abre el primer resultado.
simple: el propio último elemento del breadcrumb abre la lista. Para el menú de la 1.2 y anteriores, usa 'preset' => 'simple' y 'searchable' => false.

Badges
El menú muestra los badges de los relation managers, como en sus pestañas. Por defecto se cargan al abrir el menú: hasta entonces el menú está cerrado, así que la página se renderiza sin sus consultas, también en cada petición de Livewire que vuelve a dibujar el breadcrumb. Mientras tardan se ve un spinner.
'badges' => 'lazy', // predeterminado; true: con la página; false: sin badgesDesactívalos donde lo necesites:
// Una página, o un recurso (static): sin badges en este menú
public function hasRelationNavigatorBadges(): bool
{
return false;
}
// Un relation manager (con InteractsWithRelationPage): su badge se queda en
// la pestaña, no en el menú
protected static bool $hasRelationNavigatorBadge = false;Un relation manager cuyo badge de pestaña es lazy en Filament (protected static ?bool $isBadgeLazyLoaded = true;, o $isBadgeDeferred en Filament 4.13) también es lazy en el menú, incluso con 'badges' => true.
Las vistas del menú que no pueden cargar los badges después (vistas del paquete publicadas antes de la 1.3, o presets propios que muestran $item->badge por su cuenta) los reciben con la página, como antes: no desaparece nada.
Teclado: desde el campo de búsqueda, la flecha abajo entra en la lista; las flechas arriba y abajo se mueven entre las páginas, Enter abre una, Esc cierra el menú.
Atajo y tooltip

El botón que abre el menú tiene un tooltip con el atajo, mostrado con las teclas de Mac o de Windows/Linux. El atajo abre el menú desde cualquier parte de la página, con el campo de búsqueda listo, como el selector de repositorios de GitHub: ⌥ ⇧ R en un Mac, Alt Shift R en los demás. Cámbialo en la config o por página:
'shortcut' => 'mod+shift+p', // mod es ⌘ en un Mac y Ctrl en los demáspublic function getRelationNavigatorShortcut(): ?string
{
return null; // sin atajo en esta página
}Está pensado para no estorbar:
- reconoce la tecla física, así que funciona con cualquier distribución de teclado y con Option en un Mac (donde ⌥⇧R escribe ‰);
- no hace nada mientras escribes en un campo;
- nunca toma un atajo de la búsqueda global del panel (
globalSearchKeyBindings()): en ese caso el menú se queda sin atajo; - solo se abre el menú visible (breadcrumb o pantallas pequeñas).
Teclas admitidas: alt, shift, ctrl, meta, mod más una letra, un dígito o / . , ;.

Página, recurso o config
Cada opción tiene tres niveles. Gana la página, después el recurso, después la config:
| Método de la página (static en el recurso) | Clave de 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 |
// En una página
public function isRelationNavigatorSearchable(): bool
{
return false;
}// En un recurso: el mismo método, static, para todas sus páginas
public static function hasRelationNavigatorRecordNavigation(): bool
{
return true;
}Pantallas pequeñas
Filament oculta el breadcrumb por debajo de 40rem. Ahí el menú aparece encima del título de la página, en cada página que usa HasRelationNavigator, con las mismas opciones del preset. Desactívalo con 'mobile' => false, o por página:
public function hasRelationNavigatorMobileMenu(): bool
{
return false;
}
Traducciones
32 idiomas, con los mismos códigos que Filament: alemán, árabe, búlgaro, catalán, checo, chino (simplificado y tradicional), coreano, danés, eslovaco, español, finlandés, francés, griego, hebreo, húngaro, indonesio, inglés, italiano, japonés, neerlandés, noruego, persa, polaco, portugués (Portugal y Brasil), rumano, ruso, sueco, turco, ucraniano y vietnamita. En los idiomas de derecha a izquierda, las flechas de anterior y siguiente se invierten. Publica las traducciones para cambiarlas o añadir un idioma:
php artisan vendor:publish --tag=filament-relation-navigator-translationsUn preset propio
Parte de uno de los presets del paquete:
php artisan make:filament-relation-navigator-preset compact --from=githubEl comando copia el preset en resources/views/filament/relation-navigator/compact.blade.php. Regístralo y cámbialo como quieras:
'preset' => 'compact',
'presets' => [
// ...
'compact' => 'filament.relation-navigator.compact',
],Cualquier nombre de vista también sirve como preset. Para cambiar los propios presets del paquete, publica sus vistas:
php artisan vendor:publish --tag=filament-relation-navigator-viewsUna vista de preset recibe:
| Variable | Contenido |
|---|---|
$label | El último elemento del breadcrumb |
$items | Los elementos del menú: key, label, url, icon, badge, badgeColor, isActive |
$heading | "Switch page", traducido |
$isSearchable | Si se muestra el campo de búsqueda |
$hasSeparator | Si se separan las páginas del registro y las de relación en dos bloques |
$shortcut | El atajo, o null |
$shortcutKeys | Las teclas del atajo que se muestran: ['mac' => [...], 'other' => [...]] |
$searchPlaceholder | "Find a page…", traducido |
$emptyLabel | "No pages found.", traducido |
$maxHeight | menu.max_height |
Para darle a tu botón el tooltip y el atajo, incluye filament-relation-navigator::menu.partials.trigger-attributes dentro de su etiqueta. Cada elemento tiene también isRelationPage(). Para reutilizar el campo de búsqueda, la lista (con el separador y la navegación con teclado) y la línea de «sin resultados», incluye filament-relation-navigator::menu.partials.list con showCheck.