Skip to content

Preset e opzioni del menu ​

Pubblica la config:

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

Il preset simple sulla pagina di visualizzazione

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.

php
'badges' => 'lazy', // predefinito; true: con la pagina; false: niente badge

Spegnili dove serve:

php
// 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 tooltip del pulsante del menu con la sua scorciatoia

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:

php
'shortcut' => 'mod+shift+p', // mod è ⌘ su Mac e Ctrl altrove
php
public 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 / . , ;.

Il preset github con il campo di ricerca

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(): 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
// Su una pagina
public function isRelationNavigatorSearchable(): bool
{
    return false;
}
php
// 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:

php
public function hasRelationNavigatorMobileMenu(): bool
{
    return false;
}
Il menu su un telefono, sopra il titolo della pagina

Traduzioni ​

32 lingue, con gli stessi codici di Filament: arabo, bulgaro, catalano, cinese (semplificato e tradizionale), ceco, coreano, danese, ebraico, finlandese, francese, giapponese, greco, indonesiano, inglese, italiano, norvegese, olandese, persiano, polacco, portoghese (Portogallo e Brasile), rumeno, russo, slovacco, spagnolo, svedese, tedesco, turco, ucraino, ungherese e vietnamita. Nelle lingue da destra a sinistra le frecce precedente e successivo si girano. Pubblica le traduzioni per cambiarle o aggiungere una lingua:

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

Un preset tutto tuo ​

Parti da uno dei preset del package:

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

Il comando copia il preset in resources/views/filament/relation-navigator/compact.blade.php. Registralo e modificalo come vuoi:

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

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

Una vista di preset riceve:

VariabileContenuto
$labelL'ultima voce della breadcrumb
$itemsLe voci del menu: key, label, url, icon, badge, badgeColor, isActive
$heading"Switch page", tradotto
$isSearchableSe mostrare il campo di ricerca
$hasSeparatorSe dividere pagine del record e pagine delle relazioni in due blocchi
$shortcutLa scorciatoia, o null
$shortcutKeysI tasti da mostrare: ['mac' => [...], 'other' => [...]]
$searchPlaceholder"Find a page…", tradotto
$emptyLabel"No pages found.", tradotto
$maxHeightmenu.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.

Versione 1.8.1 del 15/11/2026 · Licenza MIT.