Skip to content
Esta página es una traducción: si algo no coincide, la referencia es la documentación en inglés. Leerla en inglés

Presets y opciones del menú ​

Publica la config:

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

El preset simple en la página de vista

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.

php
'badges' => 'lazy', // predeterminado; true: con la página; false: sin badges

Desactívalos donde lo necesites:

php
// 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 tooltip del botón del menú con su atajo de teclado

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:

php
'shortcut' => 'mod+shift+p', // mod es ⌘ en un Mac y Ctrl en los demás
php
public 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 / . , ;.

El preset github con el campo de búsqueda

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

php
public function hasRelationNavigatorMobileMenu(): bool
{
    return false;
}
El menú en un teléfono, encima del título de la página

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:

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

Un preset propio ​

Parte de uno de los presets del paquete:

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

El comando copia el preset en resources/views/filament/relation-navigator/compact.blade.php. Regístralo y cámbialo como quieras:

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

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

Una vista de preset recibe:

VariableContenido
$labelEl último elemento del breadcrumb
$itemsLos elementos del menú: key, label, url, icon, badge, badgeColor, isActive
$heading"Switch page", traducido
$isSearchableSi se muestra el campo de búsqueda
$hasSeparatorSi se separan las páginas del registro y las de relación en dos bloques
$shortcutEl atajo, o null
$shortcutKeysLas teclas del atajo que se muestran: ['mac' => [...], 'other' => [...]]
$searchPlaceholder"Find a page…", traducido
$emptyLabel"No pages found.", traducido
$maxHeightmenu.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.

Versión 1.8.1, publicada el 2026-11-15 · Licencia MIT.