メニューのプリセットとオプション
設定ファイルを公開します。
php artisan vendor:publish --tag=filament-relation-navigator-config'menu' => [
'preset' => 'github', // 'simple'、独自のプリセット、またはビュー名
'presets' => [
'simple' => 'filament-relation-navigator::menu.simple',
'github' => 'filament-relation-navigator::menu.github',
],
'searchable' => true, // プリセットに関係なく、リストの上に検索フィールドを表示
'search_from' => 0, // ...項目がこの数以上のとき
'badges' => 'lazy', // リレーションマネージャーのバッジ: 'lazy' はメニューを開いたとき、true はページと一緒、false は無効
'max_height' => '24rem',
'separator' => true, // レコードのページとリレーションページを 2 つのブロックに分ける
'mobile' => true, // 小さな画面では見出しの上にメニューを表示
'shortcut' => 'alt+shift+r', // メニューを開くショートカット。null で無効
],github(デフォルト):パンくずリストの最後の項目はテキストのままで、その横のキャレットからパネルが開きます。パネルには見出し、検索フィールド、現在のページのチェックマークがあり、GitHub のリポジトリ切り替えと同じような形です。メニューを開くと検索フィールドにフォーカスが移り、Enter で最初の一致を開きます。
simple:パンくずリストの最後の項目そのものがリストを開きます。1.2 以前のメニューにするには、'preset' => 'simple' と 'searchable' => false を設定します。

バッジ
メニューには、タブと同じようにリレーションマネージャーのバッジが表示されます。デフォルトではメニューを開いたときに読み込まれます。それまでメニューは閉じているので、ページはバッジのクエリなしでレンダリングされます。パンくずリストを再描画するすべての Livewire リクエストでも同様です。読み込みの間はスピナーが表示されます。
'badges' => 'lazy', // デフォルト。true: ページと一緒、false: バッジなし必要な場所で無効にできます。
// ページまたはリソース(static): このメニューにバッジを表示しない
public function hasRelationNavigatorBadges(): bool
{
return false;
}
// リレーションマネージャー(InteractsWithRelationPage を使用): バッジはタブに残り、
// メニューには表示しない
protected static bool $hasRelationNavigatorBadge = false;Filament でタブのバッジを遅延読み込みにしているリレーションマネージャー(protected static ?bool $isBadgeLazyLoaded = true;、Filament 4.13 では $isBadgeDeferred)は、'badges' => true の場合でもメニューで遅延読み込みになります。
後からバッジを読み込めないメニュービュー(1.3 より前に公開したパッケージのビューや、$item->badge を自分で描画する独自のプリセット)は、これまでどおりページと一緒にバッジを受け取ります。表示されなくなるものはありません。
キーボード:検索フィールドで下キーを押すとリストに移動します。上下キーでページ間を移動し、Enter で開き、Escape でメニューを閉じます。
ショートカットとツールチップ

メニューを開くボタンには、ショートカットを Mac または Windows/Linux のキーで示すツールチップがあります。ショートカットを押すと、GitHub のリポジトリ切り替えと同じように、ページのどこからでも検索フィールドがすぐ使える状態でメニューが開きます。Mac では ⌥ ⇧ R、それ以外では Alt Shift R です。設定またはページごとに変更できます。
'shortcut' => 'mod+shift+p', // mod は Mac では ⌘、それ以外では Ctrlpublic function getRelationNavigatorShortcut(): ?string
{
return null; // このページではショートカットなし
}邪魔にならないように作られています。
- 物理キーで判定するので、どのキーボードレイアウトでも、Mac の Option キー(⌥⇧R で ‰ が入力される)でも動作します。
- フィールドに入力している間は何もしません。
- パネルのグローバル検索のショートカット(
globalSearchKeyBindings())を横取りすることはありません。その場合、メニューにはショートカットが付きません。 - 開くのは表示されているメニューだけです(パンくずリストまたは小さな画面)。
使えるキー:alt、shift、ctrl、meta、mod に、英字、数字、または / . , ; を組み合わせます。

ページ、リソース、設定
各オプションには 3 つのレベルがあります。ページが最優先で、次にリソース、最後に設定です。
| ページのメソッド(リソースでは static) | 設定キー |
|---|---|
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 |
// 1 つのページで
public function isRelationNavigatorSearchable(): bool
{
return false;
}// リソースで: 同じメソッドを static にすると、そのすべてのページに適用
public static function hasRelationNavigatorRecordNavigation(): bool
{
return true;
}小さな画面
Filament は 40rem 未満の画面でパンくずリストを非表示にします。その場合、HasRelationNavigator を使うすべてのページで、メニューがページ見出しの上に、同じプリセットのオプションで表示されます。'mobile' => false で無効にするか、ページごとに設定します。
public function hasRelationNavigatorMobileMenu(): bool
{
return false;
}
翻訳
Filament と同じ言語コードで 32 言語に対応しています:アラビア語、ブルガリア語、カタロニア語、中国語(簡体字・繁体字)、チェコ語、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、ギリシャ語、ヘブライ語、ハンガリー語、インドネシア語、イタリア語、日本語、韓国語、ノルウェー語、ペルシャ語、ポーランド語、ポルトガル語(ポルトガル・ブラジル)、ルーマニア語、ロシア語、スロバキア語、スペイン語、スウェーデン語、トルコ語、ウクライナ語、ベトナム語。右から左に書く言語では、前後の矢印の向きが反転します。翻訳を変更したり言語を追加したりするには、翻訳ファイルを公開します。
php artisan vendor:publish --tag=filament-relation-navigator-translations独自のプリセット
パッケージのプリセットのどれかをもとに作り始めます。
php artisan make:filament-relation-navigator-preset compact --from=githubプリセットが resources/views/filament/relation-navigator/compact.blade.php にコピーされます。登録して、自由に変更してください。
'preset' => 'compact',
'presets' => [
// ...
'compact' => 'filament.relation-navigator.compact',
],preset には任意のビュー名も指定できます。パッケージのプリセットそのものを変更するには、そのビューを公開します。
php artisan vendor:publish --tag=filament-relation-navigator-viewsプリセットのビューは次の変数を受け取ります。
| 変数 | 内容 |
|---|---|
$label | パンくずリストの最後の項目 |
$items | メニューの項目:key、label、url、icon、badge、badgeColor、isActive |
$heading | "Switch page"(翻訳済み) |
$isSearchable | 検索フィールドを表示するかどうか |
$hasSeparator | レコードのページとリレーションページを 2 つのブロックに分けるかどうか |
$shortcut | ショートカット、または null |
$shortcutKeys | 表示するショートカットキー:['mac' => [...], 'other' => [...]] |
$searchPlaceholder | "Find a page…"(翻訳済み) |
$emptyLabel | "No pages found."(翻訳済み) |
$maxHeight | menu.max_height |
ボタンにツールチップとショートカットを付けるには、そのタグの中で filament-relation-navigator::menu.partials.trigger-attributes をインクルードします。各項目には isRelationPage() もあります。検索フィールド、リスト(区切りとキーボード操作を含む)、「結果なし」の行を再利用するには、showCheck を指定して filament-relation-navigator::menu.partials.list をインクルードします。