在jQuery-QueryBuilder中为规则组添加自定义权重字段

jQuery-QueryBuilder是一个强大的jQuery插件，用于创建复杂的查询条件界面。在实际应用中，我们经常需要为规则组添加额外的自定义字段来满足特定业务需求。本文将详细介绍如何为规则组添加权重字段并实现数据的存储与读取。

需求背景

在许多业务场景中，我们需要为不同的规则组分配不同的权重值。例如在搜索系统中，某些条件组合可能比其他组合更重要；在评分系统中，不同规则组可能对最终得分有不同的影响比例。

实现方案

1. 存储权重值

首先，我们需要一个全局对象来存储各个规则组的权重值：

let ruleGroupWeights = {};

const weightChanged = (value, levelId) => {
    ruleGroupWeights[levelId] = value;
};

这里使用一个对象ruleGroupWeights来保存权重值，键是规则组的层级ID，值是对应的权重数值。weightChanged函数用于在权重值变化时更新存储。

2. 修改组模板

接下来，我们需要修改规则组的模板，添加权重输入框：

templates: {
    group: ({group_id, level, conditions, icons, settings, translate, builder}) => {
        return `<div id="${group_id}" class="rules-group-container">
<div class="rules-group-header">
  <div class="btn-group float-end group-actions">
    <input type="number" step="0.01" id="${group_id}_weight" name="${group_id}_weight" onchange="weightChanged(this.value, ${level})"/>
      <button type="button" class="btn btn-sm btn-success" data-add="rule">
...

在组模板中添加了一个数字输入框，类型为number，步长为0.01以支持小数权重。当值变化时，调用weightChanged函数更新存储。

3. 获取规则时处理权重

最后，在获取规则时，我们需要将存储的权重值添加到规则对象中：

$('#btn-get').on('click', function () {
    const result = $('#dateRuleBuilder').queryBuilder('getRules');
    
    function populateWeights(result, level = 1) {
        if (result.hasOwnProperty('condition')) {
            result.weight = ruleGroupWeights[level];
            
            if (result.hasOwnProperty('rules')) {
                for (const rule in result.rules) {
                    populateWeights(result.rules[rule], level + 1);
                }
            }
        }
    }

    populateWeights(result);

    if (!$.isEmptyObject(result)) {
        console.log(JSON.stringify(result, null, 2));
    }
});

populateWeights函数递归遍历规则树，为每个规则组添加对应的权重值。level参数表示当前规则组的层级，从1开始递增。

技术要点

1. 数据存储：使用全局对象存储权重值，确保在页面生命周期内数据不丢失。

2. 模板定制：通过修改组模板添加自定义字段，保持UI一致性。

3. 递归处理：使用递归函数处理嵌套的规则结构，确保所有层级的规则组都能正确获取权重值。

4. 事件绑定：通过onchange事件实时更新权重值，保证数据同步。

扩展思考

这种模式可以扩展到其他自定义字段的添加，例如：

• 为规则组添加优先级字段
• 添加生效时间范围
• 添加说明文本等

只需要修改模板添加相应字段，并在获取规则时处理这些字段即可。这种灵活性使得jQuery-QueryBuilder能够适应各种复杂的业务场景需求。

总结

通过本文介绍的方法，我们成功实现了为jQuery-QueryBuilder的规则组添加权重字段的功能。这种方案具有以下优点：

1. 非侵入式修改，不影响原有功能
2. 实现简单，易于理解和维护
3. 可扩展性强，可以方便地添加其他自定义字段

希望本文能为需要在jQuery-QueryBuilder中添加自定义字段的开发者提供有价值的参考。