超实用多选框 checkbox 功能——全选不选反选等功能的数据驱动 JS 实现

Posted 2022-07-29 FungLeo

超实用多选框 checkbox 功能——全选、不选、反选等功能的数据驱动 JS 实现

对多选框实现 全选、不选、反选 是一个常见的功能，尤其是在外面使用了 vue 或者 react 等前端框架之后，仅仅是需要数据处理，我相信各位朋友都已经烂熟于心了。但是我近日遇到一个需求，琢磨了一下实现了。我感觉这段代码有分享的价值，因此编撰此文，与诸君分享。

了解需要实现的功能需求

一图胜前言，我们来看下要实现的效果图，如下：

如上图所示，我们可以看到，这是一整个的多选框，绑定在一个数据值上。

首先，要实现的上面的蓝色的按钮的功能，对于整个区块都要实现 全选、不选、反选 等功能。这没什么好说的，基础功能而已。

其次，要实现各个分组内多选框的 全选、不选、反选 等功能。在组内实现这些功能的时候，是不能影响到其他分组的选择数据的。这个功能貌似有点麻烦，但是我决定满足产品MM的需求~

本文仅针对核心功能进行实现，不对UI层面或其他数据绑定内容进行讨论，毕竟那些都是基础的业务代码而已。

数据结构

首先，后端给了我们一个二维数组，我们通过两层循环就可以得到如上图的UI了。这个二维数组，就是我们的基础数据。

然后，我们提交给后端的数据，是一个一维数组，也就是把选中的这些数据构成一个数组。这是我们想要的结果。

那么，我们在实现这个功能的时候，就需要如下数据了：

1. 操作类别，是全选，不选，还是反选呢？这里，我用 all | no | reverse 这三个字符串来进行标识。
2. 已经选择的数据数组。
3. 所有的可选项。
4. 需要操作的一组数据的所有可选项。

业务代码可以给我们需要实现的这个功能提供以上这四个数据，然后，它就只等结果了。而我们今天讨论的，就是这个方法的实现。

代码实现

祖师爷教导我们说—— Talk is cheap.Show me your code.

/*
  多选框 全选 反选 不选 工具方法，支持单层和双层数据处理
  参数说明：
  type: String 操作功能
        'all'      全选
        ‘no’       不选
        'reverse'  反选
  checkedItems: Array  已经选中的多选框数据值数组
  allItems: Array      全部可选择的多选框数据值数组
  classItems: Array or null 仅需要处理的一组可选多选框数据值
*/
export const checkBoxTool = (type, checkedItems, allItems, classItems) => 
  let classChecked = []
  if (classItems) 
    // 组内数据处理
    // 计算当前项中已经选择的数据
    classItems.forEach(i => 
      checkedItems.includes(i) && classChecked.push(i)
    )
    // 在全部选择的数据中剔除当前组已选择的数据
    classChecked.forEach(i => 
      checkedItems.includes(i) && (delete checkedItems[checkedItems.indexOf(i)])
    )
    // 删除数据后，需要给已选择数据过滤空
    checkedItems = checkedItems.filter(i => i)
   else 
    // 全部数据处理
    classItems = allItems
    classChecked = [...checkedItems]
    checkedItems = []
  
  // 分别处理计算结果
  let res = []
  const actions = 
    all: () => 
      res = [...classItems]
    ,
    no: () => 
      res = []
    ,
    reverse: () => 
      classItems.forEach(i => !classChecked.includes(i) && res.push(i))
    
  
  actions[type]()
  return [...checkedItems, ...res]

代码总结

对于是针对所有数据进行处理，还是针对组内数据进行处理，就看传不传 classItems 这个组内可选择数据数组了。如果不传，就是进行全部数据的处理，反之则反之。

我们通过视频来看一下我们的实现效果：

超实用多选框 checkbox 功能——全选、不选、反选等功能的数据驱动 JS 实现

最后，希望我的这段代码能够对各位看官有所帮助。

本文由 FungLeo 原创，允许转载，但转载必须保留首发链接。