Preset e opzioni del menu
Pubblica la config:
php artisan vendor:publish --tag=filament-relation-navigator-config'menu' => [
'preset' => 'github', // 'simple', un tuo preset o il nome di una vista
'presets' => [
'simple' => 'filament-relation-navigator::menu.simple',
'github' => 'filament-relation-navigator::menu.github',
],
'searchable' => true, // un campo di ricerca sopra la lista, con qualsiasi preset
'search_from' => 0, // ...da questo numero di voci
'badges' => 'lazy', // i badge dei relation manager: 'lazy' all'apertura del menu, true con la pagina, false spenti
'max_height' => '24rem',
'separator' => true, // pagine del record e pagine delle relazioni in due blocchi
'mobile' => true, // il menu sopra il titolo sugli schermi piccoli
'shortcut' => 'alt+shift+r', // apre il menu; null lo spegne
],github (il predefinito): l'ultima voce della breadcrumb resta testo e una freccina accanto apre un pannello con un titolo, un campo di ricerca e una spunta sulla pagina corrente, come il selettore di repository di GitHub. Il campo prende il focus all'apertura e Invio apre il primo risultato.
simple: è l'ultima voce della breadcrumb ad aprire la lista. Per il menu della 1.2 e precedenti, imposta 'preset' => 'simple' e 'searchable' => false.

Badge
Il menu mostra i badge dei relation manager, come nelle schede. Di default arrivano quando apri il menu: fino ad allora è chiuso, quindi la pagina viene disegnata senza le loro query, anche a ogni richiesta Livewire che ridisegna la breadcrumb. Per l'attimo che servono si vede uno spinner.
'badges' => 'lazy', // predefinito; true: con la pagina; false: niente badgeSpegnili dove serve:
// Una pagina, o una resource (statico): niente badge in questo menu
public function hasRelationNavigatorBadges(): bool
{
return false;
}
// Un relation manager (con InteractsWithRelationPage): il suo badge resta
// nella scheda, non nel menu
protected static bool $hasRelationNavigatorBadge = false;Un relation manager con il badge della scheda lazy in Filament (protected static ?bool $isBadgeLazyLoaded = true;, o $isBadgeDeferred su Filament 4.13) è lazy anche nel menu, anche con 'badges' => true.
Le viste del menu che non sanno caricare i badge dopo (viste del package pubblicate prima della 1.3, o preset tuoi che mostrano $item->badge da soli) li ricevono con la pagina, come prima: non sparisce niente.
Tastiera: dal campo di ricerca, Giù entra nella lista; Su e Giù si spostano tra le pagine, Invio ne apre una, Esc chiude il menu.
Scorciatoia e tooltip

Il pulsante che apre il menu ha un tooltip con la scorciatoia, mostrata con i tasti del Mac o di Windows/Linux. La scorciatoia apre il menu da qualsiasi punto della pagina, con il campo di ricerca pronto, come il selettore di repository di GitHub: ⌥ ⇧ R su Mac, Alt Shift R altrove. Cambiala nella config o per pagina:
'shortcut' => 'mod+shift+p', // mod è ⌘ su Mac e Ctrl altrovepublic function getRelationNavigatorShortcut(): ?string
{
return null; // nessuna scorciatoia su questa pagina
}È fatta per non dare fastidio:
- riconosce il tasto fisico, quindi funziona con qualsiasi layout di tastiera e con Option su Mac (dove ⌥⇧R scrive ‰);
- non fa niente mentre scrivi in un campo;
- non prende mai una scorciatoia della ricerca globale del panel (
globalSearchKeyBindings()): in quel caso il menu resta senza; - si apre solo il menu visibile (breadcrumb o schermi piccoli).
Tasti supportati: alt, shift, ctrl, meta, mod più una lettera, una cifra o / . , ;.

Pagina, resource o config
Ogni opzione ha tre livelli. Vince la pagina, poi la resource, poi la config:
| Metodo della pagina (statico sulla resource) | Chiave di 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 |
// Su una pagina
public function isRelationNavigatorSearchable(): bool
{
return false;
}// Su una resource: lo stesso metodo, statico, per tutte le sue pagine
public static function hasRelationNavigatorRecordNavigation(): bool
{
return true;
}Schermi piccoli
Filament nasconde le breadcrumb sotto i 40rem. Lì il menu compare sopra il titolo della pagina, su ogni pagina che usa HasRelationNavigator, con le stesse opzioni del preset. Spegnilo con 'mobile' => false, o per pagina:
public function hasRelationNavigatorMobileMenu(): bool
{
return false;
}
Traduzioni
Inglese, italiano, spagnolo, tedesco, francese, portoghese brasiliano e olandese. Pubblica le traduzioni per cambiarle o aggiungere una lingua:
php artisan vendor:publish --tag=filament-relation-navigator-translationsUn preset tutto tuo
Parti da uno dei preset del package:
php artisan make:filament-relation-navigator-preset compact --from=githubIl comando copia il preset in resources/views/filament/relation-navigator/compact.blade.php. Registralo e modificalo come vuoi:
'preset' => 'compact',
'presets' => [
// ...
'compact' => 'filament.relation-navigator.compact',
],Anche il nome di qualsiasi vista funziona come preset. Per modificare i preset del package, pubblica le loro viste:
php artisan vendor:publish --tag=filament-relation-navigator-viewsUna vista di preset riceve:
| Variabile | Contenuto |
|---|---|
$label | L'ultima voce della breadcrumb |
$items | Le voci del menu: key, label, url, icon, badge, badgeColor, isActive |
$heading | "Switch page", tradotto |
$isSearchable | Se mostrare il campo di ricerca |
$hasSeparator | Se dividere pagine del record e pagine delle relazioni in due blocchi |
$shortcut | La scorciatoia, o null |
$shortcutKeys | I tasti da mostrare: ['mac' => [...], 'other' => [...]] |
$searchPlaceholder | "Find a page…", tradotto |
$emptyLabel | "No pages found.", tradotto |
$maxHeight | menu.max_height |
Per dare al tuo pulsante tooltip e scorciatoia, includi filament-relation-navigator::menu.partials.trigger-attributes dentro il suo tag. Ogni voce ha anche isRelationPage(). Per riusare il campo di ricerca, la lista (con separatore e navigazione da tastiera) e la riga «nessun risultato», includi filament-relation-navigator::menu.partials.list con showCheck.