提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

文章目录

前言1. 前端项目结构一、index.vue1. 控件在网页、代码之间的映对1.1.1 控件1.1.2 参数1.3

二、dept.js1.代码2.未完待续

总结

前言

以“系统管理 - 部门管理”

认识若依前端 index.vue

认识若依前端 dept.js

1. 前端项目结构

项目结构

├── build // 构建相关

├── bin // 执行脚本

├── public // 公共文件

│ ├── favicon.ico // favicon图标

│ └── index.html // html模板

├── src // 源代码

│ ├── api // 所有请求

│ ├── assets // 主题 字体等静态资源

│ ├── components // 全局公用组件

│ ├── directive // 全局指令

│ ├── layout // 布局

│ ├── router // 路由

│ ├── store // 全局 store管理

│ ├── utils // 全局公用方法

│ ├── views // view

│ ├── App.vue // 入口页面

│ ├── main.js // 入口 加载组件 初始化等

│ ├── permission.js // 权限管理

│ └── settings.js // 系统配置

├── .editorconfig // 编码格式

├── .env.development // 开发环境配置

├── .env.production // 生产环境配置

├── .env.staging // 测试环境配置

├── .eslintignore // 忽略语法检查

├── .eslintrc.js // eslint 配置项

├── .gitignore // git 忽略项

├── babel.config.js // babel.config.js

├── package.json // package.json

└── vue.config.js // vue.config.js

——————————————————————————————————————————

原文链接：https://blog.csdn.net/qq_41607217/article/details/118962345

——————————————————————————————————————————

一、index.vue

1. 控件在网页、代码之间的映对

——————————————————————————————————————————

——————————————————————————————————————————

<code><template>

<!-- 2024.05.22 注释:系统管理 - 部门管理 -->

<div class="app-container">code>

<!-- 2024.05.22 注释:搜索功能区 -->

<!-- 在Element UI中，el-form组件是一个表单组件，用于收集用户输入的数据。 -->

<!-- el-form的model属性是一个必需的属性，用于绑定表单中各个表单元素的数据，使表单能够从输入框、下拉框等表单元素中获取数据并进行提交等操作。 -->

<!-- model属性的值通常是一个对象，对象的属性名与表单中各个表单元素的v-model属性相对应 -->

<!-- 下面的代码创建了一个包含2输入框的表单，model对象中的属性分别与这些表单元素的v-model属性相对应 -->

<!-- model属性绑定了一个名为 queryParams 的表单数据对象（其中 queryParams 数据已存于date），对象中有2个属性，分别是 deptName 、 status 。

这2个属性与表单中的2个表单元素的v-model属性相对应。

这样，当用户在表单中输入数据时，数据就会被自动绑定到model对象的属性中，从而方便表单的提交等操作。

需要注意的是，model对象的属性名需要与表单中各个表单元素的v-model属性相对应，并且属性名需要与后端接口所需的参数名相对应，以方便表单数据的提交。

同时，如果表单中有一些需要进行特殊处理的数据，例如需要进行格式化或计算的数据，可以在提交表单前先对这些数据进行处理后再赋值给model对象的属性。 -->

<!-- model="queryParams" 表单数据对象.双向数据绑定，表单命名为 queryParams -->code>

<!-- ref="queryForm" ， Vue 为简化DOM获取方法提出了ref 属性和$refs 对象。一般的操作流程是:ref 绑定控件，$refs 获取控件。 -->code>

<!-- size -->

<!-- :inline="true" 可以让表单域变为行内的表单域。即让该表单不换行，直到挤满该页面，才会换行 -->code>

<!-- v-show指令是根据条件显示DOM元素的指令，可以用来动态控制DOM元素的显示和隐藏。v-show后面跟的是判断条件，不管初始条件是什么，元素总是会被渲染。 -->

<!-- 在 Form 组件中，每一个表单域由一个 Form-Item 组件构成，表单域中可以放置各种类型的表单控件，包括 Input、Select、Checkbox、Radio、Switch、DatePicker、TimePicker -->

