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

Referencia de la API ​

Todo lo que aparece aquí es API pública, cubierta por el versionado semántico: no cambia de forma incompatible dentro de la 1.x. Lo que no está en esta lista es interno.

Traits ​

TraitDónde se usaQué hace
Concerns\HasRelationPagesun recursoCada relation manager tiene su propia página
Concerns\InteractsWithRelationPageun relation managerEste relation manager tiene una página; lee las propiedades static opcionales de abajo
Concerns\HasRelationNavigatoruna página del registro (vista, edición, personalizada)El menú del breadcrumb, y la página aparece en él

Todos en el namespace Wit3\FilamentRelationNavigator.

En un recurso ​

Todos static, todos opcionales.

MétodoPara qué sirve
hasRelationPage(string $slug): boolDejar fuera una relación
canAccessRelationPage(Model $record, string $slug): boolVetar una página de relación para un registro (páginas, menú, búsqueda global, redirección)
relationPageHeader(Schema $schema): SchemaCabecera encima de la relación en todas las páginas de relación
getRelationPageHeaderActions(): arrayAcciones de cabecera de las páginas de relación
getRelationPageHeaderWidgets(): array, getRelationPageFooterWidgets(): arrayWidgets de las páginas de relación (reciben $record)
hasRelationPageLinks(): bool«Abrir como página» en sus relation managers
configureRelationPageAction(Action $action, RelationManager $manager): ActionCambiar esa acción para este recurso
hasRelationPageGlobalSearchActions(): boolEnlaces de la búsqueda global para este recurso
cualquier método de opción, staticLa opción para todas las páginas del recurso

En un relation manager ​

Todos static, todos opcionales. Las propiedades necesitan InteractsWithRelationPage; los métodos funcionan sin él.

Propiedad o métodoPara qué sirve
$hasRelationPage, hasRelationPage(): boolUna página para este relation manager o no
$relationPageSlug, getRelationPageSlug(): ?stringEl slug de su página
$hasRelationPageLink, hasRelationPageLink(): bool«Abrir como página» en su tabla
$hasRelationPageGlobalSearchAction, hasRelationPageGlobalSearchAction(): boolSu enlace bajo los resultados de la búsqueda global
$hasRelationNavigatorBadge, hasRelationNavigatorBadge(): boolSu badge en el menú (la pestaña conserva el suyo)
getRelationPageTitle(Model $ownerRecord)Título de su página; null mantiene el predeterminado
getRelationPageSubheading(Model $ownerRecord)Subtítulo de su página
getRelationPageBreadcrumb(Model $ownerRecord): ?stringÚltimo elemento del breadcrumb de su página
relationPageHeader(), getRelationPageHeaderActions(), getRelationPageHeaderWidgets(), getRelationPageFooterWidgets()Como en el recurso, solo para su página
configureRelationPageAction(Action $action, RelationManager $manager): ActionCambiar su acción «Abrir como página»

El propio isBadgeLazyLoaded() de Filament (o $isBadgeLazyLoaded) también hace lazy su badge en el menú.

En una página del registro (HasRelationNavigator) ​

Sobrescribe cualquiera de ellos en la página:

MétodoPara qué sirve
los métodos de opciónLas opciones de esta página
getRelationNavigatorRecordNavigationQuery(): ?BuilderLos registros que recorren anterior y siguiente
withRelationNavigator(array $breadcrumbs): arrayAñadir el menú a un breadcrumb que construyes tú

Una clase de página de relación propia ​

Extiende Pages\RelationPage (o ejecuta php artisan make:filament-relation-navigator CustomerResource) y añade ...CustomerRelationPage::relationRoutes() a getPages().

MiembroPara qué sirve
protected static ?array $relationsSolo estos slugs
protected static array $excludedRelationsNunca estos slugs
protected static ?string $contextPageClave de la página que representa (por defecto: la página de vista, si no la de edición)
$title, $subheading, $breadcrumb y todos los métodos de las páginas de FilamentComo en cualquier página de Filament

Helpers ​

Métodos static de RelationNavigator:

MétodoPara qué sirve
getItems(string $resource, Model $record, ...)Los elementos del menú de un registro
getRecordSubNavigation(Page $page): arrayLos mismos elementos como subnavegación de Filament
getRelationManagerPageUrl(RelationManager $manager): ?stringLa página de un relation manager, para botones propios
getGlobalSearchResultActions(string $resource, Model $record): arrayLos enlaces de la búsqueda global, para combinarlos con los tuyos
configureRelationPageActionUsing(Closure $callback): voidCambiar todas las acciones «Abrir como página»
makeRelationPageAction(RelationManager $manager): ActionConstruir esa acción
getRelationPageClass(string $resource): ?stringLa clase de página de relación de un recurso
RELATION_PAGE_ACTIONNombre de la acción «Abrir como página»

RelationNavigatorItem (en $items): key, label, url, icon, badge, badgeColor, isActive, isBadgeDeferred, isRelationPage().

Rutas, vistas y comandos ​

  • Nombres de las rutas: {base de las rutas del recurso}.relations.{slug}, para getUrl('relations.orders', [...]).
  • Vistas: filament-relation-navigator::menu.github, menu.simple, menu.mobile, menu.partials.list, menu.partials.trigger-attributes. Sus variables están en Un preset propio.
  • Comandos: make:filament-relation-navigator {resource}, make:filament-relation-navigator-preset {nombre} --from=github|simple.
  • Traducciones: filament-relation-navigator::navigator.*.

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