高级
渲染钩子
简介
Filament 允许你在框架视图的各个节点渲染 Blade 内容。这对于让插件将 HTML 注入到框架很有用。同时,由于 Filament 不推荐发布视图,因为会破坏性更新的风险,因此这也对用户有帮助。
注册渲染钩子
要注册渲染钩子,你可以在服务提供者或者中间件中调用 FilamentView::registerRenderHook()
。第一个参数是钩子名称,第二个参数是返回要渲染内容的回调函数:
use Filament\Support\Facades\FilamentView;
use Filament\View\PanelsRenderHook;
use Illuminate\Support\Facades\Blade;
FilamentView::registerRenderHook(
PanelsRenderHook::BODY_START,
fn (): string => Blade::render('@livewire(\'livewire-ui-modal\')'),
);
你也可以从文件中渲染视图内容:
use Filament\Support\Facades\FilamentView;
use Filament\View\PanelsRenderHook;
use Illuminate\Contracts\View\View;
FilamentView::registerRenderHook(
PanelsRenderHook::BODY_START,
fn (): View => view('impersonation-banner'),
);
可用渲染钩子
面板构造器渲染钩子
use Filament\View\PanelsRenderHook;
PanelsRenderHook::AUTH_LOGIN_FORM_AFTER
- 登录表单之后PanelsRenderHook::AUTH_LOGIN_FORM_BEFORE
- 登录表单之前PanelsRenderHook::AUTH_PASSWORD_RESET_REQUEST_FORM_AFTER
- 密码重置请求表单之后PanelsRenderHook::AUTH_PASSWORD_RESET_REQUEST_FORM_BEFORE
- 密码重置请求表单之前PanelsRenderHook::AUTH_PASSWORD_RESET_RESET_FORM_AFTER
- 密码重置表单之后PanelsRenderHook::AUTH_PASSWORD_RESET_RESET_FORM_BEFORE
- 密码重置表单之前PanelsRenderHook::AUTH_REGISTER_FORM_AFTER
- 注册表单之后PanelsRenderHook::AUTH_REGISTER_FORM_BEFORE
- 注册表单之前PanelsRenderHook::BODY_END
-</body>
之前PanelsRenderHook::BODY_START
-<body>
之后PanelsRenderHook::CONTENT_AFTER
- 页面内容之后PanelsRenderHook::CONTENT_BEFORE
- 页面内容之前PanelsRenderHook::CONTENT_END
- 页面内容之后,<main>
标签内PanelsRenderHook::CONTENT_START
- 页面内容之前,<main>
标签内PanelsRenderHook::FOOTER
- 页面的 FooterPanelsRenderHook::GLOBAL_SEARCH_AFTER
- 全局搜索容器之后,在顶部导航栏内PanelsRenderHook::GLOBAL_SEARCH_BEFORE
- 全局搜索容器之前,在顶部导航栏内、PanelsRenderHook::GLOBAL_SEARCH_END
- 全局搜索容器尾部PanelsRenderHook::GLOBAL_SEARCH_START
- 全局搜索容器起始位置PanelsRenderHook::HEAD_END
-</head>
之前PanelsRenderHook::HEAD_START
-<head>
之后PanelsRenderHook::LAYOUT_END
- 布局容器的末尾,也可以限定作用域到页面类PanelsRenderHook::LAYOUT_START
- 布局容器的开始位置,也可以限定作用域到页面类、PanelsRenderHook::PAGE_END
- 页面内容容器的结尾,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_FOOTER_WIDGETS_AFTER
- 页面底部 Widget 之后,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_FOOTER_WIDGETS_BEFORE
- 页面底部 Widget 之前,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_HEADER_ACTIONS_AFTER
- 页面 Header Action 之后,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_HEADER_ACTIONS_BEFORE
- 页面 Header Action 之前,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_HEADER_WIDGETS_AFTER
- 页面 Header Widget 之后,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_HEADER_WIDGETS_BEFORE
- 页面 Header Widget 之后,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_START
- 页面内容容器的起始位置,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_SUB_NAVIGATION_END_AFTER
- 在页面子导航“结束”侧边栏位置之后,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_SUB_NAVIGATION_END_BEFORE
- 在页面子导航“结束”侧边栏位置之前,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_SUB_NAVIGATION_SELECT_AFTER
- 在页面子导航选择(适用于移动端)之后,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_SUB_NAVIGATION_SELECT_BEFORE
- 在页面子导航选择(适用于移动端)之前,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_SUB_NAVIGATION_SIDEBAR_AFTER
- 在页面子导航侧边栏之后,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_SUB_NAVIGATION_SIDEBAR_BEFORE
- 在页面子导航侧边栏之前,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_SUB_NAVIGATION_START_AFTER
- 在页面子导航“开始”侧边栏位置之后,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_SUB_NAVIGATION_START_BEFORE
- 在页面子导航“开始”侧边栏位置之前,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_SUB_NAVIGATION_TOP_AFTER
- 在页面子导航“顶部”标签位置之后,也可以限定作用域到页面或资源类PanelsRenderHook::PAGE_SUB_NAVIGATION_TOP_BEFORE
- 在页面子导航“顶部”标签位置之前,也可以限定作用域到页面或资源类PanelsRenderHook::RESOURCE_PAGES_LIST_RECORDS_TABLE_AFTER
- 资源表格之后,也可以限定作用域到页面或资源类PanelsRenderHook::RESOURCE_PAGES_LIST_RECORDS_TABLE_BEFORE
- 资源表格之前,也可以限定作用域到页面或资源类PanelsRenderHook::RESOURCE_PAGES_LIST_RECORDS_TABS_END
- 过滤器选项卡的末尾(最后一个选项卡之后),也可以限定作用域到页面或资源类PanelsRenderHook::RESOURCE_PAGES_LIST_RECORDS_TABS_START
- 过滤器选项卡的起始位置(第一个选项卡之前),也可以限定作用域到页面或资源类PanelsRenderHook::RESOURCE_PAGES_MANAGE_RELATED_RECORDS_TABLE_AFTER
- 关联管理器表格之后,也可以限定作用域到页面或资源类PanelsRenderHook::RESOURCE_PAGES_MANAGE_RELATED_RECORDS_TABLE_BEFORE
- 关联管理器表格之前,也可以限定作用域到页面或资源类PanelsRenderHook::RESOURCE_RELATION_MANAGER_AFTER
- 关联管理器表格之后,也可以限定作用域到页面或资源管理器类PanelsRenderHook::RESOURCE_RELATION_MANAGER_BEFORE
- 关联管理器表格之前,也可以限定作用域到页面或资源管理器类PanelsRenderHook::RESOURCE_TABS_END
- 资源选项卡尾部(最后一个选项卡之后),也可以限定作用域到页面或资源类PanelsRenderHook::RESOURCE_TABS_START
- 资源选项卡开始位置(第一个选项卡之前),也可以限定作用域到页面或资源类PanelsRenderHook::SCRIPTS_AFTER
- 脚本定义之后PanelsRenderHook::SCRIPTS_BEFORE
- 脚本定义之前PanelsRenderHook::SIDEBAR_NAV_END
- 侧边栏,</nav>
之前PanelsRenderHook::SIDEBAR_NAV_START
- 侧边栏,<nav>
之后PanelsRenderHook::SIMPLE_LAYOUT_END
- 简单布局容器尾部,也可以限定作用域到页面类PanelsRenderHook::SIMPLE_LAYOUT_START
- 简单布局容器起始位置,也可以限定作用域到页面类PanelsRenderHook::SIMPLE_PAGE_END
- 简单页面内容容器尾部,也可以限定作用域到页面类PanelsRenderHook::SIMPLE_PAGE_START
- 简单页面内容容器起始位置,也可以限定作用域到页面类PanelsRenderHook::SIDEBAR_FOOTER
- 固定在侧边栏底部,内容下方PanelsRenderHook::STYLES_AFTER
- 样式定义之后PanelsRenderHook::STYLES_BEFORE
- 样式定义之前PanelsRenderHook::TENANT_MENU_AFTER
- 在租户菜单之后PanelsRenderHook::TENANT_MENU_BEFORE
- 在租户菜单之前PanelsRenderHook::TOPBAR_AFTER
- 顶部栏下方PanelsRenderHook::TOPBAR_BEFORE
- 顶部栏上方PanelsRenderHook::TOPBAR_END
- 顶部栏容器尾部PanelsRenderHook::TOPBAR_START
- 顶部栏容器起始位置PanelsRenderHook::USER_MENU_AFTER
- 用户菜单之后PanelsRenderHook::USER_MENU_BEFORE
- 用户菜单之前PanelsRenderHook::USER_MENU_PROFILE_AFTER
- 在用户菜单中的个人资料项之后PanelsRenderHook::USER_MENU_PROFILE_BEFORE
- 在用户菜单中的个人资料项之前
表格构造器渲染钩子
所有这些渲染钩子都可作用于所有表格 Livewire 组件类。使用面板时,这些类可能是资源的列表页或者管理页、或者关联管理器。表格 Widget 也是 Livewire 组件类。
use Filament\Tables\View\TablesRenderHook;
TablesRenderHook::SELECTION_INDICATOR_ACTIONS_AFTER
- 在选择指示栏的“全选(Select All)“或者”取消全选(Deselect All)“操作按钮之后TablesRenderHook::SELECTION_INDICATOR_ACTIONS_BEFORE
- 在选择指示栏的“全选(Select All)“或者”取消全选(Deselect All)“操作按钮之前TablesRenderHook::HEADER_AFTER
- Header 容器之后TablesRenderHook::HEADER_BEFORE
- Header 容器之前TablesRenderHook::TOOLBAR_AFTER
- 在工具栏容器之后TablesRenderHook::TOOLBAR_BEFORE
- 在工具栏容器之前TablesRenderHook::TOOLBAR_END
- 在工具栏尾部TablesRenderHook::TOOLBAR_GROUPING_SELECTOR_AFTER
- 在分组选择器之后TablesRenderHook::TOOLBAR_GROUPING_SELECTOR_BEFORE
- 在分组选择器之前TablesRenderHook::TOOLBAR_REORDER_TRIGGER_AFTER
- 在重新排序(reorder)触发器之后TablesRenderHook::TOOLBAR_REORDER_TRIGGER_BEFORE
- 在重新排序(reorder)触发器之前TablesRenderHook::TOOLBAR_SEARCH_AFTER
- 在搜索容器之后TablesRenderHook::TOOLBAR_SEARCH_BEFORE
- 在搜索容器之前TablesRenderHook::TOOLBAR_START
- 工具栏起始位置TablesRenderHook::TOOLBAR_COLUMN_MANAGER_TRIGGER_AFTER
- 在列管理器触发器之后TablesRenderHook::TOOLBAR_COLUMN_MANAGER_TRIGGER_BEFORE
- 在列管理器触发器之前
Widget 渲染钩子
use Filament\Widgets\View\WidgetsRenderHook;
WidgetsRenderHook::TABLE_WIDGET_END
- 在表格 Widget的末尾,在表格本身之后,还可以将其作用域限定到表格 Widget 类WidgetsRenderHook::TABLE_WIDGET_START
- 在表格 Widget的开头,在表格本身之前,还可以将其作用域限定到表格 Widget 类
渲染钩子作用域
有些渲染钩子可以限定“作用域”,这使得他们只在特定页面或者特定 Livewire 组件中输出。比如,你只想为一个页面注册渲染钩子。你可以将页面类或者组件类作为第二个参数传递给 registerRenderHook()
:
use Filament\Support\Facades\FilamentView;
use Filament\View\PanelsRenderHook;
use Illuminate\Support\Facades\Blade;
FilamentView::registerRenderHook(
PanelsRenderHook::PAGE_START,
fn (): View => view('warning-banner'),
scopes: \App\Filament\Resources\Users\Pages\EditUser::class,
);
你也可以传递一个作用域数组来注册渲染钩子:
use Filament\Support\Facades\FilamentView;
use Filament\View\PanelsRenderHook;
FilamentView::registerRenderHook(
PanelsRenderHook::PAGE_START,
fn (): View => view('warning-banner'),
scopes: [
\App\Filament\Resources\Users\Pages\CreateUser::class,
\App\Filament\Resources\Users\Pages\EditUser::class,
],
);
有一些面板构建器的渲染钩子允许你将钩子作用域用于资源中的所有页面:
use Filament\Support\Facades\FilamentView;
use Filament\View\PanelsRenderHook;
FilamentView::registerRenderHook(
PanelsRenderHook::PAGE_START,
fn (): View => view('warning-banner'),
scopes: \App\Filament\Resources\Users\UserResource::class,
);
在渲染钩子中检索当前激活作用域
$scopes
参数传入到渲染钩子参数,你可以用来确定那些页面或者组件中渲染这些钩子:
use Filament\Support\Facades\FilamentView;
use Filament\View\PanelsRenderHook;
FilamentView::registerRenderHook(
PanelsRenderHook::PAGE_START,
fn (array $scopes): View => view('warning-banner', ['scopes' => $scopes]),
scopes: \App\Filament\Resources\Users\UserResource::class,
);
渲染钩子
插件开发者可能会想暴露渲染钩子给用户。你无需再任何地方对这些钩子进行注册,只需在 Blade 视图中像这样简单输出:
{{ \Filament\Support\Facades\FilamentView::renderHook(\Filament\View\PanelsRenderHook::PAGE_START) }}
要为你的渲染钩子提供作用域,你可以将其作为第二个参数传入到 renderHook()
中。比如,如果你的钩子在 Livewire 组件内,你可以使用 static::class
传递组件类:
{{ \Filament\Support\Facades\FilamentView::renderHook(\Filament\View\PanelsRenderHook::PAGE_START, scopes: $this->getRenderHookScopes()) }}
你可以将多个作用域作为数组传入,所有匹配该作用域的钩子都会被渲染:
{{ \Filament\Support\Facades\FilamentView::renderHook(\Filament\View\PanelsRenderHook::PAGE_START, scopes: [static::class, \App\Filament\Resources\Users\UserResource::class]) }}
Edit on GitHubStill need help? Join our Discord community or open a GitHub discussion