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

API リファレンス ​

以下はすべて公開 API で、セマンティックバージョニングの対象です。1.x の間は互換性を壊す形で変更されません。ここに載っていないものは内部用です。

トレイト ​

トレイト使う場所役割
Concerns\HasRelationPagesリソースすべてのリレーションマネージャーが専用のページを持つ
Concerns\InteractsWithRelationPageリレーションマネージャーこのリレーションマネージャーがページを持つ。下記の任意の static プロパティを読み取る
Concerns\HasRelationNavigatorレコードのページ(詳細、編集、カスタム)パンくずリストのメニューを表示し、このページもメニューに載る

すべて Wit3\FilamentRelationNavigator 名前空間にあります。

リソース側 ​

すべて static で、すべて任意です。

メソッド用途
hasRelationPage(string $slug): boolリレーションを除外する
canAccessRelationPage(Model $record, string $slug): boolレコードごとにリレーションページを拒否する(ページ、メニュー、グローバル検索、リダイレクト)
relationPageHeader(Schema $schema): Schemaすべてのリレーションページで、リレーションの上に表示するヘッダー
getRelationPageHeaderActions(): arrayリレーションページのヘッダーアクション
getRelationPageHeaderWidgets(): array、getRelationPageFooterWidgets(): arrayリレーションページのウィジェット($record を受け取る)
hasRelationPageLinks(): boolそのリレーションマネージャーの「ページとして開く」
configureRelationPageAction(Action $action, RelationManager $manager): Actionこのリソースでそのアクションを変更する
hasRelationPageGlobalSearchActions(): boolこのリソースのグローバル検索のリンク
任意のオプションメソッド(static)リソースのすべてのページに対するオプション

リレーションマネージャー側 ​

すべて static で、すべて任意です。プロパティには InteractsWithRelationPage が必要ですが、メソッドはなくても動作します。

プロパティまたはメソッド用途
$hasRelationPage、hasRelationPage(): boolこのリレーションマネージャーにページを用意するかどうか
$relationPageSlug、getRelationPageSlug(): ?stringそのページのスラッグ
$hasRelationPageLink、hasRelationPageLink(): boolそのテーブルの「ページとして開く」
$hasRelationPageGlobalSearchAction、hasRelationPageGlobalSearchAction(): boolグローバル検索の結果の下に表示するそのリンク
$hasRelationNavigatorBadge、hasRelationNavigatorBadge(): boolメニューでのそのバッジ(タブのバッジはそのまま)
getRelationPageTitle(Model $ownerRecord)そのページのタイトル。null でデフォルトのまま
getRelationPageSubheading(Model $ownerRecord)そのページのサブ見出し
getRelationPageBreadcrumb(Model $ownerRecord): ?stringそのページのパンくずリストの最後の項目
relationPageHeader()、getRelationPageHeaderActions()、getRelationPageHeaderWidgets()、getRelationPageFooterWidgets()リソースと同じ。ただしそのページだけ
configureRelationPageAction(Action $action, RelationManager $manager): Actionその「ページとして開く」アクションを変更する

Filament 自身の isBadgeLazyLoaded()(または $isBadgeLazyLoaded)でも、メニューのバッジが遅延読み込みになります。

レコードのページ側(HasRelationNavigator) ​

ページでどれでもオーバーライドできます。

メソッド用途
オプションメソッドこのページのオプション
getRelationNavigatorRecordNavigationQuery(): ?Builder前後のレコードの移動対象
withRelationNavigator(array $breadcrumbs): array自分で組み立てたパンくずリストにメニューを追加する

独自のリレーションページクラス ​

Pages\RelationPage を継承し(または php artisan make:filament-relation-navigator CustomerResource を実行し)、getPages() に ...CustomerRelationPage::relationRoutes() を展開します。

メンバー用途
protected static ?array $relationsこれらのスラッグだけ
protected static array $excludedRelationsこれらのスラッグは除外
protected static ?string $contextPage代わりとなるページのキー(デフォルトは詳細ページ、なければ編集ページ)
$title、$subheading、$breadcrumb、および Filament のページのすべてのメソッド通常の Filament ページと同じ

ヘルパー ​

RelationNavigator の static メソッドです。

メソッド用途
getItems(string $resource, Model $record, ...)レコードのメニュー項目
getRecordSubNavigation(Page $page): array同じ項目を Filament のサブナビゲーションとして返す
getRelationManagerPageUrl(RelationManager $manager): ?stringリレーションマネージャーのページ。独自のボタン用
getGlobalSearchResultActions(string $resource, Model $record): arrayグローバル検索のリンク。独自のものにマージする
configureRelationPageActionUsing(Closure $callback): voidすべての「ページとして開く」アクションを変更する
makeRelationPageAction(RelationManager $manager): Actionそのアクションを作成する
getRelationPageClass(string $resource): ?stringリソースのリレーションページクラス
RELATION_PAGE_ACTION「ページとして開く」アクションの名前

RelationNavigatorItem($items 内):key、label、url、icon、badge、badgeColor、isActive、isBadgeDeferred、isRelationPage()。

ルート、ビュー、コマンド ​

  • ルート名:{リソースのルートのベース}.relations.{slug}。getUrl('relations.orders', [...]) で使います。
  • ビュー:filament-relation-navigator::menu.github、menu.simple、menu.mobile、menu.partials.list、menu.partials.trigger-attributes。変数は独自のプリセットに一覧があります。
  • コマンド:make:filament-relation-navigator {resource}、make:filament-relation-navigator-preset {name} --from=github|simple。
  • 翻訳:filament-relation-navigator::navigator.*。

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