Skip to content
このページは翻訳です。内容に違いがある場合は、英語のドキュメントが正となります。 英語版を読む

メニューのプリセットとオプション ​

設定ファイルを公開します。

bash
php artisan vendor:publish --tag=filament-relation-navigator-config
php
'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 を設定します。

詳細ページの simple プリセット

バッジ ​

メニューには、タブと同じようにリレーションマネージャーのバッジが表示されます。デフォルトではメニューを開いたときに読み込まれます。それまでメニューは閉じているので、ページはバッジのクエリなしでレンダリングされます。パンくずリストを再描画するすべての Livewire リクエストでも同様です。読み込みの間はスピナーが表示されます。

php
'badges' => 'lazy', // デフォルト。true: ページと一緒、false: バッジなし

必要な場所で無効にできます。

php
// ページまたはリソース(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 です。設定またはページごとに変更できます。

php
'shortcut' => 'mod+shift+p', // mod は Mac では ⌘、それ以外では Ctrl
php
public function getRelationNavigatorShortcut(): ?string
{
    return null; // このページではショートカットなし
}

邪魔にならないように作られています。

  • 物理キーで判定するので、どのキーボードレイアウトでも、Mac の Option キー(⌥⇧R で ‰ が入力される)でも動作します。
  • フィールドに入力している間は何もしません。
  • パネルのグローバル検索のショートカット(globalSearchKeyBindings())を横取りすることはありません。その場合、メニューにはショートカットが付きません。
  • 開くのは表示されているメニューだけです(パンくずリストまたは小さな画面)。

使えるキー:alt、shift、ctrl、meta、mod に、英字、数字、または / . , ; を組み合わせます。

検索フィールド付きの github プリセット

ページ、リソース、設定 ​

各オプションには 3 つのレベルがあります。ページが最優先で、次にリソース、最後に設定です。

ページのメソッド(リソースでは static)設定キー
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
// 1 つのページで
public function isRelationNavigatorSearchable(): bool
{
    return false;
}
php
// リソースで: 同じメソッドを static にすると、そのすべてのページに適用
public static function hasRelationNavigatorRecordNavigation(): bool
{
    return true;
}

小さな画面 ​

Filament は 40rem 未満の画面でパンくずリストを非表示にします。その場合、HasRelationNavigator を使うすべてのページで、メニューがページ見出しの上に、同じプリセットのオプションで表示されます。'mobile' => false で無効にするか、ページごとに設定します。

php
public function hasRelationNavigatorMobileMenu(): bool
{
    return false;
}
スマートフォンでページ見出しの上に表示されたメニュー

翻訳 ​

Filament と同じ言語コードで 32 言語に対応しています:アラビア語、ブルガリア語、カタロニア語、中国語(簡体字・繁体字)、チェコ語、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、ギリシャ語、ヘブライ語、ハンガリー語、インドネシア語、イタリア語、日本語、韓国語、ノルウェー語、ペルシャ語、ポーランド語、ポルトガル語(ポルトガル・ブラジル)、ルーマニア語、ロシア語、スロバキア語、スペイン語、スウェーデン語、トルコ語、ウクライナ語、ベトナム語。右から左に書く言語では、前後の矢印の向きが反転します。翻訳を変更したり言語を追加したりするには、翻訳ファイルを公開します。

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

独自のプリセット ​

パッケージのプリセットのどれかをもとに作り始めます。

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

プリセットが resources/views/filament/relation-navigator/compact.blade.php にコピーされます。登録して、自由に変更してください。

php
'preset' => 'compact',
'presets' => [
    // ...
    'compact' => 'filament.relation-navigator.compact',
],

preset には任意のビュー名も指定できます。パッケージのプリセットそのものを変更するには、そのビューを公開します。

bash
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."(翻訳済み)
$maxHeightmenu.max_height

ボタンにツールチップとショートカットを付けるには、そのタグの中で filament-relation-navigator::menu.partials.trigger-attributes をインクルードします。各項目には isRelationPage() もあります。検索フィールド、リスト(区切りとキーボード操作を含む)、「結果なし」の行を再利用するには、showCheck を指定して filament-relation-navigator::menu.partials.list をインクルードします。

バージョン 1.8.1(2026-11-15 リリース)· MIT ライセンス。