<!-- label 标签名 -->

<!-- prop 属性必须与 el-input 中需要校验的表单属性一致,即以第一个input控件为例， el-form-item 中 prop 属性必须与 el-input 中 v-model 的属性保持一致 -->

<!-- v-model="queryParams.deptName" 当前控件绑定的是表单数据对象（ queryParams ）中的（ deptName ） -->code>

<!-- placeholder 文本提示 -->

<!-- clearable 可以清除控件选择内容 -->

<!-- @keyup.enter.native="handleQuery" -->code>

<el-form :model="queryParams" ref="queryForm" size="small" :inline="true" v-show="showSearch">code>

<el-form-item label="部门名称" prop="deptName">code>

<el-input

v-model="queryParams.deptName"code>

placeholder="请输入部门名称"code>

clearable

@keyup.enter.native="handleQuery"code>

/>

</el-form-item>

<!-- v-for 是 vue 的循环指令，作用是遍历数组（对象）的每一个值 -->

<!-- dict.type.sys_normal_disable ，字典类型（ sys_normal_disable ），该字典包含“正常，停止”两种状态 -->

<!-- :key ,相当于身份令牌，唯一的，防止出错，虽然没有也行，但是官网推荐还是加上为好。

key是为了给 Vue 一个提示，以便它能跟踪每个节点的身份，从而重用和重新排序现有元素，你需要为每项提供一个唯一 key 属性;

个人理解:key对应"字典管理"-"字典类型"(字典数据)中的字典编码.

:label,字典标签,:value,字典对应的值传给 v-model 绑定的值( queryParams.status )-->

<el-form-item label="状态" prop="status">code>

<el-select v-model="queryParams.status" placeholder="部门状态" clearable>code>

<el-option

v-for="dict in dict.type.sys_normal_disable"code>

:key="dict.value"code>

:label="dict.label"code>

:value="dict.value"code>

/>

</el-select>

</el-form-item>

<el-form-item>

<el-button type="primary" icon="el-icon-search" size="mini" @click="handleQuery">搜索</el-button>code>

<el-button icon="el-icon-refresh" size="mini" @click="resetQuery">重置</el-button>code>

</el-form-item>

</el-form>

<!-- 2024.05.22 注释:按钮功能区 -->

<!-- v-hasPermi : 权限控制,下述意为支持增加,对应后端 @PreAuthorize("@ss.hasPermi('system:dept:add')") -->

<!-- <el-row>标签的:gutter属性，注意默认间隔为0。 -->

<el-row :gutter="10" class="mb8">code>

<el-col :span="1.5">code>

<el-button

type="primary"code>

plain

icon="el-icon-plus"code>

size="mini"code>

@click="handleAdd"code>

v-hasPermi="['system:dept:add']"code>

>新增</el-button>

</el-col>

<el-col :span="1.5">code>

<el-button

type="info"code>

plain

icon="el-icon-sort"code>

size="mini"code>

@click="toggleExpandAll"code>

>展开/折叠</el-button>

</el-col>

<right-toolbar :showSearch.sync="showSearch" @queryTable="getList"></right-toolbar>code>

</el-row>

<!-- 2024.05.22 注释:表格表头 -->

<!-- 使用 v-loading 在接口未请求到数据之前，显示加载中，直到请求到数据后消失。 -->

<!-- row-key为父级数据的标识id -->

<!-- default-expand-all这个属性只在列表第一次加载时生效 无法动态绑定 -->

<!-- 分别通过default-expanded-keys和default-checked-keys设置默认展开和默认选中的节点 -->

<!-- :default-expand-all="iscloseall" -->code>

<!-- :default-expand-all="isExpandAll" -->code>

<!-- :header-cell-style 表头样式设置 ,也可以结合回调方法进行设置-->

<!-- :cell-style 单元格样式设置 ,也可以结合回调方法进行设置-->

<!-- parseTime : 使用parseTime 格式化时间 -->

