Laravel 9 Nova4如何改造关联附加页实现属性选项级联选择

现有基于Laravel 9 + Nova 4搭建的项目，实体关系如下：

• Attribute实体：用于定义属性分类，例如Project Type、Rating等，与Option实体为一对多关系
• Option实体：用于存储属性对应的可选取值，例如Project Type 1、Project Type 2等，单个Option归属于一个Attribute
• Contractor实体：承包商实体，与Option为多对多关系，可挂载多个属性选项

需求为在Nova管理端实现两个关联管理场景：

• 承包商详情页，为选中的承包商附加关联选项
• 选项详情页，为选中的选项附加关联承包商

直接使用Nova原生BelongsToMany字段配置关联时，承包商页的选项选择下拉会加载全量选项，未按属性分类做区分，需要实现联动选择效果：第一个下拉选择属性分类，第二个下拉仅展示当前选中属性下的可选选项。

直接基于Nova 4原生字段依赖能力实现，无需安装第三方扩展，兼容双向关联配置。

核心逻辑 #

在承包商的关联表单中新增一个无持久化的属性选择字段，通过dependsOn方法监听该字段的选中值，动态过滤BelongsToMany关联字段的选项查询范围，实现联动效果。

具体代码配置 #

1. 配置Contractor Nova资源的表单字段：

// app/Nova/Contractor.php
public function fields(NovaRequest $request)
{
    return [
        // ID、名称等基础字段省略

        // 属性选择下拉，仅用于表单交互，不写入数据库
        Select::make('属性分类', 'selected_attribute')
            ->options(fn() => Attribute::query()->pluck('name', 'id'))
            ->default(function ($request, $model) {
                // 编辑模式下，默认选中当前承包商已绑定的第一个选项所属的属性
                if ($model->exists && $model->options->isNotEmpty()) {
                    return $model->options->first()->attribute_id;
                }
                return null;
            })
            ->fillUsing(fn() => true)
            ->rules('required')
            ->onlyOnForms(),

        // 重写选项关联的查询逻辑，根据选中的属性过滤选项
        BelongsToMany::make('已选选项', 'options', Option::class)
            ->dependsOn(['selected_attribute'], function (BelongsToMany $field, NovaRequest $request, $formData) {
                $attributeId = data_get($formData, 'selected_attribute');
                
                $field->relatableQueryUsing(function ($query) use ($attributeId) {
                    return $attributeId 
                        ? $query->where('attribute_id', $attributeId)
                        : $query->whereRaw('1=0'); // 未选属性时不返回任何选项
                });
            }),
    ];
}

2. Option Nova资源的反向关联配置无需特殊处理，直接使用原生BelongsToMany即可：

// app/Nova/Option.php
public function fields(NovaRequest $request)
{
    return [
        // 基础字段省略
        BelongsTo::make('所属属性', 'attribute', Attribute::class),
        BelongsToMany::make('关联承包商', 'contractors', Contractor::class),
    ];
}

体验优化点 #

• 属性字段如果数据量较大，可替换为SearchableSelect字段，支持关键词搜索快速定位属性
• 若需要在批量操作中实现相同联动逻辑，直接在Action的fields方法中复用上述字段依赖配置即可
• 可在属性选择字段旁添加帮助文本，提示用户先选择属性再选择对应选项

内容的提问来源于stack exchange，提问作者Gevorg Melkumyan