Yii2中DynamicFormWidget自定义百分比求和验证失效问题

我之前也遇到过类似的问题，DynamicFormWidget的自定义总和验证确实容易踩坑，核心问题在于你当前的验证逻辑是直接操作POST数据，且错误信息绑定到单个字段上，而动态表单的子模型结构导致错误无法正确渲染出来。下面给你一套可行的解决方案：

1. 直接读取Yii::$app->request->post()['Category']不够规范，一旦表单有命名空间或使用AJAX验证，就会出错；
2. 你把总和验证绑定到单个percentage字段上，但这个错误是针对所有子模型的总和，绑定到单个字段会导致错误信息无法对应到正确位置；
3. 没有考虑浮点精度问题，直接用<>比较总和是否等于100，可能因为计算误差导致误判。

把总和验证逻辑放到包含动态子模型的父模型中，这样错误信息可以全局显示，逻辑也更清晰。

1. 定义父模型（包含动态子模型集合） #

假设你的动态子模型是Category，父模型可以这样写：

class ParentModel extends \yii\base\Model
{
    // 存储所有动态生成的Category子模型
    public $categories = [];

    public function init()
    {
        parent::init();
        // 初始化至少一个子模型
        $this->categories[] = new Category();
    }

    public function rules()
    {
        return [
            // 针对子模型集合的总和验证
            ['categories', 'validatePercentageTotal'],
        ];
    }

    /**
     * 验证所有子模型的percentage总和是否为100
     */
    public function validatePercentageTotal($attribute, $params)
    {
        $total = 0;
        foreach ($this->categories as $category) {
            // 跳过空值，避免非数值导致的错误
            if (!empty($category->percentage) && is_numeric($category->percentage)) {
                $total += (float)$category->percentage;
            }
        }

        // 考虑浮点精度问题，允许微小误差
        if (abs($total - 100) > 0.01) {
            $this->addError($attribute, '所有百分比的总和必须等于100');
        }
    }

    /**
     * 重载load方法，正确加载动态子模型数据
     */
    public function load($data, $formName = null)
    {
        if (parent::load($data, $formName)) {
            $this->categories = [];
            // 从POST中加载所有子模型数据
            foreach ($data['Category'] ?? [] as $categoryData) {
                $category = new Category();
                $category->load($categoryData, '');
                $this->categories[] = $category;
            }
            return true;
        }
        return false;
    }
}

2. 子模型（Category）保留基础验证 #

只做单个字段的基础校验，比如必填、数值范围：

class Category extends \yii\base\Model
{
    public $percentage;

    public function rules()
    {
        return [
            ['percentage', 'required', 'message' => '请填写百分比'],
            ['percentage', 'number', 'min' => 0, 'max' => 100, 'message' => '百分比必须在0-100之间'],
        ];
    }
}

3. 视图中渲染全局错误 #

在DynamicFormWidget上方添加父模型的全局错误提示，确保总和错误能被用户看到：

<?php
// 父模型实例
$model = new ParentModel();
?>

<!-- 显示总和验证的全局错误 -->
<?php if ($model->hasErrors('categories')): ?>
    <div class="alert alert-danger">
        <?= $model->getFirstError('categories') ?>
    </div>
<?php endif; ?>

<?php \wbraganca\dynamicform\DynamicFormWidget::begin([
    'widgetContainer' => 'dynamicform_wrapper',
    'widgetBody' => '.container-items',
    'widgetItem' => '.item',
    'limit' => 10,
    'min' => 1,
    'insertButton' => '.add-item',
    'deleteButton' => '.remove-item',
    'model' => $model->categories[0],
    'formId' => 'dynamic-form',
    'formFields' => [
        'percentage',
        // 其他需要动态生成的字段
    ],
]); ?>

<div class="container-items">
    <?php foreach ($model->categories as $index => $category): ?>
        <div class="item panel panel-default">
            <div class="panel-heading">
                <h3 class="panel-title pull-left">分类</h3>
                <div class="pull-right">
                    <button type="button" class="add-item btn btn-success btn-xs"><i class="fa fa-plus"></i></button>
                    <button type="button" class="remove-item btn btn-danger btn-xs"><i class="fa fa-minus"></i></button>
                </div>
                <div class="clearfix"></div>
            </div>
            <div class="panel-body">
                <?php
                // 为子模型设置索引
                if (!$category->isNewRecord) {
                    echo Html::activeHiddenInput($category, "[{$index}]id");
                }
                ?>
                <div class="form-group">
                    <?= Html::activeLabel($category, "[{$index}]percentage", ['class' => 'col-sm-2 control-label']) ?>
                    <div class="col-sm-10">
                        <?= Html::activeTextInput($category, "[{$index}]percentage", ['class' => 'form-control']) ?>
                        <?= Html::error($category, "[{$index}]percentage", ['class' => 'help-block']) ?>
                    </div>
                </div>
            </div>
        </div>
    <?php endforeach; ?>
</div>

<?php \wbraganca\dynamicform\DynamicFormWidget::end(); ?>

1. 永远通过模型加载数据，不要直接操作POST数组，这样能兼容表单命名空间、AJAX验证等场景；
2. 处理浮点精度问题，用绝对值差判断是否接近100，避免因为0.1+0.2=0.30000000000000004这类计算误差导致的错误；
3. 全局错误要单独渲染，DynamicFormWidget默认只会渲染子模型单个字段的错误，总和类的全局错误需要手动处理。

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