<!-- 在 vue 中父组件通过 slot 传入子组件时，父组件中的 slot 里的内容只能访问父组件作用域里的数据（父级模板里的所有内容都是在父级作用域中编译的；

子模板里的所有内容都是在子作用域中编译的），但是此时如果我们又想访问子组件中的数据怎么办呢？这就要用到 slot-scope 这个家伙了。

element-ui 中的 table 组件，在渲染表格行时我们经常需要用到 slot-scope 来获取当前行的数据， -->

<!-- 通过 { } 去解构数据 -->

<!-- "创建时间"处使用slot就是为了格式化时间再输出显示,span就是显示 -->

<el-table

v-if="refreshTable"code>

v-loading="loading"code>

:data="deptList"code>

row-key="deptId"code>

:default-expand-all="isExpandAll"code>

:header-cell-style="{color:'#fff',background:'#333'}"code>

:cell-style="{color:'#000',background:'#FFF'}"code>

:tree-props="{children: 'children', hasChildren: 'hasChildren'}"code>

>

<el-table-column prop="deptName" label="部门名称" width="260"></el-table-column>code>

<el-table-column prop="orderNum" label="排序" width="200"></el-table-column>code>

<el-table-column prop="status" label="状态" width="100">code>

<template slot-scope="scope">code>

<dict-tag :options="dict.type.sys_normal_disable" :value="scope.row.status"/>code>

</template>

</el-table-column>

<el-table-column label="创建时间" align="center" prop="createTime" width="200">code>

<template slot-scope="scope">code>

<span>{ { parseTime(scope.row.createTime) }}</span>

</template>

</el-table-column>

<el-table-column label="操作" align="center" class-name="small-padding fixed-width">code>

<template slot-scope="scope">code>

<el-button

size="mini"code>

type="text"code>

icon="el-icon-edit"code>

@click="handleUpdate(scope.row)"code>

v-hasPermi="['system:dept:edit']"code>

>修改</el-button>

<el-button

size="mini"code>

type="text"code>

icon="el-icon-plus"code>

@click="handleAdd(scope.row)"code>

v-hasPermi="['system:dept:add']"code>

>新增</el-button>

<el-button

v-if="scope.row.parentId != 0"code>

size="mini"code>

type="text"code>

icon="el-icon-delete"code>

@click="handleDelete(scope.row)"code>

v-hasPermi="['system:dept:remove']"code>

>删除</el-button>

</template>

</el-table-column>

</el-table>

<!-- 添加或修改部门对话框 -->

<!-- :visible指的是属性绑定，表示弹框的显示隐藏，当:visible的值为ture的时候，弹框显示，当为false的时候，弹框隐藏

后面的.sync是什么意思呢，指的就是同步动态双向的来表示visible的值，

当我们关闭窗口的时候，这个弹框隐藏了，visible的值发生了变化，但是关闭窗口这个动作，我们没法用确定的动作去判断这个值，所以用到了vue中的双向绑定的原则，

在vue中统一加上了.sync来表示同步的修改了visible的值。 -->

<!-- 在 Vue 项目中使用 Element UI 框架，el-dialog 组件中的 :append-to-body="true" 属性仍然表示将对话框插入到文档的 <body> 元素中。 -->code>

<!-- ref="form":绑定的表单对象为form -->code>

<!-- :model="form":绑定的数据对象为form -->code>

<!-- :rules="rules":表单验证 -->code>

<!-- element的布局方式与bootstrap原理是一样的，将网页划分成若干行，然后每行等分为若干列，基于这样的方式进行布局，形象的成为栅栏布局。

区别是element可将每行划分为24个分栏，而bootstrap是划分为12个分栏，从使用角度，还是24个分栏更加精细。 -->

<!-- 首先每行使用<el-row>标签标识，然后每行内的列使用<el-col>标识，至于每列整行的宽度比例，则使用:span属性进行设置。 -->

<el-dialog :title="title" :visible.sync="open" width="600px" append-to-body>code>

