Skip to content
Эта страница — перевод: если что-то расходится, ориентируйтесь на документацию на английском. Читать на английском

Справочник API ​

Всё, что ниже, — публичный API, на который распространяется семантическое версионирование: в пределах 1.x он не меняется несовместимым образом. Всё, чего здесь нет, — внутреннее.

Трейты ​

ТрейтГде использоватьЧто делает
Concerns\HasRelationPagesресурсУ каждого relation manager своя страница
Concerns\InteractsWithRelationPagerelation managerУ этого relation manager есть страница; читает необязательные статические свойства ниже
Concerns\HasRelationNavigatorстраница записи (просмотр, редактирование, своя)Меню в хлебных крошках, и страница попадает в него

Все в пространстве имён Wit3\FilamentRelationNavigator.

На ресурсе ​

Все статические, все необязательные.

МетодНазначение
hasRelationPage(string $slug): boolИсключить связь
canAccessRelationPage(Model $record, string $slug): boolЗапретить страницу связи для записи (страницы, меню, глобальный поиск, редирект)
relationPageHeader(Schema $schema): SchemaШапка над связью на всех страницах связей
getRelationPageHeaderActions(): arrayДействия в шапке страниц связей
getRelationPageHeaderWidgets(): array, getRelationPageFooterWidgets(): arrayВиджеты страниц связей (получают $record)
hasRelationPageLinks(): bool«Открыть как страницу» в его relation manager
configureRelationPageAction(Action $action, RelationManager $manager): ActionИзменить это действие для этого ресурса
hasRelationPageGlobalSearchActions(): boolСсылки в глобальном поиске для этого ресурса
любой метод опции, staticОпция для всех страниц ресурса

В relation manager ​

Все статические, все необязательные. Свойствам нужен InteractsWithRelationPage; методы работают и без него.

Свойство или методНазначение
$hasRelationPage, hasRelationPage(): boolЕсть ли страница у этого relation manager
$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Изменить его действие «Открыть как страницу»

Собственный isBadgeLazyLoaded() Filament (или $isBadgeLazyLoaded) тоже делает его бейдж в меню ленивым.

На странице записи (HasRelationNavigator) ​

Переопределите любой из них на странице:

МетодНазначение
методы опцийОпции этой страницы
getRelationNavigatorRecordNavigationQuery(): ?BuilderЗаписи, по которым ходят «предыдущая» и «следующая»
withRelationNavigator(array $breadcrumbs): arrayДобавить меню в хлебные крошки, которые вы строите сами

Свой класс страницы связи ​

Наследуйте Pages\RelationPage (или запустите php artisan make:filament-relation-navigator CustomerResource) и добавьте ...CustomerRelationPage::relationRoutes() в getPages().

Член классаНазначение
protected static ?array $relationsТолько эти слаги
protected static array $excludedRelationsНикогда эти слаги
protected static ?string $contextPageКлюч страницы, которую она заменяет (по умолчанию страница просмотра, иначе страница редактирования)
$title, $subheading, $breadcrumb и любой метод страницы FilamentКак на любой странице Filament

Вспомогательные методы ​

Статические методы RelationNavigator:

МетодНазначение
getItems(string $resource, Model $record, ...)Элементы меню записи
getRecordSubNavigation(Page $page): arrayТе же элементы в виде sub-navigation Filament
getRelationManagerPageUrl(RelationManager $manager): ?stringСтраница relation manager, для ваших собственных кнопок
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.