Menü-Presets und Optionen
Veröffentliche die Config:
php artisan vendor:publish --tag=filament-relation-navigator-config'menu' => [
'preset' => 'github', // 'simple', ein eigenes Preset oder ein View-Name
'presets' => [
'simple' => 'filament-relation-navigator::menu.simple',
'github' => 'filament-relation-navigator::menu.github',
],
'searchable' => true, // ein Suchfeld über der Liste, bei jedem Preset
'search_from' => 0, // ...ab dieser Anzahl Einträge
'badges' => 'lazy', // die Badges der Relation Manager: 'lazy' beim Öffnen des Menüs, true mit der Seite, false aus
'max_height' => '24rem',
'separator' => true, // Datensatzseiten und Relationsseiten in zwei Blöcken
'mobile' => true, // das Menü über der Überschrift auf kleinen Bildschirmen
'shortcut' => 'alt+shift+r', // öffnet das Menü; null schaltet es ab
],github (Standard): die letzte Breadcrumb bleibt Text, und ein Pfeil daneben öffnet ein Panel mit Überschrift, Suchfeld und einem Häkchen bei der aktuellen Seite, wie der Repository-Umschalter von GitHub. Das Feld bekommt beim Öffnen den Fokus, und Enter öffnet den ersten Treffer.
simple: die letzte Breadcrumb selbst öffnet die Liste. Für das Menü von 1.2 und früher setze 'preset' => 'simple' und 'searchable' => false.

Badges
Das Menü zeigt die Badges der Relation Manager, wie in ihren Tabs. Standardmäßig werden sie beim Öffnen des Menüs geladen: bis dahin ist das Menü geschlossen, also wird die Seite ohne ihre Queries gerendert, auch bei jedem Livewire-Request, der die Breadcrumbs neu zeichnet. Für den Moment, den sie brauchen, erscheint ein Spinner.
'badges' => 'lazy', // Standard; true: mit der Seite; false: keine BadgesSchalte sie ab, wo nötig:
// Eine Seite oder eine Resource (statisch): keine Badges in diesem Menü
public function hasRelationNavigatorBadges(): bool
{
return false;
}
// Ein Relation Manager (mit InteractsWithRelationPage): sein Badge bleibt
// im Tab, nicht im Menü
protected static bool $hasRelationNavigatorBadge = false;Ein Relation Manager, dessen Tab-Badge in Filament lazy ist (protected static ?bool $isBadgeLazyLoaded = true;, oder $isBadgeDeferred in Filament 4.13), ist auch im Menü lazy, selbst mit 'badges' => true.
Menü-Views, die Badges nicht nachladen können (vor 1.3 veröffentlichte Views des Packages oder eigene Presets, die $item->badge selbst rendern), bekommen sie wie bisher mit der Seite: nichts verschwindet.
Tastatur: vom Suchfeld aus springt Pfeil nach unten in die Liste; Pfeil nach oben und unten wechseln zwischen den Seiten, Enter öffnet eine, Escape schließt das Menü.
Tastenkürzel und Tooltip

Der Button, der das Menü öffnet, hat einen Tooltip mit dem Tastenkürzel, angezeigt mit Mac- oder Windows/Linux-Tasten. Das Kürzel öffnet das Menü von überall auf der Seite, mit bereitem Suchfeld, wie der Repository-Umschalter von GitHub: ⌥ ⇧ R auf dem Mac, Alt Shift R anderswo. Ändere es in der Config oder pro Seite:
'shortcut' => 'mod+shift+p', // mod ist ⌘ auf dem Mac und sonst Ctrlpublic function getRelationNavigatorShortcut(): ?string
{
return null; // kein Tastenkürzel auf dieser Seite
}Es ist so gebaut, dass es nicht stört:
- es erkennt die physische Taste, funktioniert also mit jedem Tastaturlayout und mit Option auf dem Mac (wo ⌥⇧R ‰ tippt);
- es tut nichts, während du in einem Feld tippst;
- ein Tastenkürzel der globalen Suche des Panels (
globalSearchKeyBindings()) wird nie übernommen: das Menü hat dann kein Kürzel; - nur das sichtbare Menü öffnet sich (Breadcrumbs oder kleine Bildschirme).
Unterstützte Tasten: alt, shift, ctrl, meta, mod plus ein Buchstabe, eine Ziffer oder / . , ;.

