Skip to content

Riferimento API ​

Tutto quello che c'è qui è API pubblica, coperta dal versionamento semantico: nella 1.x non cambia in modo incompatibile. Quello che non è elencato è interno.

Trait ​

TraitDove si usaCosa fa
Concerns\HasRelationPagesuna resourceOgni relation manager ha la sua pagina
Concerns\InteractsWithRelationPageun relation managerQuesto relation manager ha una pagina; legge le proprietà statiche facoltative qui sotto
Concerns\HasRelationNavigatoruna pagina del record (visualizzazione, modifica, personalizzata)Il menu nella breadcrumb, e la pagina compare nel menu

Tutti nel namespace Wit3\FilamentRelationNavigator.

Su una resource ​

Tutti statici, tutti facoltativi.

MetodoA cosa serve
hasRelationPage(string $slug): boolEscludere una relazione
canAccessRelationPage(Model $record, string $slug): boolVietare una pagina di relazione per un record (pagine, menu, ricerca globale, redirect)
relationPageHeader(Schema $schema): SchemaTestata sopra la relazione in tutte le pagine di relazione
getRelationPageHeaderActions(): arrayAzioni di testata delle pagine di relazione
getRelationPageHeaderWidgets(): array, getRelationPageFooterWidgets(): arrayWidget delle pagine di relazione (ricevono $record)
hasRelationPageLinks(): bool«Apri come pagina» sui suoi relation manager
configureRelationPageAction(Action $action, RelationManager $manager): ActionModificare quell'azione per questa resource
hasRelationPageGlobalSearchActions(): boolLink della ricerca globale per questa resource
qualsiasi metodo di opzione, staticoL'opzione per tutte le pagine della resource

Su un relation manager ​

Tutti statici, tutti facoltativi. Le proprietà richiedono InteractsWithRelationPage; i metodi funzionano anche senza.

Proprietà o metodoA cosa serve
$hasRelationPage, hasRelationPage(): boolUna pagina per questo relation manager o no
$relationPageSlug, getRelationPageSlug(): ?stringLo slug della sua pagina
$hasRelationPageLink, hasRelationPageLink(): bool«Apri come pagina» sulla sua tabella
$hasRelationPageGlobalSearchAction, hasRelationPageGlobalSearchAction(): boolIl suo link sotto i risultati della ricerca globale
$hasRelationNavigatorBadge, hasRelationNavigatorBadge(): boolIl suo badge nel menu (la scheda tiene il suo)
getRelationPageTitle(Model $ownerRecord)Titolo della sua pagina; null tiene il predefinito
getRelationPageSubheading(Model $ownerRecord)Sottotitolo della sua pagina
getRelationPageBreadcrumb(Model $ownerRecord): ?stringUltima voce della breadcrumb della sua pagina
relationPageHeader(), getRelationPageHeaderActions(), getRelationPageHeaderWidgets(), getRelationPageFooterWidgets()Come sulla resource, solo per la sua pagina
configureRelationPageAction(Action $action, RelationManager $manager): ActionModificare la sua azione «Apri come pagina»

Anche isBadgeLazyLoaded() di Filament (o $isBadgeLazyLoaded) rende lazy il suo badge nel menu.

Su una pagina del record (HasRelationNavigator) ​

Sovrascrivili sulla pagina:

MetodoA cosa serve
i metodi di opzioneLe opzioni di questa pagina
getRelationNavigatorRecordNavigationQuery(): ?BuilderI record che precedente e successivo scorrono
withRelationNavigator(array $breadcrumbs): arrayAggiungere il menu a breadcrumb costruite da te

Una classe pagina di relazione tutta tua ​

Estendi Pages\RelationPage (o lancia php artisan make:filament-relation-navigator CustomerResource) e aggiungi ...CustomerRelationPage::relationRoutes() a getPages().

MembroA cosa serve
protected static ?array $relationsSolo questi slug
protected static array $excludedRelationsMai questi slug
protected static ?string $contextPageChiave della pagina che rappresenta (predefinito: la pagina di visualizzazione, se no quella di modifica)
$title, $subheading, $breadcrumb e tutti i metodi delle pagine di FilamentCome in qualsiasi pagina di Filament

Funzioni di supporto ​

Metodi statici di RelationNavigator:

MetodoA cosa serve
getItems(string $resource, Model $record, ...)Le voci del menu di un record
getRecordSubNavigation(Page $page): arrayLe stesse voci come sotto-navigazione di Filament
getRelationManagerPageUrl(RelationManager $manager): ?stringLa pagina di un relation manager, per pulsanti tuoi
getGlobalSearchResultActions(string $resource, Model $record): arrayI link della ricerca globale, da unire ai tuoi
configureRelationPageActionUsing(Closure $callback): voidModificare tutte le azioni «Apri come pagina»
makeRelationPageAction(RelationManager $manager): ActionCostruire quell'azione
getRelationPageClass(string $resource): ?stringLa classe pagina di relazione di una resource
RELATION_PAGE_ACTIONNome dell'azione «Apri come pagina»

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

Rotte, viste e comandi ​

  • Nomi delle rotte: {base delle rotte della resource}.relations.{slug}, per getUrl('relations.orders', [...]).
  • Viste: filament-relation-navigator::menu.github, menu.simple, menu.mobile, menu.partials.list, menu.partials.trigger-attributes. Le loro variabili sono in Un preset tutto tuo.
  • Comandi: make:filament-relation-navigator {resource}, make:filament-relation-navigator-preset {nome} --from=github|simple.
  • Traduzioni: filament-relation-navigator::navigator.*.

Versione 1.7.0 del 14/11/2026 · Licenza MIT.