<el-form ref="form" :model="form" :rules="rules" label-width="80px">code>

<el-row>

<el-col :span="24" v-if="form.parentId !== 0">code>

<el-form-item label="上级部门" prop="parentId">code>

<treeselect v-model="form.parentId" :options="deptOptions" :normalizer="normalizer" placeholder="选择上级部门" />code>

</el-form-item>

</el-col>

</el-row>

<el-row>

<el-col :span="12">code>

<el-form-item label="部门名称" prop="deptName">code>

<el-input v-model="form.deptName" placeholder="请输入部门名称" />code>

</el-form-item>

</el-col>

<el-col :span="12">code>

<el-form-item label="显示排序" prop="orderNum">code>

<el-input-number v-model="form.orderNum" controls-position="right" :min="0" />code>

</el-form-item>

</el-col>

</el-row>

<el-row>

<el-col :span="12">code>

<el-form-item label="负责人" prop="leader">code>

<el-input v-model="form.leader" placeholder="请输入负责人" maxlength="20" />code>

</el-form-item>

</el-col>

<el-col :span="12">code>

<el-form-item label="联系电话" prop="phone">code>

<el-input v-model="form.phone" placeholder="请输入联系电话" maxlength="11" />code>

</el-form-item>

</el-col>

</el-row>

<el-row>

<el-col :span="12">code>

<el-form-item label="邮箱" prop="email">code>

<el-input v-model="form.email" placeholder="请输入邮箱" maxlength="50" />code>

</el-form-item>

</el-col>

<el-col :span="12">code>

<el-form-item label="部门状态">code>

<el-radio-group v-model="form.status">code>

<el-radio

v-for="dict in dict.type.sys_normal_disable"code>

:key="dict.value"code>

:label="dict.value"code>

>{ { dict.label}}</el-radio>

</el-radio-group>

</el-form-item>

</el-col>

</el-row>

</el-form>

<div slot="footer" class="dialog-footer">code>

<el-button type="primary" @click="submitForm">确 定</el-button>code>

<el-button @click="cancel">取 消</el-button>code>

</div>

</el-dialog>

</div>

</template>

<script>

import { listDept, getDept, delDept, addDept, updateDept, listDeptExcludeChild } from "@/api/system/dept";

// 2024.05.31 注释：引入注册

// @riophae/vue-treeselect 是一个基于 Vue.js 的树形选择器组件，可以用于选择树形结构的数据

import Treeselect from "@riophae/vue-treeselect";

import "@riophae/vue-treeselect/dist/vue-treeselect.css";

// 2024.05.31 注释

// export主要用于对外输出本模块变量的接口，一个文件就可以被理解为一个模块。export就是导出。

// import就是在一个模块中加载另一个含有export接口的模块， import就是导入。

// export default和export都能导出一个模块里面的常量，函数，文件，模块等，在其它文件或模块中通过import来导入常量，函数，文件或模块。

// 在一个文件或模块中，export,import可以有多个，export default却只能有一个。

// 通过export方式导出，在导入的时候需要加{}大括号，export default 就不需要{}.

