Vue.js 实现树形结构管理系统的前端设计与实现

婷婷婷婷
48 阅读5分钟

在现代前端开发中，树形结构被广泛应用于各类数据管理系统，尤其是在需要展示层级关系的场景中。本文将从前端开发的角度出发，详细分析如何使用 Vue.js 实现一个灵活的树形结构管理系统，重点介绍前端代码的实现和设计思路。

项目背景

树形结构通常用于表示具有层级关系的数据，如目录、文件、分类等。在这个项目中，我们需要实现一个前端页面，允许用户对数据进行搜索、展示、编辑和删除等操作。该系统是一个典型的数据管理工具，适用于内容管理系统（CMS）或任何需要展示和管理层级数据的应用。

通过使用 Vue.js 和 Element UI 组件库，我们可以快速构建出一个功能强大且易于使用的树形结构管理系统。以下将详细介绍实现的具体思路及相关代码。

项目亮点

1. 树形结构展示与操作

树形结构的核心部分是展示数据，并提供各种操作按钮（如新增、编辑、删除）。在 Vue.js 中，我们可以通过 el-tree 组件来实现树形结构的展示。每个树节点的内容和操作按钮都通过插槽（slot）自定义，以满足不同节点层级的需求。

<el-tree ref="tree" :data="filteredTreeOptionslist" node-key="id" :props="defaultProps" highlight-current
          style="font-size: 14px" :default-expanded-keys="[0]" :expand-on-click-node="false"
          :filter-node-method="filterNode">
  <template slot-scope="{ node, data }">
    <span class="custom-tree-node">
      <span @click="handleNodeClick(data)">
        <i v-if="node.level == 2" class="el-icon-folder-opened" style="font-size: 16px;" />
        {{ data.name }}
      </span>
      <span class="tree-bts">
        <i v-if="node.level != 2" class="el-icon-circle-plus-outline bt-add" @click="() => handleAddContrast(data)" />
        <i v-if="node.level != 1 && data.id != 0 && data.id != 1" class="el-icon-edit-outline bt-edit"
           @click="() => handleEditContrast(data)" />
        <i v-if="node.level != 1 && data.id != 0 && data.id != 1" class="el-icon-delete bt-delete"
           @click="() => handleDelContrast(data)" />
      </span>
    </span>
  </template>
</el-tree>

解释：

  • 使用 el-tree 组件展示树形数据，并通过 filter-node-method 进行节点过滤。
  • 通过插槽（slot-scope）自定义每个节点的展示，条件渲染不同层级的节点和操作按钮。
  • 为树形节点添加交互功能（例如，点击节点展开/折叠）。

2. 实时搜索与动态过滤树形数据

用户可以通过搜索框来快速定位到树形结构中的目标节点。每当用户输入搜索内容时，前端会动态过滤树节点，保证用户在庞大的树形数据中快速找到目标节

<el-input v-model="sourceName" placeholder="请输入名称搜索" clearable size="small" prefix-icon="el-icon-search"
          style="margin-bottom: 20px" />

<el-tree ref="tree" :data="filteredTreeOptionslist" node-key="id" :props="defaultProps" highlight-current
          :filter-node-method="filterNode">
</el-tree>

解释：

  • v-model="sourceName" 实现搜索框和树形数据之间的双向绑定。
  • filter-node-method="filterNode" 通过自定义过滤函数来实时过滤树节点。
  • 当 sourceName 改变时，调用 filterNode 函数过滤树节点。

3. 数据增删改操作与表单管理

在这个系统中，用户可以进行节点的新增、编辑和删除操作。每个操作都会通过弹出的对话框进行表单提交，表单包括目录名称、标识符等信息。表单的提交过程包含了数据验证，确保用户输入的内容符合要求。

