Filament v5.2.0 新增 Callout 组件

发布日期：2026 年 2 月 5 日

概要

Filament v5.2.0 版本新增五项功能，包括用于在表单中突出显示重要信息的 Callout 组件、提升移动端可读性的堆叠式表格行，以及可保持父模态框可见的堆叠式操作模态框。此版本还新增了对图表组件的延迟筛选支持，以及禁用租户切换的功能。

• Callout 组件
• 移动端堆叠式表格行
• 堆叠式操作模态框的 overlayParentActions() 函数

图表组件的延迟筛选

通过 switchableTenants() 函数禁用租户切换

新增功能

Callout 组件

此版本引入了一个新的 Callout 组件，可用于模式和表单。Callout 组件可以直接在表单布局中突出显示重要信息、警告或注释。

移动端堆叠式表格行

现在，移动屏幕上的表格支持垂直堆叠单元格，无需水平滚动即可显示。这种 CSS 优先的方法提高了小屏幕上的可读性，同时在大屏幕上保持了标准的水平布局。该功能与现有的响应式修饰符（例如 hiddenFrom() 和 visibleFrom()）协同工作。

用于堆叠式操作模态框的 overlayParentActions() 方法

新增 overlayParentActions() 方法允许子模态框堆叠在父模态框之上，而无需关闭并重新打开父模态框。这对于 Repeater 或其他嵌套模式中的操作尤其有用，因为关闭/重新打开循环可能会造成干扰。

Action::make('editItems')
    ->slideOver()
    ->schema([
        Repeater::make('items')
            ->deleteAction(
                static fn (Action $action) => $action->overlayParentActions(),
            ),
    ])
    ->action(function () {
        // ...
    })

当子模态框关闭后，焦点将会返回到父级模态框中。

图表组件的延迟筛选器

图表组件现在可以使用延迟筛选器，该筛选器仅在用户单击“应用”按钮时更新图表，而不是在每次筛选器更改时都重新渲染。要启用此功能，请设置 $hasDeferredFilters = true 并使用标准 Filament 表单组件实现 filtersSchema() 方法。“重置”链接会将筛选器恢复为默认值，并且活动筛选器徽章会显示已应用的筛选器数量。

禁用租户切换

面板构建器上的新 switchableTenants() 方法允许你禁用租户切换器，同时保持租户菜单可用于其他操作，例如个人资料和账单链接。当通过其他方式访问租户且不需要切换器 UI 时，此功能非常有用。

升级说明

对于一般应用，预计不会出现重大更改。升级时，请查看完整的变更日志以了解详细信息。