Presets et options du menu
Publiez la config :
php artisan vendor:publish --tag=filament-relation-navigator-config'menu' => [
'preset' => 'github', // 'simple', un preset à vous ou un nom de vue
'presets' => [
'simple' => 'filament-relation-navigator::menu.simple',
'github' => 'filament-relation-navigator::menu.github',
],
'searchable' => true, // un champ de recherche au-dessus de la liste, quel que soit le preset
'search_from' => 0, // ...à partir de ce nombre d'éléments
'badges' => 'lazy', // les badges des relation managers : 'lazy' à l'ouverture du menu, true avec la page, false désactivés
'max_height' => '24rem',
'separator' => true, // pages de l'enregistrement et pages de relation en deux blocs
'mobile' => true, // le menu au-dessus du titre sur les petits écrans
'shortcut' => 'alt+shift+r', // ouvre le menu ; null le désactive
],github (par défaut) : le dernier élément du fil d'Ariane reste du texte et une petite flèche à côté ouvre un panneau avec un titre, un champ de recherche et une coche sur la page courante, comme le sélecteur de dépôts de GitHub. Le champ prend le focus à l'ouverture du menu et Entrée ouvre le premier résultat.
simple : c'est le dernier élément du fil d'Ariane lui-même qui ouvre la liste. Pour le menu de la 1.2 et des versions précédentes, réglez 'preset' => 'simple' et 'searchable' => false.

Badges
Le menu affiche les badges des relation managers, comme dans leurs onglets. Par défaut, ils sont chargés à l'ouverture du menu : jusque-là le menu est fermé, donc la page s'affiche sans leurs requêtes, y compris à chaque requête Livewire qui redessine le fil d'Ariane. Un indicateur de chargement s'affiche le temps qu'ils arrivent.
'badges' => 'lazy', // par défaut ; true : avec la page ; false : aucun badgeDésactivez-les là où il le faut :
// Une page, ou une ressource (statique) : aucun badge dans ce menu
public function hasRelationNavigatorBadges(): bool
{
return false;
}
// Un relation manager (avec InteractsWithRelationPage) : son badge reste
// dans l'onglet, pas dans le menu
protected static bool $hasRelationNavigatorBadge = false;Un relation manager dont le badge d'onglet est lazy dans Filament (protected static ?bool $isBadgeLazyLoaded = true;, ou $isBadgeDeferred sur Filament 4.13) est lazy aussi dans le menu, même avec 'badges' => true.
Les vues du menu qui ne savent pas charger les badges plus tard (vues du package publiées avant la 1.3, ou presets à vous qui affichent $item->badge eux-mêmes) les reçoivent avec la page, comme avant : rien ne disparaît.
Clavier : depuis le champ de recherche, Bas entre dans la liste ; Haut et Bas passent d'une page à l'autre, Entrée en ouvre une, Échap ferme le menu.
Raccourci et infobulle

Le bouton qui ouvre le menu a une infobulle avec le raccourci, affiché avec les touches du Mac ou de Windows/Linux. Le raccourci ouvre le menu depuis n'importe où sur la page, avec le champ de recherche prêt, comme le sélecteur de dépôts de GitHub : ⌥ ⇧ R sur Mac, Alt Shift R ailleurs. Changez-le dans la config ou par page :
'shortcut' => 'mod+shift+p', // mod vaut ⌘ sur Mac et Ctrl ailleurspublic function getRelationNavigatorShortcut(): ?string
{
return null; // aucun raccourci sur cette page
}Il est conçu pour ne pas gêner :
- il reconnaît la touche physique, donc il fonctionne avec n'importe quelle disposition de clavier et avec Option sur Mac (où ⌥⇧R tape ‰) ;
- il ne fait rien pendant que vous tapez dans un champ ;
- un raccourci de la recherche globale du panel (
globalSearchKeyBindings()) n'est jamais pris : le menu n'a alors pas de raccourci ; - seul le menu visible s'ouvre (fil d'Ariane ou petits écrans).
Touches prises en charge : alt, shift, ctrl, meta, mod plus une lettre, un chiffre ou / . , ;.

Page, ressource ou config
Chaque option a trois niveaux. La page l'emporte, puis la ressource, puis la config :
| Méthode de la page (statique sur la ressource) | Clé de 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 |
// Sur une page
public function isRelationNavigatorSearchable(): bool
{
return false;
}// Sur une ressource : la même méthode, statique, pour toutes ses pages
public static function hasRelationNavigatorRecordNavigation(): bool
{
return true;
}Petits écrans
Filament masque le fil d'Ariane en dessous de 40rem. Le menu s'affiche alors au-dessus du titre de la page, sur chaque page qui utilise HasRelationNavigator, avec les mêmes options de preset. Désactivez-le avec 'mobile' => false, ou par page :
public function hasRelationNavigatorMobileMenu(): bool
{
return false;
}
Traductions
32 langues, avec les mêmes codes que Filament : allemand, anglais, arabe, bulgare, catalan, chinois (simplifié et traditionnel), coréen, danois, espagnol, finnois, français, grec, hébreu, hongrois, indonésien, italien, japonais, néerlandais, norvégien, persan, polonais, portugais (Portugal et Brésil), roumain, russe, slovaque, suédois, tchèque, turc, ukrainien et vietnamien. Dans les langues de droite à gauche, les flèches précédent et suivant s'inversent. Publiez les traductions pour les modifier ou ajouter une langue :
php artisan vendor:publish --tag=filament-relation-navigator-translationsVotre propre preset
Partez de l'un des presets du package :
php artisan make:filament-relation-navigator-preset compact --from=githubLa commande copie le preset dans resources/views/filament/relation-navigator/compact.blade.php. Enregistrez-le et modifiez-le à votre guise :
'preset' => 'compact',
'presets' => [
// ...
'compact' => 'filament.relation-navigator.compact',
],N'importe quel nom de vue fonctionne aussi comme preset. Pour modifier les presets du package eux-mêmes, publiez leurs vues :
php artisan vendor:publish --tag=filament-relation-navigator-viewsUne vue de preset reçoit :
| Variable | Contenu |
|---|---|
$label | Le dernier élément du fil d'Ariane |
$items | Les éléments du menu : key, label, url, icon, badge, badgeColor, isActive |
$heading | "Switch page", traduit |
$isSearchable | S'il faut afficher le champ de recherche |
$hasSeparator | S'il faut séparer pages de l'enregistrement et pages de relation en deux blocs |
$shortcut | Le raccourci, ou null |
$shortcutKeys | Les touches à afficher : ['mac' => [...], 'other' => [...]] |
$searchPlaceholder | "Find a page…", traduit |
$emptyLabel | "No pages found.", traduit |
$maxHeight | menu.max_height |
Pour donner à votre bouton l'infobulle et le raccourci, incluez filament-relation-navigator::menu.partials.trigger-attributes dans sa balise. Chaque élément a aussi isRelationPage(). Pour réutiliser le champ de recherche, la liste (avec le séparateur et la navigation au clavier) et la ligne « aucun résultat », incluez filament-relation-navigator::menu.partials.list avec showCheck.