发布日期： 2026年2月5日
概括
Filament v5.2.0 版本发布了五项新功能，包括用于突出显示表单中重要信息的 Callout 组件、提升移动设备阅读体验的堆叠式表格行，以及可保持父模态框可见的堆叠式操作模态框。此外，该版本还为图表组件添加了延迟筛选支持，并新增了禁用租户切换的功能。
- 标注组件
- 移动设备上的堆叠表格行
overlayParentActions()堆叠式操作模态框- 图表组件的延迟筛选器
- 禁用租户切换
switchableTenants()
什么是新的
标注组件
此版本引入了一个新的标注组件，可用于模式和表单中。标注组件可以直接在表单布局中突出显示重要信息、警告或注释。
公关稿： #19189
移动设备上的堆叠表格行
现在，表格支持在移动屏幕上垂直堆叠单元格，而无需水平滚动。这种 CSS 优先的方法提高了小视口上的可读性，同时在大屏幕上保持了标准的水平布局。该功能与现有的响应式修饰符（例如 `
hiddenFrom()
和
visibleFrom()
。
公关稿： #19113
overlayParentActions()
堆叠式操作模态框
新的
overlayParentActions()
该方法允许子模态框堆叠在父模态框之上，而无需关闭并重新打开父模态框。这对于重复器或其他嵌套模式中的操作尤其有用，因为在这些情况下，关闭/重新打开模态框的循环可能会造成干扰。
行动
::
制作
（
'editItems'
）
->
滑动切换
（）
->
模式
（[
中继器
::
制作
（
'项目'
）
->
删除操作
（
静止的
fn
（
行动
$action) => $action
->
覆盖层父级操作
（），),]）
->
行动
（
功能
（）{
// ...}）当子模态框被关闭时，焦点会返回到父模态框。
公关稿： #19169
图表组件的延迟筛选器
图表组件现在可以使用延迟筛选器，仅在用户单击“应用”按钮时才更新图表，而不是在每次筛选器更改时都重新渲染。要启用此功能，请设置
$hasDeferredFilters = true
并实施
filtersSchema()
该方法使用标准的 Filament 表单组件。“重置”链接可将过滤器恢复为默认值，激活的过滤器徽章会显示已应用的过滤器数量。
公关稿： #19082
禁用租户切换
新的
switchableTenants()
面板构建器中的此方法允许您禁用租户切换器，同时保留租户菜单以执行其他操作，例如个人资料和账单链接。当租户可通过其他方式访问且不需要切换器界面时，此功能非常有用。
公关稿： #19110
升级说明
对于一般应用场景，预计不会出现重大变更。升级时请查看完整的变更日志以了解详细信息。
参考