Seite, Resource oder Config
Jede Option hat drei Ebenen. Die Seite gewinnt, dann die Resource, dann die Config:
| Methode der Seite (statisch auf der Resource) | Config-Schlüssel |
|---|---|
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 |
// Auf einer Seite
public function isRelationNavigatorSearchable(): bool
{
return false;
}// Auf einer Resource: dieselbe Methode, statisch, für alle ihre Seiten
public static function hasRelationNavigatorRecordNavigation(): bool
{
return true;
}Kleine Bildschirme
Filament blendet die Breadcrumbs unter 40rem aus. Dort erscheint das Menü stattdessen über der Seitenüberschrift, auf jeder Seite mit HasRelationNavigator, mit denselben Preset-Optionen. Schalte es mit 'mobile' => false ab, oder pro Seite:
public function hasRelationNavigatorMobileMenu(): bool
{
return false;
}
Übersetzungen
32 Sprachen, mit denselben Codes wie Filament: Arabisch, Bulgarisch, Chinesisch (vereinfacht und traditionell), Dänisch, Deutsch, Englisch, Finnisch, Französisch, Griechisch, Hebräisch, Indonesisch, Italienisch, Japanisch, Katalanisch, Koreanisch, Niederländisch, Norwegisch, Persisch, Polnisch, Portugiesisch (Portugal und Brasilien), Rumänisch, Russisch, Schwedisch, Slowakisch, Spanisch, Tschechisch, Türkisch, Ukrainisch, Ungarisch und Vietnamesisch. In Sprachen, die von rechts nach links laufen, drehen sich die Pfeile für vorherigen und nächsten Datensatz um. Veröffentliche die Übersetzungen, um sie zu ändern oder eine Sprache hinzuzufügen:
php artisan vendor:publish --tag=filament-relation-navigator-translationsEin eigenes Preset
Starte mit einem der Presets des Packages:
php artisan make:filament-relation-navigator-preset compact --from=githubDer Befehl kopiert das Preset nach resources/views/filament/relation-navigator/compact.blade.php. Registriere es und passe es nach Belieben an:
'preset' => 'compact',
'presets' => [
// ...
'compact' => 'filament.relation-navigator.compact',
],Jeder View-Name funktioniert auch als preset. Um die Presets des Packages selbst zu ändern, veröffentliche ihre Views:
php artisan vendor:publish --tag=filament-relation-navigator-viewsEine Preset-View bekommt:
| Variable | Inhalt |
|---|---|
$label | Die letzte Breadcrumb |
$items | Die Menüeinträge: key, label, url, icon, badge, badgeColor, isActive |
$heading | "Switch page", übersetzt |
$isSearchable | Ob das Suchfeld angezeigt wird |
$hasSeparator | Ob Datensatzseiten und Relationsseiten in zwei Blöcke geteilt werden |
$shortcut | Das Tastenkürzel oder null |
$shortcutKeys | Die anzuzeigenden Tasten: ['mac' => [...], 'other' => [...]] |
$searchPlaceholder | "Find a page…", übersetzt |
$emptyLabel | "No pages found.", übersetzt |
$maxHeight | menu.max_height |
Um deinem Button Tooltip und Tastenkürzel zu geben, binde filament-relation-navigator::menu.partials.trigger-attributes in seinem Tag ein. Jeder Eintrag hat außerdem isRelationPage(). Um das Suchfeld, die Liste (mit Trenner und Tastaturnavigation) und die Zeile „keine Ergebnisse“ wiederzuverwenden, binde filament-relation-navigator::menu.partials.list mit showCheck ein.