export default {

name: "Dept",

// 字典：sys_normal_disable，包括：“正常，停用”两种状态

dicts: ['sys_normal_disable'],

// 组件：下拉树

components: { Treeselect },

// data 必须声明为返回一个初始数据对象的函数，因为组件可能被用来创建多个实例。

// 如果 data 仍然是一个纯粹的对象，则所有的实例将共享引用同一个数据对象！

// 通过提供 data 函数，每次创建一个新实例后，我们能够调用 data函数，从而返回初始数据的一个全新副本数据对象。

// 简言之,组件复用下,不会造成数据同时指向一处,造出牵一发而动全身的问题。

// 不使用return包裹的数据会在项目的全局可见，会造成变量污染；

// 使用return包裹后数据中变量只在当前组件中生效，不会影响其他组件。

data() {

return {

// 遮罩层，遮罩层（Mask）是放置在特定区域上面的一个半透明层，用于阻止用户与该区域的交互，并突出显示上层的内容。遮罩层可以覆盖整个页面，或者只覆盖指定的区域。

loading: true,

// 显示搜索条件

showSearch: true,

// 表格树数据

deptList: [],

// 部门树选项

deptOptions: [],

// 弹出层标题

title: "",

// 是否显示弹出层

open: false,

// 是否展开，默认全部展开

isExpandAll: true,

// 重新渲染表格状态

refreshTable: true,

// 查询参数

queryParams: {

deptName: undefined,

status: undefined

},

// 表单参数

form: { },

// 表单校验

rules: {

parentId: [

{ required: true, message: "上级部门不能为空", trigger: "blur" }

],

deptName: [

{ required: true, message: "部门名称不能为空", trigger: "blur" }

],

orderNum: [

{ required: true, message: "显示排序不能为空", trigger: "blur" }

],

email: [

{

type: "email",

message: "请输入正确的邮箱地址",

trigger: ["blur", "change"]

}

],

phone: [

{

pattern: /^1[3|4|5|6|7|8|9][0-9]\d{ 8}$/,

message: "请输入正确的手机号码",

trigger: "blur"

}

]

}

};

},

created() {

this.getList();

},

methods: {

/** 查询部门列表 */

getList() {

this.loading = true;

listDept(this.queryParams).then(response => {

this.deptList = this.handleTree(response.data, "deptId");

this.loading = false;

});

},

/** 转换部门数据结构 */

normalizer(node) {

if (node.children && !node.children.length) {

delete node.children;

}

return {

id: node.deptId,

label: node.deptName,

children: node.children

};

},

// 取消按钮

cancel() {

this.open = false;

this.reset();

},

// 表单重置

reset() {

this.form = {

deptId: undefined,

parentId: undefined,

deptName: undefined,

orderNum: undefined,

leader: undefined,

phone: undefined,

email: undefined,

status: "0"

};

this.resetForm("form");

},

/** 搜索按钮操作 */

handleQuery() {

this.getList();

},

/** 重置按钮操作 */

resetQuery() {

this.resetForm("queryForm");

this.handleQuery();

},

/** 新增按钮操作 */

handleAdd(row) {

this.reset();

if (row != undefined) {

this.form.parentId = row.deptId;

}

this.open = true;

this.title = "添加部门";

listDept().then(response =>

{

this.deptOptions = this.handleTree(response.data, "deptId");

});

},

/** 展开/折叠操作 */

toggleExpandAll() {

this.refreshTable = false;

this.isExpandAll = !this.isExpandAll;

this.$nextTick(() => {

this.refreshTable = true;

});

},

/** 修改按钮操作 */

handleUpdate(row) {

this.reset();

getDept(row.deptId).then(response => {

this.form = response.data;

this.open = true;

this.title = "修改部门";

listDeptExcludeChild(row.deptId).then(response => {

this.deptOptions = this.handleTree(response.data, "deptId");

if (this.deptOptions.length == 0) {

const noResultsOptions = { deptId: this.form.parentId, deptName: this.form.parentName, children: [] };

this.deptOptions.push(noResultsOptions);

}

});

});

},

/** 提交按钮 */

submitForm: function() {

this.$refs["form"].validate(valid => {

if (valid) {

if (this.form.deptId != undefined) {

updateDept(this.form).then(response => {

this.$modal.msgSuccess("修改成功");

this.open = false;

this.getList();

});

} else {

addDept(this.form).then(response => {

this.$modal.msgSuccess("新增成功");

this.open = false;

this.getList();

});

}

}

});

},

/** 删除按钮操作 */

handleDelete(row)

{

// 2024.05.31 this.$modal.confirm() 就是一个信息提示框

this.$modal.confirm('是否确认删除名称为"' + row.deptName + '"的数据项？').then(function() {

return delDept(row.deptId);

}).then(() => {

this.getList();

this.$modal.msgSuccess("删除成功");

}).catch(() => { });

},

}

};

</script>

1.1.1 控件