Skip to content
Cette page est une traduction : en cas de différence, la documentation en anglais fait foi. La lire en anglais

Presets et options du menu ​

Publiez la config :

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

Le preset simple sur la page d’affichage

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.

php
'badges' => 'lazy', // par défaut ; true : avec la page ; false : aucun badge

Désactivez-les là où il le faut :

php
// 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 ​

L’infobulle du bouton du menu avec son raccourci

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 :

php
'shortcut' => 'mod+shift+p', // mod vaut ⌘ sur Mac et Ctrl ailleurs
php
public 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 / . , ;.

Le preset github avec le champ de recherche

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(): 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
// Sur une page
public function isRelationNavigatorSearchable(): bool
{
    return false;
}
php
// 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 :

php
public function hasRelationNavigatorMobileMenu(): bool
{
    return false;
}
Le menu sur un téléphone, au-dessus du titre de la page

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 :

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

Votre propre preset ​

Partez de l'un des presets du package :

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

La commande copie le preset dans resources/views/filament/relation-navigator/compact.blade.php. Enregistrez-le et modifiez-le à votre guise :

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

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

Une vue de preset reçoit :

VariableContenu
$labelLe dernier élément du fil d'Ariane
$itemsLes éléments du menu : key, label, url, icon, badge, badgeColor, isActive
$heading"Switch page", traduit
$isSearchableS'il faut afficher le champ de recherche
$hasSeparatorS'il faut séparer pages de l'enregistrement et pages de relation en deux blocs
$shortcutLe raccourci, ou null
$shortcutKeysLes touches à afficher : ['mac' => [...], 'other' => [...]]
$searchPlaceholder"Find a page…", traduit
$emptyLabel"No pages found.", traduit
$maxHeightmenu.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.

Version 1.8.1, publiée le 2026-11-15 · Licence MIT.