在jsonform中实现带全选功能的Fieldset字段组

背景介绍

jsonform是一个流行的JSON表单生成库，它允许开发者通过JSON配置快速生成复杂的表单界面。在实际项目中，我们经常需要实现带有"全选"功能的复选框组，这在用户需要批量选择多个选项时非常实用。

实现方案

基本结构

要实现带全选功能的Fieldset字段组，我们需要结合jsonform的schema和form配置。核心思路是：

1. 使用fieldset类型包裹复选框组
2. 在fieldset的标题中添加自定义HTML复选框
3. 通过JavaScript处理全选逻辑

配置示例

{
  "schema": {
    "menu": {
      "type": "array",
      "title": "Options",
      "items": {
        "type": "string",
        "title": "Option",
        "enum": ["starter", "maincourse", "cheese", "dessert"]
      }
    }
  },
  "form": [
    {
      "title": "<input type=\"checkbox\" onchange=\"handleChange()\"> Options (全选)",
      "type": "fieldset",
      "expandable": false,
      "items": [
        {
          "key": "menu",
          "notitle": true,
          "type": "checkboxes",
          "htmlClass": "checkbox-group",
          "titleMap": {
            "starter": "开胃菜",
            "maincourse": "主菜",
            "cheese": "奶酪",
            "dessert": "甜点"
          }
        }
      ]
    }
  ]
}

JavaScript处理逻辑

全选功能的JavaScript实现可以这样编写：

function handleChange(evt) {
  const allChecked = evt.target.checked;
  document.querySelectorAll('.checkbox-group input[type="checkbox"]').forEach(box => {
    if(box !== evt.target) {
      box.checked = allChecked;
    }
  });
}

技术要点

1. 自定义HTML标题：通过在fieldset的title属性中嵌入HTML代码，我们可以添加额外的UI元素。

2. CSS类名控制：为复选框组添加特定的htmlClass，便于JavaScript选择器精确找到需要控制的元素。

3. 事件处理：虽然jsonform的onchange属性只能调用函数名，但我们可以通过事件对象获取当前状态并处理。

4. 表单结构：使用fieldset包裹复选框组不仅语义化更好，还能提供更灵活的布局控制。

注意事项

1. 在Angular等框架中使用时，需要遵循框架的事件绑定方式，不能直接使用onchange属性。

2. 样式可能需要额外调整，特别是全选复选框的位置和对齐方式。

3. 如果表单是动态生成的，需要确保JavaScript函数在正确的作用域中可用。

扩展思考

这种技术不仅适用于复选框组，还可以应用于其他需要批量操作的场景。例如：

• 表格行的全选操作
• 多层级菜单的选择控制
• 复杂表单的批量编辑

通过灵活组合jsonform的各种特性，我们可以构建出功能丰富且用户友好的表单界面。