<el-dialog :title="title" :visible.sync="dialogFormVisible" width="600px" :close-on-click-modal="false"
           append-to-body>
  <div class="container">
    <el-form ref="typeForm" :model="typeFrom" :rules="rules" label-width="100px">
      <el-row>
        <el-col :span="20">
          <el-form-item label="目录名称：" prop="name">
            <el-input v-model="typeFrom.name" maxlength="20" placeholder="目录名称" style="width: 70%" />
          </el-form-item>
        </el-col>
      </el-row>
      <el-row>
        <el-col :span="20">
          <el-form-item label="标识符：" prop="code">
            <el-input v-model="typeFrom.code" placeholder="标识符" style="width: 70%" maxlength="20" />
          </el-form-item>
        </el-col>
      </el-row>
    </el-form>
  </div>
  <div slot="footer" class="dialog-footer">
    <el-button size="mini" @click="cancel">关 闭</el-button>
    <el-button type="primary" size="mini" @click="typeSubmitForm">确 定</el-button>
  </div>
</el-dialog>

解释：

  • el-dialog 用于弹出表单对话框，允许用户填写或编辑树节点的内容。
  • 表单通过 el-form 和 el-form-item 进行布局，并设置校验规则（如名称和标识符不能为空）。
  • 提交表单时，会根据数据的状态（新增或编辑）调用不同的 API 接口，更新树形数据。

4. 树形数据的深度复制与展开控制

树形数据通常需要深度复制，以确保每个节点的状态（如展开状态）不会互相干扰。同时，我们还需要控制树形节点的展开与折叠，特别是在数据量较大的时候。

// 深度复制树形数据
deepCopy(nodes, level) {
  return nodes.map(node => {
    const newNode = { ...node };
    if (level < 2) {
      newNode.expanded = true;  // 默认展开前两层
    }
    if (node.children) {
      newNode.children = this.deepCopy(node.children, level + 1);  // 递归复制子节点
    }
    return newNode;
  });
},

解释：

  • deepCopy 方法深度复制树形节点数据，确保每一层的节点状态独立。
  • 默认展开前两层，提供更好的用户体验。

5. 表单校验与数据合法性

在用户提交表单之前，我们需要对用户输入的数据进行校验。通过 Vue.js 的表单验证功能，我们可以确保用户提交的数据符合规定的格式，例如正整数、非空等。

rules: {
  name: [{ required: true, message: '目录名称不能为空', trigger: 'blur' }],
  code: [{ required: true, message: '标识符不能为空', trigger: 'blur' }],
  sortOrder: [
    { required: true, message: '请输入正整数', trigger: 'blur' },
    { validator: this.validateIntegerInput, trigger: 'blur' }
  ]
},
validateIntegerInput(rule, value, callback) {
  if (!/^[0-9]{1,4}$/.test(value)) {
    callback(new Error('请输入1到4位的正整数'));
  } else {
    callback();
  }
},

解释：

  • rules 定义了表单字段的校验规则，确保目录名称、标识符等字段不能为空。
  • validateIntegerInput 是一个自定义的校验函数，确保用户输入的是一个1到4位的正整数。

6. 提交表单并更新树形数据

在完成表单的填写和校验后，用户可以提交表单。表单提交后，前端会调用对应的 API 接口进行数据的新增或更新，并根据返回结果更新树形数据。

typeSubmitForm() {
  this.$refs.typeForm.validate(valid => {
    if (valid) {
      if (this.typeFrom.id != null) {
        updateRuleType(this.typeFrom).then((response) => {
          this.$message.success("修改成功");
          this.dialogFormVisible = false;
          this.getTree();
          this.reset();
        });
      } else {
        addRuleType(this.typeFrom).then((response) => {
          this.$message.success("新增成功");
          this.dialogFormVisible = false;
          this.getTree();
          this.reset();
        });
      }
    } else {
      return false;
    }
  });
},

解释：

  • typeSubmitForm 用于提交表单，调用 addRuleType 或 updateRuleType 函数根据表单数据进行增删改操作。

总结

本文通过一个树形结构管理系统的实现，展示了如何使用 Vue.js 和 Element UI 组件来处理复杂的数据展示和操作。通过灵活的组件化设计、实时搜索与过滤、表单校验与提交等技术，前端开发可以有效地管理和展示层级结构数据。对于开发者来说，这样的系统提供了很多值得借鉴的设计思路和实现方式，特别是在数据管理和用户交互方面的优化。

avatar
文章
阅读
粉丝