OctoberCMS Builder多对多关联复选框：新建记录全选默认值配置

嘿，刚好我之前也遇到过这个需求，给你分享两个靠谱的实现方法，亲测有效：

方法一：通过模型初始化逻辑自动关联所有选项 #

这种方法是在模型实例化时（也就是新建记录的表单加载时），自动把所有关联模型绑定到当前新模型上，这样表单里的复选框就会默认全选。

假设你的主模型是Post，关联的多对多模型是Category，关联关系定义为categories()，那你可以在Post模型里添加以下代码：

public function init()
{
    parent::init();

    // 仅对新建的空模型生效（已有记录不触发）
    if (!$this->exists) {
        // 获取所有关联模型的记录
        $allRelatedItems = Category::all();
        // 同步所有关联ID到当前模型的多对多关系中
        $this->categories()->sync($allRelatedItems->pluck('id')->toArray());
    }
}

方法二：通过控制器的表单事件修改字段默认值 #

如果你不想在模型里写逻辑，也可以在对应后端控制器中通过表单扩展事件来设置字段的默认选中值。

在你的后端控制器（比如Posts控制器）中添加以下方法：

public function formExtendFields($form)
{
    // 仅处理新建记录的表单
    if (!$form->model->exists) {
        // 获取你定义的多对多复选框字段（这里假设字段名是categories）
        $relationField = $form->getField('categories');
        
        if ($relationField) {
            // 获取所有关联模型的ID数组
            $allRelatedIds = Category::all()->pluck('id')->toArray();
            // 设置字段的默认选中值为所有ID
            $relationField->value = $allRelatedIds;
        }
    }
}

基础表单字段配置前提 #

别忘了确保你的fields.yaml里已经正确配置了多对多的复选框字段，示例配置如下：

categories:
    label: 关联分类
    type: relation
    nameFrom: name  # 关联模型中用于显示名称的字段
    mode: checkbox  # 必须设置为checkbox模式
    span: full

注意事项 #

如果你的关联模型数据量很大（比如上千条），全选操作可能会影响表单加载性能，这种情况下建议考虑是否真的需要默认全选，或者添加分页/搜索功能优化体验。

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