wenmo8 发布的文章

在我们开发Vue应用的时候,很多时候需要记录一些变量的内容,这些可以用来做界面状态的承载,也可以作为页面间交换数据的处理,处理这些内容可以归为Vuex的状态控制。例如我们往往前端需要访问后端数据,一般是通过封装的Web API调用获取数据,而使用Store模式来处理相关的数据或者状态的变化,而视图View主要就是界面的展示处理。本篇随笔主要介绍如何整合这三者之间的关系,实现数据的获取、处理、展示等逻辑操作。

Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式。它采用集中式存储管理应用的所有组件的状态,并以相应的规则保证状态以一种可预测的方式发生变化。关于Vuex的相关State、Getter、Mutation、Action、Module之间的差异和联系,详细可以参考下:
https://vuex.vuejs.org/zh/

1、前后端的分离和Web API 优先路线设计

Web API 是一种应用接口框架,它能够构建HTTP服务以支撑更广泛的客户端(包括浏览器,手机和平板电脑等移动设备)的框架,
ASP.NET Web API 是一种用于在 .NET Framework/ .net Core 上构建 RESTful 应用程序的理想平台。
在目前发达的应用场景下,我们往往需要接入Winform客户端、APP程序、网站程序、以及目前热火朝天的微信应用等,这些数据应该可以由同一个服务提供,这个就是我们所需要构建的Web API平台。由于Web API层作为一个公共的接口层,我们就很好保证了各个界面应用层的数据一致性。

由于倾向于前后端的完全分离,我们后端就可以完全由Web API统一构建支持,可以采用.net framework或者.net core构建的统一接口平台,可以简单由Asp.net 做的Web API接口平台,也可以基于ABP-aspnetboilerplate(
ABP框架随笔介绍
)框架基础上构建的Web API平台。

这样我们就可以基于这些API接口构建前端多项应用,如包括Web前端、Winform前端、以及对接各种APP等应用。

引入了前后端分离的VUE + Element 的开发方式,那么前后端的边界则非常清晰,前端可以在通过网络获取对应的JSON就可以构建前端的应用了。

在前端处理中,主要就是利用Vuex模式中的Store对象里实现对Action和Mutation的请求处理,获取数据后,实现对State状态中的数据进行更新。如果仅仅是当前页面的数据处理,甚至可以不需要存储State信息,直接获取到返回的数据,直接更新到界面视图上即可。

在开发前期,我们甚至可以不需要和后端发生任何关系,通过Mock数据代替从Web API上请求数据,只要Mock的数据结构和Web API接口返回的JSON一致,我们就可以在后期实现快速的对接,而不影响现有的代码处理方式。

2、Axios网络请求处理

在我们进一步处理前,我们需要知道Vuex里面的一些对象概念和他们之间的关系。

Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式。它采用集中式存储管理应用的所有组件的状态,并以相应的规则保证状态以一种可预测的方式发生变化。关于Vuex的相关State、Getter、Mutation、Action、Module之间的差异和联系,详细可以参考下:
https://vuex.vuejs.org/zh/

在开始发起网络请求之前,我们需要了解axios 这个东西,axios 是一个基于Promise 用于浏览器和 nodejs 的 HTTP 客户端,本质上也是对原生XHR的封装,只不过它是Promise的实现版本,符合最新的ES规范。在这里我们只需要知道它是非常强大的网络请求处理库,且得到广泛应用即可,列举几个代码案例进行了解。

POST请求

axios({
method:
'post',
url:
'/user/12345',
data: {
firstName:
'Fred',
lastName:
'Flintstone'}
})
.then(
function(response) {
console.log(response);
})
.
catch(function(error) {
console.log(error);
});

GET请求

axios
.get(
'http://rap2api.taobao.org/app/mock/23080/resources/search',{
params: {
id:
5}
})
.then(res
=>{
console.log(
'数据是:', res);
})
.
catch((e) =>{
console.log(
'获取数据失败');
});

如果我们要跨域请求数据,在配置文件里设置代理,vue-cli3项目,需要在vue.config.js里面写配置。

可以分别设置请求拦截和响应拦截,在发出请求和响应到达then之前进行判断处理,一般的处理方式就是封装一个类如request类,然后进行对拦截器的统一处理,如在请求前增加一些用户身份信息等。

//create an axios instance
const service =axios.create({
timeout:
5000 //request timeout })//request 请求拦截 service.interceptors.request.use(
config
=>{if(store.getters.token) {
config.headers[
'X-Token'] =getToken()
}
returnconfig
},
error
=>{//do something with request error console.log(error) //for debug returnPromise.reject(error)
}
)

3、Vuex中的API、Store和View的使用

我们再次回到Vuex中的API、Store和View的使用介绍上。

我们来看看API的封装请求调用类的封装,如下所示,我们创建了一些操作数据的API类文件,每个API名称对应一个业务的集中处理,包括特定业务的列表请求、单个请求、增加、删除、修改等等都可以封装在一个API类里面。

我们来看看Product.js的类文件定义如下所示。

这里我用了Request和Axios的操作对比,两者很接近,因为request是对Axios的简单封装,主要就是拦截注入一些登录信息和一些响应的错误处理而已。

import request from '@/utils/request'
import axios from 'axios'

这里的Url里面,通过代理配置的处理,会把对应的iqidi替换为对应外部域名的处理,从而实现对跨域处理请求数据的获取了,我们这里只需要知道,url最终会转换为类似

http://www.iqidi.com/h5/GetProductList 这样实际的地址进行请求的即可,返回是一个JSON数据集合。

由于Vue视图里面的JS处理部分,可以直接引入API进行请求数据,如下所示。

import { GetProductList } from '@/api/product'

然后我们就可以在method方法里面定义一个获取API数据的方法了。

methods: {
getlist(type) {
GetProductList({ type: type }).then(response
=>{
const { data }
=responsethis.productlist =data.listthis.listLoading = false})
}

这种调用是最直接的API调用,没有引入Store模块中封装的Action或者Mutation进行异步或者同步的处理。一般情况下直接使用这种方式比较简洁,因为大多数页面处理或者组件处理,不需要对数据进行全局状态的存储处理,也就是不需要进行全局Store对象的处理了。

如果我们需要在全局存储对应的信息,那么就需要引入Store模块中对API调用的封装了,包括Action或者Mutation的处理。

我们先来定义Store存储类,如下界面所示。

如果我们需要对产品列表等数据进行全局状态的存储,那么我们可以考虑创建一个对应Store目录下的模块,如product.js,来管理Action、Mutation和State等信息。

import { GetProductList, GetProductDetail } from '@/api/product'const state={
productlist: [],
productdetail:
null}
const mutations
={
SET_PRODUCT_LIST: (state, list)
=>{
state.productlist
=list
},
SET_PRODUCT_DETAIL: (state, detail)
=>{
state.productdetail
=detail
}
}

const actions
={//产品列表 getProductList({ commit }, { type }) {
console.log(type);
return new Promise((resolve, reject) =>{
GetProductList({ type: type }).then(response
=>{
const { data }
=response
commit(
'SET_PRODUCT_LIST', data)
resolve(data)
}).
catch(error =>{
reject(error)
})
})
},
//获取产品明细 getProductDetail({ commit }, { id }) {return new Promise((resolve, reject) =>{
GetProductDetail({ id: id }).then(response
=>{
const { data }
=response
commit(
'SET_PRODUCT_DETAIL', data)
resolve(data)
}).
catch(error =>{
reject(error)
})
})
}
}

export
default{
namespaced:
true,
state,
mutations,
actions
}

我们下来看看,如果引入了Store模块的业务类,那么在界面视图中调用代码则修改为调用对应的Action或者Mutation了。

methods: {
getlist(type) {
//GetProductList({ type: type }).then(response => { //const { data } = response //this.productlist = data.list //this.listLoading = false //}) this.$store.dispatch('product/getProductList', { type: type }).then(data =>{this.productlist =data.list//this.loading = false }).catch((e) =>{//this.loading = false })
}

我们这里强调一下,一般情况下在视图模块中使用API的类调用即可,不需要累赘的每个业务模块,都创建一个Store的模块类进行相应的管理,只有在这些状态数据需要在多个页面或者组件中需要共享的时候,才考虑引入Store模块类进行细化管理。

我们刚才说到,如果需要创建对应业务模块的Store状态管理模块,那么需要创建对应的模块类,如前面说到的product.js类文件。

其中Modules目录里面的按照业务区分边界的Vuex的Store管理类了,每个对应业务创建一个单独的文件进行管理(如果需要用到的话)。

在index.js里面我们通过模块动态加载的方式,把这些类按照不同的命名空间进行加载进来,统一使用。

import Vue from 'vue'import Vuex from'vuex'import getters from'./getters'Vue.use(Vuex)//https://webpack.js.org/guides/dependency-management/#requirecontext
const modulesFiles = require.context('./modules', true, /\.js$/)//you do not need `import app from './modules/app'`//it will auto require all vuex module from modules file
const modules = modulesFiles.keys().reduce((modules, modulePath) =>{//set './app.js' => 'app'
  const moduleName = modulePath.replace(/^\.\/(.*)\.\w+$/, '$1')
const value
=modulesFiles(modulePath)
modules[moduleName]
= value.default returnmodules
}, {})

const store
= newVuex.Store({
modules,
getters
})

export
default store

为了方便读者理解,我列出一下前面几篇随笔的连接,供参考:

循序渐进VUE+Element 前端应用开发(1)--- 开发环境的准备工作

循序渐进VUE+Element 前端应用开发(2)--- Vuex中的API、Store和View的使用

循序渐进VUE+Element 前端应用开发(3)--- 动态菜单和路由的关联处理

循序渐进VUE+Element 前端应用开发(4)--- 获取后端数据及产品信息页面的处理

循序渐进VUE+Element 前端应用开发(5)--- 表格列表页面的查询,列表展示和字段转义处理


循序渐进VUE+Element 前端应用开发(6)--- 常规Element 界面组件的使用

循序渐进VUE+Element 前端应用开发(7)--- 介绍一些常规的JS处理函数

循序渐进VUE+Element 前端应用开发(8)--- 树列表组件的使用


循序渐进VUE+Element 前端应用开发(9)--- 界面语言国际化的处理

循序渐进VUE+Element 前端应用开发(10)--- 基于vue-echarts处理各种图表展示

循序渐进VUE+Element 前端应用开发(11)--- 图标的维护和使用


循序渐进VUE+Element 前端应用开发(12)--- 整合ABP框架的前端登录处理


循序渐进VUE+Element 前端应用开发(13)--- 前端API接口的封装处理

循序渐进VUE+Element 前端应用开发(14)--- 根据ABP后端接口实现前端界面展示

循序渐进VUE+Element 前端应用开发(15)--- 用户管理模块的处理

循序渐进VUE+Element 前端应用开发(16)--- 组织机构和角色管理模块的处理

循序渐进VUE+Element 前端应用开发(17)--- 菜单管理

循序渐进VUE+Element 前端应用开发(18)--- 功能点管理及权限控制

VUE+Element 前端应用开发框架功能介绍

循序渐进VUE+Element 前端应用开发(19)--- 后端查询接口和Vue前端的整合

使用代码生成工具快速生成基于ABP框架的Vue+Element的前端界面

循序渐进VUE+Element 前端应用开发(20)--- 使用组件封装简化界面代码

循序渐进VUE+Element 前端应用开发(21)--- 省市区县联动处理的组件使用

循序渐进VUE+Element 前端应用开发(22)--- 简化main.js处理代码,抽取过滤器、全局界面函数、组件注册等处理逻辑到不同的文件中

循序渐进VUE+Element 前端应用开发(23)--- 基于ABP实现前后端的附件上传,图片或者附件展示管理

循序渐进VUE+Element 前端应用开发(24)--- 修改密码的前端界面和ABP后端设置处理

循序渐进VUE+Element 前端应用开发(25)--- 各种界面组件的使用(1)

循序渐进VUE+Element 前端应用开发(26)--- 各种界面组件的使用(2)

电商商品数据库的设计和功能界面的处理

循序渐进VUE+Element 前端应用开发(27)--- 数据表的动态表单设计和数据存储

循序渐进VUE+Element 前端应用开发(28)--- 附件内容的管理

循序渐进VUE+Element 前端应用开发(29)--- 高级查询条件的界面设计

部署基于.netcore5.0的ABP框架后台Api服务端,以及使用Nginx部署Vue+Element前端应用

循序渐进VUE+Element 前端应用开发(30)--- ABP后端和Vue+Element前端结合的分页排序处理

循序渐进VUE+Element 前端应用开发(31)--- 系统的日志管理,包括登录日志、接口访问日志、实体变化历史日志

循序渐进VUE+Element 前端应用开发(32)--- 手机短信动态码登陆处理

循序渐进VUE+Element 前端应用开发(33)--- 邮件参数配置和模板邮件发送处理

使用代码生成工具快速开发ABP框架项目

使用Vue-TreeSelect组件实现公司-部门-人员级联下拉列表的处理

使用Vue-TreeSelect组件的时候,用watch变量方式解决弹出编辑对话框界面无法触发更新的问题

在我开发的很多系统里面,包括Winform混合框架、Bootstrap开发框架等系列产品中,我都倾向于动态配置菜单,并管理对应角色的菜单权限和页面权限,实现系统对用户权限的控制,菜单一般包括有名称、图标、顺序、URL连接等相关信息,对于VUE+Element 前端应用来说,应该原理上差不多,本篇随笔介绍结合服务端的动态菜单配置和本地路由的关联处理,实现动态菜单的维护和展示的处理。

1、菜单和路由的处理过程

由于Vue前端还需要引入路由这个概念,路由是我们前端可以访问到的对应路径集合,路由定义了常规菜单说没有的很多复杂信息,但是往往这些是我们不能随意修改的,因此我们做法是以本地配置好的路由列表为基准,而菜单我们采用在后盾配置方式,前端通过接口动态获取菜单列表,通过菜单的名称和路由名称的对应关系,我们以菜单集合为对照,然后过滤本地所有静态路由的列表,然后获得用户可以访问的路由列表,设置动态路由给前端,从而实现了界面根据用户角色/权限的不同,而变化用户的菜单界面和可访问路由集合。

菜单路由处理的大概的操作过程如下所示

前端界面的动态菜单、本地路由、菜单导航和可访问路由的几个概念如下所示。

在前端界面处理中,我们通过Element界面组件的方式展示动态菜单信息,并结合菜单和路由的关系,实现菜单跳转到对应视图的处理过程。

2、菜单和路由列表

根据前面的介绍,我们定义了一些从服务端返回的动态菜单信息,这些菜单信息是一个JSON对象集合,如下界面所示。

[
{
id:
'1',
pid:
'-1',
text:
'首页',
icon:
'dashboard',
name:
'dashboard'},
{
id:
'2',
pid:
'-1',
text:
'产品列表',
icon:
'table',
name:
'product'},
{
id:
'3',
pid:
'-1',
text:
'一级菜单',
icon:
'example',
children: [
{
id:
'3-1',
pid:
'3',
text:
'二级菜单1',
name:
'icon',
icon:
'example'},
{
id:
'3-2',
pid:
'3',
text:
'二级菜单2',
icon:
'tree',
children: [
{
id:
'3-2-1',
pid:
'3-2',
text:
'三级菜单1',
name:
'form',
icon:
'form'},
{
id:
'3-2-2',
pid:
'3-2',
text:
'三级菜单2',
name:
'menu1-1',
icon:
'form'},
{
id:
'3-2-3',
pid:
'3-2',
text:
'三级菜单3',
name:
'menu1-2',
icon:
'form'},
{
id:
'3-2-4',
pid:
'3-2',
text:
'三级菜单4',
name:
'menu1-3',
icon:
'form'}
]
}
]
},
{
id:
'99',
pid:
'-1',
text:
'公司官网',
icon:
'table',
name:
'external-link'}
]

菜单的JSON是根据角色进行动态获取的,不同的角色对应不同的菜单集合,并且菜单是一个多层次的树列表,可以定义无穷多级的展示,JSON格式化视图如下所示。

而Vue前端需要初始化定义前端页面的所有路由,这些包括路由页面的Layout等信息。

我们可以在一个JS文件里面定义好对应前端所有的路由信息,如下所示

//定义本系统的所有路由,具体路由呈现经过菜单数据过滤
export const asyncRoutes ={'dashboard': {
path:
'/dashboard',
component: Layout,
children: [{
path:
'dashboard',
name:
'dashboard',
component: ()
=> import('@/views/dashboard/index')
}]
},
'product': {
path:
'/product',
component: Layout,
children: [{
path:
'/product',
name:
'product',
component: ()
=> import('@/views/Product/index')
}]
},

..............................
//省略部分 'icon': {
path:
'/icon',
component: Layout,
children: [{
path:
'/icon',
name:
'icon',
component: ()
=> import('@/views/icons/index')
}]
},
'external-link': {
path:
'http://www.iqidi.com',
name:
'external-link'}
}

这里的路由不需要嵌套,因为菜单展示才需要定义嵌套关系。

另外,由于系统在未登录请求后端动态菜单前,我们系统也需要正常运行起来,那么就需要预设一些基础的路由信息,如登录界面、重定向页面、首页链接等这些路由信息,因此我们可以分开两个路由对象,用来分开管理这些信息。

对路由的管理,一个需要默认创建路由的处理、重置路由的处理,以及动态设置新的路由处理,我们封装几个函数来处理这些操作。

const createRouter = () => newRouter({//mode: 'history', // require service support
  scrollBehavior: () => ({ y: 0}),
routes: constantRoutes
})

const router
=createRouter()//重置路由 export functionresetRouter() {
const newRouter
=createRouter()
router.matcher
= newRouter.matcher //reset router }

用户在经过登录界面处理后,就会通过对应的Action获取动态路由信息(注意,这里是先获取动态菜单,然后过滤本地路由,即为动态路由信息),获得动态路由后,就设置前端所能访问的路由集合即可,如下代码所示。

有了这些新的路由允许,前端系统的菜单才能够正常运转起来,否则即使界面展示了菜单,也不能访问特定的视图页面而跳到了404页面,因为路由没有。

3、登录的过程处理

前面大概介绍了路由的处理过程,其实我们路由信息,应该需要从登录界面开始讲起。

以登录界面为例,在用户登录处理后,需要先验证用户的账号密码,成功后继续请求该用户对应的动态菜单集合,并通过路由切换到对应的页面或者首页。

在Store/Modules/user.js模块里面,定义了对应的登陆处理Action,如下所示

我们这里忽略用户登录的检验和处理token的过程,主要关注动态菜单请求并设置路由的过程。

在我们需要拦截路由到达前的处理中,我们定义对应的路由信息请求逻辑,如下所示。

router.beforeEach(async(to, from, next) => {

在处理菜单路由的对应模块里面,我们定义了一个状态用来承载这些重要信息,如下定义State所示。

const state ={menuItems:[],
routes: [],
addRoutes: [],
asyncRoutes: asyncRoutes
}
//定义了路由和菜单的Mutation
const mutations ={
SET_ROUTES: (state, routes)
=>{//var list = convertRoute(routes) routes.push({ path: '*', redirect: '/404', hidden: true }) //此为默认错误路由 state.addRoutes=routes
state.routes
= [].concat(routes)//constantRoutes.concat(routes) },
SET_MENUS: (state, menus)
=>{
state.menuItems
=menus
}
}
//定义了生成动态路由的Action处理
const actions ={
generateRoutes({ commit }, roles) {
return new Promise(resolve =>{
getMenus().then(res
=>{
const menus
= res.data || [] //统一通过接口获取菜单信息 const routes =[]

menus.forEach(item
=>{
filterRoutes(routes, item)
})
console.log(routes)
//打印路由 commit('SET_ROUTES', routes)
commit(
'SET_MENUS', menus)
resolve(routes)
});
})
}
}

最后返回对应的JS定义模块类信息即可。

export default{
namespaced:
true,
state,
mutations,
actions
}

在前端界面处理中,我们通过Element界面组件的方式展示动态菜单信息,并结合菜单和路由的关系,实现菜单跳转到对应视图的处理过程。

我们来看看界面生成的动态菜单效果。

由于菜单动态展示和动态路由配合,因此既能在前端实现动态菜单的展示,又会根据菜单的集合刷新可访问路由,两者结合就可以顺利打开对应的视图页面了。

再来回顾一下,菜单路由处理的大概的操作过程如下所示

为了方便读者理解,我列出一下前面几篇随笔的连接,供参考:

循序渐进VUE+Element 前端应用开发(1)--- 开发环境的准备工作

循序渐进VUE+Element 前端应用开发(2)--- Vuex中的API、Store和View的使用

循序渐进VUE+Element 前端应用开发(3)--- 动态菜单和路由的关联处理

循序渐进VUE+Element 前端应用开发(4)--- 获取后端数据及产品信息页面的处理

循序渐进VUE+Element 前端应用开发(5)--- 表格列表页面的查询,列表展示和字段转义处理


循序渐进VUE+Element 前端应用开发(6)--- 常规Element 界面组件的使用

循序渐进VUE+Element 前端应用开发(7)--- 介绍一些常规的JS处理函数

循序渐进VUE+Element 前端应用开发(8)--- 树列表组件的使用


循序渐进VUE+Element 前端应用开发(9)--- 界面语言国际化的处理

循序渐进VUE+Element 前端应用开发(10)--- 基于vue-echarts处理各种图表展示

循序渐进VUE+Element 前端应用开发(11)--- 图标的维护和使用


循序渐进VUE+Element 前端应用开发(12)--- 整合ABP框架的前端登录处理


循序渐进VUE+Element 前端应用开发(13)--- 前端API接口的封装处理

循序渐进VUE+Element 前端应用开发(14)--- 根据ABP后端接口实现前端界面展示

循序渐进VUE+Element 前端应用开发(15)--- 用户管理模块的处理

循序渐进VUE+Element 前端应用开发(16)--- 组织机构和角色管理模块的处理

循序渐进VUE+Element 前端应用开发(17)--- 菜单管理

循序渐进VUE+Element 前端应用开发(18)--- 功能点管理及权限控制

VUE+Element 前端应用开发框架功能介绍

循序渐进VUE+Element 前端应用开发(19)--- 后端查询接口和Vue前端的整合

使用代码生成工具快速生成基于ABP框架的Vue+Element的前端界面

循序渐进VUE+Element 前端应用开发(20)--- 使用组件封装简化界面代码

循序渐进VUE+Element 前端应用开发(21)--- 省市区县联动处理的组件使用

循序渐进VUE+Element 前端应用开发(22)--- 简化main.js处理代码,抽取过滤器、全局界面函数、组件注册等处理逻辑到不同的文件中

循序渐进VUE+Element 前端应用开发(23)--- 基于ABP实现前后端的附件上传,图片或者附件展示管理

循序渐进VUE+Element 前端应用开发(24)--- 修改密码的前端界面和ABP后端设置处理

循序渐进VUE+Element 前端应用开发(25)--- 各种界面组件的使用(1)

循序渐进VUE+Element 前端应用开发(26)--- 各种界面组件的使用(2)

电商商品数据库的设计和功能界面的处理

循序渐进VUE+Element 前端应用开发(27)--- 数据表的动态表单设计和数据存储

循序渐进VUE+Element 前端应用开发(28)--- 附件内容的管理

循序渐进VUE+Element 前端应用开发(29)--- 高级查询条件的界面设计

部署基于.netcore5.0的ABP框架后台Api服务端,以及使用Nginx部署Vue+Element前端应用

循序渐进VUE+Element 前端应用开发(30)--- ABP后端和Vue+Element前端结合的分页排序处理

循序渐进VUE+Element 前端应用开发(31)--- 系统的日志管理,包括登录日志、接口访问日志、实体变化历史日志

循序渐进VUE+Element 前端应用开发(32)--- 手机短信动态码登陆处理

循序渐进VUE+Element 前端应用开发(33)--- 邮件参数配置和模板邮件发送处理

使用代码生成工具快速开发ABP框架项目

使用Vue-TreeSelect组件实现公司-部门-人员级联下拉列表的处理

使用Vue-TreeSelect组件的时候,用watch变量方式解决弹出编辑对话框界面无法触发更新的问题

在前面随笔《
循序渐进VUE+Element 前端应用开发(3)--- 动态菜单和路由的关联处理
》中介绍了在Vue + Element整合框架中,实现了动态菜单和动态路由的处理,从而可以根据用户角色对应的菜单实现本地路由的过滤和绑定,菜单顺利弄好了,就需要进一步开发页面功能了,本篇随笔介绍一个案例,通过获取后端数据后,进行产品信息页面的处理。

1、后端数据的获取处理

前面随笔,我们介绍过了Vue + Element的前端框架中,主要通过后端获取数据,并呈现在界面视图或者组件上的。

前后端的边界则非常清晰,前端可以在通过网络获取对应的JSON就可以构建前端的应用了。

我们通过Vue.config.js的配置信息,可以指定Proxy来处理是本地Mock数据还是实际的后端数据,如下所示。

我们要跨域请求数据,在配置文件里设置代理,vue-cli3项目,需要在vue.config.js里面写配置。

我们创建了一些操作数据的API类文件,每个API名称对应一个业务的集中处理,包括特定业务的列表请求、单个请求、增加、删除、修改等等都可以封装在一个API类里面。

然后在对应的业务API访问类,如product.js 里面定义我们的请求逻辑,主要就是利用简单封装axios的request辅助类来实现数据的请求。

下一步就是在src/views/product目录里面定义我们的视图文件,这个也就是页面文件,其中包含了常规VUE的几个部分,包括

<template>
  
</template>

<script>exportdefault{

}
</script> <style> </style>

其中在<template>里面的是界面元素部分,可以添加我们相关的界面组件等内容,如element的界面组件在里面。

其中<script>是vue脚本交互的部分了,这里面封装我们很多处理逻辑和对应的modal对象信息,在调用API类进行访问数据前,我们往往需要引入对应的API类文件,如下所示。

import { GetTopBanners, GetProductList } from '@/api/product'

其中<style>则定义相关的样式。

在开始介绍Vue 的Script部分,我们认为你已经对VUE的script相关内容,以及它的生命周期有所了解了,script部分的内容包括有。

<script>exportdefault{data() {return{};
},
methods: {
//组件的方法 },
watch: {
//watch擅长处理的场景:一个数据影响多个数据 },
computed: {
//computed擅长处理的场景:一个数据受多个数据影响 },
beforeCreate:
function() {//在实例初始化之后,数据观测(data observer) 和 event/watcher 事件配置之前被调用。 },
created:
function() {//实例已经创建完成之后被调用。在这一步,实例已完成以下的配置:数据观测(data observer),属性和方法的运算, watch/event 事件回调。然而,挂载阶段还没开始,$el 属性目前不可见。 },
beforeMount:
function() {//在挂载开始之前被调用:相关的 render 函数首次被调用。 },
mounted:
function() {//编译好的HTML挂载到页面完成后执行的事件钩子 //el 被新创建的 vm.$el 替换,并挂载到实例上去之后调用该钩子。 //此钩子函数中一般会做一些ajax请求获取数据进行数据初始化 console.log("Home done");
},
beforeUpdate:
function() {//数据更新时调用,发生在虚拟 DOM 重新渲染和打补丁之前。 你可以在这个钩子中进一步地更改状态,这不会触发附加的重渲染过程。 },
updated:
function() {//由于数据更改导致的虚拟 DOM 重新渲染和打补丁,在这之后会调用该钩子。 //当这个钩子被调用时,组件 DOM 已经更新,所以你现在可以执行依赖于 DOM 的操作。然而在大多数情况下,你应该避免在此期间更改状态,因为这可能会导致更新无限循环。 //该钩子在服务器端渲染期间不被调用。 },
beforeDestroy:
function() {//实例销毁之前调用。在这一步,实例仍然完全可用。 },
destroyed:
function() {//Vue 实例销毁后调用。调用后,Vue 实例指示的所有东西都会解绑定,所有的事件监听器会被移除,所有的子实例也会被销毁。 该钩子在服务器端渲染期间不被调用。 }
};
</script>

其中我们主要涉及到内容包括:

data,用于定义整个页面的modal对象或属性,

method,用于定义各种处理方法

computed,用于定义一些计算的树形

created,用于我们在元素创建,但是没有挂载的时候

mounted,完成页面挂载的时候

2、界面展示处理

例如我们要展示一个界面内容,需要展示产品的图片,以及产品信息介绍

那么需要定义相关的数据模板,以及对应的处理方法,在页面加载前实现数据的绑定处理。

export default{
data() {
return{
activeName:
'all',
currentDate:
newDate(),
banners: [],
productlist: [],
pageinfo: {
pageindex:
1,
pagesize:
10,
total:
0},
producttype:
'all'};
},
created() {
this.loadbanners()
this
.getlist()
},

界面部分,我们利用Element的界面组件定义一个走马灯的展示效果,如下所示。

在Template模块里面定义好的界面元素如下所示。

这里面的el-carousel 是Element组件的走马灯,而 v-for="item in banners" 就是vue的处理语法,对data模型里面的数据进行循环处理,然后逐一展示多个图片,从而实现了走马灯的效果展示。

对于列表展示,我们采用了一个卡片的展示内容,以及分页处理的方式实现数据的展示。

分类按钮部分,代码如下所示。

<el-row:gutter="20"style="padding:20px">
  <el-buttontype="primary"icon="el-icon-search":plain="producttype !='all'"@click="handleClick($event, 'all')">全部</el-button>
  <el-buttontype="success"icon="el-icon-search":plain="producttype !='1'"@click="handleClick($event, '1')">框架产品</el-button>
  <el-buttontype="warning"icon="el-icon-search":plain="producttype !='2'"@click="handleClick($event, '2')">软件产品</el-button>
  <el-buttontype="danger"icon="el-icon-search":plain="producttype !='3'"@click="handleClick($event, '3')">开发组件</el-button>
</el-row>

主要就是根据data属性进行一些样式的控制,以及响应对应的click事件。

而每个卡片内容介绍,Demo代码如下所示。

<el-col:span="4"><divclass="grid-content bg-purple" />
<el-cardclass="box-card">
  <imgsrc="https://shadow.elemecdn.com/app/element/hamburger.9cf7b091-55e9-11e9-a976-7f4d0b07eef6.png"class="image">
  <divstyle="padding: 14px;">
    <span>好吃的汉堡</span>
    <divclass="bottom clearfix">
      <timeclass="time">价格:¥200</time>
      <el-buttontype="text"class="button"@click="loadbanners()">操作按钮</el-button>
    </div>
  </div>
</el-card>
</el-col>

但是我们要根据实际获得的动态数据进行绑定,因此需要一个循环来进行处理,类似上面的v-for循环,对产品列表进行展示即可。

<el-colv-for="(item, index) in productlist":key="index":span="4"style="min-width:250px">
<divclass="grid-content bg-purple">
  <el-cardclass="box-card">
    <img:src="item.Picture"class="image"style="width:200px;height:200px">
    <divstyle="padding: 14px;">
      <span>{{ item.ProductName }}</span>
      <divclass="bottom clearfix">
        <!--<time class="time">价格:¥{{ item.Price }}</time>-->
        <el-buttontype="text"class="button">操作按钮</el-button>
      </div>
    </div>
  </el-card>
</div>
</el-col>

为了有效的请求和展示数据,我们还需要利用分页组件来进行数据的分页查询处理,分页组件界面的定义代码如下所示。

    <el-paginationbackground
layout
="prev, pager, next":page-sizes="[10,20,50]":total="pageinfo.total":current-page="pageinfo.pageindex":page-size="pageinfo.pagesize"@size-change="handleSizeChange"@current-change="handleCurrentChange" />

为了实现对数据的分页,我们需要定义当前页码、每页面数据大小、总共数据记录数等几个变量,用来进行分页查询的需要。

我们定义的getList的方法如下所示。

getlist() {//构造分页查询条件
      var param ={
type:
this.producttype === 'all' ? '' : this.producttype,
pageindex:
this.pageinfo.pageindex,
pagesize:
this.pageinfo.pagesize
};
this.listLoading = true //发起数据查询请求,并设置本地Data的值 GetProductList(param).then(data =>{this.productlist =data.listthis.pageinfo.total =data.total_countthis.listLoading = false})
},

另外定义几个方法,对数据进行查询的操作。

    //单击某类别的时候,进行查询
handleClick(e, type) {//console.log(e, type);

      this.producttype =typethis.pageinfo.pageindex = 1;this.getlist()
},
//页面数量改变后查询处理 handleSizeChange(val) {
console.log(`每页 ${val} 条`);
this.pageinfo.pagesize =val;this.getlist()
},
//页码改变后查询处理 handleCurrentChange(val) {
console.log(`当前页: ${val}`);
this.pageinfo.pageindex =val;this.getlist()
}

以上就是我们利用Element的界面组件,以及Vue的方法进行数据的分页查询请求的基础操作,通过这个简单的案例,我们可以了解一些基础的Element 界面组件的使用,以及对Data / Method等内容的了解,并指导如何封装调用跨域的API请求,实现后端数据在界面上的展示处理了。

为了方便读者理解,我列出一下前面几篇随笔的连接,供参考:

循序渐进VUE+Element 前端应用开发(1)--- 开发环境的准备工作

循序渐进VUE+Element 前端应用开发(2)--- Vuex中的API、Store和View的使用

循序渐进VUE+Element 前端应用开发(3)--- 动态菜单和路由的关联处理

循序渐进VUE+Element 前端应用开发(4)--- 获取后端数据及产品信息页面的处理

循序渐进VUE+Element 前端应用开发(5)--- 表格列表页面的查询,列表展示和字段转义处理


循序渐进VUE+Element 前端应用开发(6)--- 常规Element 界面组件的使用

循序渐进VUE+Element 前端应用开发(7)--- 介绍一些常规的JS处理函数

循序渐进VUE+Element 前端应用开发(8)--- 树列表组件的使用


循序渐进VUE+Element 前端应用开发(9)--- 界面语言国际化的处理

循序渐进VUE+Element 前端应用开发(10)--- 基于vue-echarts处理各种图表展示

循序渐进VUE+Element 前端应用开发(11)--- 图标的维护和使用


循序渐进VUE+Element 前端应用开发(12)--- 整合ABP框架的前端登录处理


循序渐进VUE+Element 前端应用开发(13)--- 前端API接口的封装处理

循序渐进VUE+Element 前端应用开发(14)--- 根据ABP后端接口实现前端界面展示

循序渐进VUE+Element 前端应用开发(15)--- 用户管理模块的处理

循序渐进VUE+Element 前端应用开发(16)--- 组织机构和角色管理模块的处理

循序渐进VUE+Element 前端应用开发(17)--- 菜单管理

循序渐进VUE+Element 前端应用开发(18)--- 功能点管理及权限控制

VUE+Element 前端应用开发框架功能介绍

循序渐进VUE+Element 前端应用开发(19)--- 后端查询接口和Vue前端的整合

使用代码生成工具快速生成基于ABP框架的Vue+Element的前端界面

循序渐进VUE+Element 前端应用开发(20)--- 使用组件封装简化界面代码

循序渐进VUE+Element 前端应用开发(21)--- 省市区县联动处理的组件使用

循序渐进VUE+Element 前端应用开发(22)--- 简化main.js处理代码,抽取过滤器、全局界面函数、组件注册等处理逻辑到不同的文件中

循序渐进VUE+Element 前端应用开发(23)--- 基于ABP实现前后端的附件上传,图片或者附件展示管理

循序渐进VUE+Element 前端应用开发(24)--- 修改密码的前端界面和ABP后端设置处理

循序渐进VUE+Element 前端应用开发(25)--- 各种界面组件的使用(1)

循序渐进VUE+Element 前端应用开发(26)--- 各种界面组件的使用(2)

电商商品数据库的设计和功能界面的处理

循序渐进VUE+Element 前端应用开发(27)--- 数据表的动态表单设计和数据存储

循序渐进VUE+Element 前端应用开发(28)--- 附件内容的管理

循序渐进VUE+Element 前端应用开发(29)--- 高级查询条件的界面设计

部署基于.netcore5.0的ABP框架后台Api服务端,以及使用Nginx部署Vue+Element前端应用

循序渐进VUE+Element 前端应用开发(30)--- ABP后端和Vue+Element前端结合的分页排序处理

循序渐进VUE+Element 前端应用开发(31)--- 系统的日志管理,包括登录日志、接口访问日志、实体变化历史日志

循序渐进VUE+Element 前端应用开发(32)--- 手机短信动态码登陆处理

循序渐进VUE+Element 前端应用开发(33)--- 邮件参数配置和模板邮件发送处理

使用代码生成工具快速开发ABP框架项目

使用Vue-TreeSelect组件实现公司-部门-人员级联下拉列表的处理

使用Vue-TreeSelect组件的时候,用watch变量方式解决弹出编辑对话框界面无法触发更新的问题

在我们一般开发的系统界面里面,列表页面是一个非常重要的综合展示界面,包括有条件查询、列表展示和分页处理,以及对每项列表内容可能进行的转义处理,本篇随笔介绍基于Vue +Element基础上实现表格列表页面的查询,列表展示和字段转义处理。

在前面随笔《
循序渐进VUE+Element 前端应用开发(4)--- 获取后端数据及产品信息页面的处理
》介绍了一个对产品列表的卡片式图片分页展示处理,其中涉及到了对于Element 组件分页控件的操作,本篇随笔继续深化这一组件的使用,结合表格展示来处理效果展示。

1、列表查询界面效果

在介绍任何代码处理逻辑之前,我们先来做一个感官的认识,贴上一个效果图,在逐一介绍其中处理的步骤和注意事项。

常规的列表展示界面,一般分为几个区域,一个是查询区域,一个是列表展示区域,一个是底部的分页组件区域。查询区域主要针对常规条件进行布局,以及增加一些全局或者批量的操作,如导入、导出、添加、批量添加、批量删除等按钮;而其中主体的列表展示区域,是相对比较复杂一点的地方,需要对各项数据进行比较友好的展示,可以结合Tag,图标,按钮等界面元素来展示,其中列表一般后面会包括一些对单行记录处理的操作,如查看、编辑、删除的操作,如果是批量删除,可以放到顶部的按钮区域。

2、查询区域的处理

查询区域一般的界面效果如下所示,除了包含一些常用的查询条件,并增加一些常规的处理按钮,如查询、重置、新增、批量删除、导入、导出等按钮。

对于查询区域来说,它也是一个表单的处理,因此也需要添加一一个对应的对象来承载表单的数据,在data里面增加一个searchForm的模型对象,以及一个用于分页查询的pageinfo对象,如下代码所示。

export default{
data() {
return{
listLoading:
true,
pageinfo: {
pageindex:
1,
pagesize:
10,
total:
0},
searchForm: {
ProductNo:
'',
BarCode:
'',
ProductType:
'',
ProductName:
'',
Status:
0},

视图模板代码如下所示

    <el-formref="searchForm":model="searchForm"label-width="80px">
      <el-row>
        <el-col:span="6">
          <el-form-itemlabel="产品编号"prop="ProductNo">
            <el-inputv-model="searchForm.ProductNo" />
          </el-form-item>
        </el-col>
        <el-col:span="6">
          <el-form-itemlabel="产品名称"prop="ProductName">
            <el-inputv-model="searchForm.ProductName" />
          </el-form-item>
        </el-col>
        <el-col:span="6">
          <el-form-itemlabel="商品类型"prop="ProductType">
            <el-selectv-model="searchForm.ProductType"filterable clearable placeholder="请选择">
              <el-optionv-for="(item, key) in typeList":key="key":label="item.value":value="item.key"
              />
            </el-select>
          </el-form-item>
        </el-col>
        <el-col:span="6">
          <el-form-itemlabel="状态"prop="Status">
            <el-selectv-model="searchForm.Status"filterable clearable placeholder="请选择">
              <el-optionv-for="item in Status":key="item.Value":label="item.Text":value="item.Value"
              />
            </el-select>
          </el-form-item>
        </el-col>
      </el-row>
    </el-form>
    <el-rowstyle="float:right;padding-bottom:10px">
      <el-buttonicon="el-icon-search"type="primary"round @click="search()">查询</el-button>
      <el-buttonicon="el-icon-refresh-left"type="warning"round plain @click="resetForm('searchForm')">重置</el-button>
      <el-buttonicon="el-icon-document-add"type="success"round @click="showAdd()">新增</el-button>
      <el-buttonicon="el-icon-document-remove"type="danger"round @click="BatchDelete()">批量删除</el-button>
      <el-buttonicon="el-icon-upload2"type="danger"plain=""round @click="showImport()">导入</el-button>
    </el-row>

其中产品类型的是下拉列表,我们通过在data区域获取一个对象,并在此遍历可以展示字典内容,如果我们花点时间,可以把这些下拉列表统一按照一个常规的处理模式,定义一个字典组件的方式实现,简单赋予一个字典类型的Prop值,就可以绑定下拉列表了,这个稍后在细讲。

在Vue的脚本处理逻辑里面,我们可以在Created声明周期里面,通过API获取数据,绑定在模型上,界面就会自动进行更新了,处理过程代码如下所示。

created() {//获取产品类型,用于绑定字典等用途
    GetProductType().then(data =>{if(data) {
data.forEach(item
=>{this.productTypes.set(item.id, item.name)this.typeList.push({ key: item.id, value: item.name })
})
}
});
//获取列表信息 this.getlist()
},
methods: {
getlist() {
//构造常规的分页查询条件 var param ={
type:
this.producttype === 'all' ? '' : this.producttype,
pageindex:
this.pageinfo.pageindex,
pagesize:
this.pageinfo.pagesize
};
//把SearchForm的条件加入到param里面,进行提交查询 param.type = this.searchForm.ProductType //转换为对应属性 Object.assign(param, this.searchForm);//获取产品列表,绑定到模型上,并修改分页数量 this.listLoading = trueGetProductList(param).then(data=>{this.productlist =data.listthis.pageinfo.total =data.total_countthis.listLoading = false})
},

其中 Object.assign(param, this.searchForm); 语句处理,是把获得的查询条件,覆盖原来对象里面的属性,从而实现查询条件的变量赋值。

获得列表数据,就是介绍如何展示表格列表数据的过程了,表格界面效果如下所示。

先定义一个表格头部,类似HTML里面的<table>的标签,指定样式和一些常规的操作函数,如下代码所示。

    <el-tablev-loading="listLoading":data="productlist"border
fit
stripe
highlight-current-row
:header-cell-style
="{background:'#eef1f6',color:'#606266'}"@selection-change="selectionChange"@row-dblclick="rowDbclick" >

具体的属性可以参考下Element组件关于表格控件的属性了,在表格列里面,我们主要关注它的data绑定即可。

接着定义一列复选框选择的列,用于批量处理的勾选,如批量删除操作。

  <el-table-columntype="selection"width="55"/>

接着就是根据返回JSON属性,逐一进行内容转换为表格列的展示过程了,如下所示。

  <el-table-columnlabel="商品编号"width="80">
    <templateslot-scope="scope">{{ scope.row.ProductNo }}</template>
  </el-table-column>

我们如果需要在显示里面增加处理效果,一般在template里面修改展示效果即可,如下是单位的处理,增加一个tag标志强调下。

  <el-table-columnalign="center"label="单位"width="80">
    <templateslot-scope="scope">
      <el-tagtype=""effect="plain"> {{ scope.row.Unit }}</el-tag>
    </template>
  </el-table-column>

而对于一些需要判断处理的效果,我们可以对内容进行判断输出,如下状态所示。

  <el-table-columnlabel="状态"width="80">
    <templateslot-scope="scope">
      <el-tagv-if="scope.row.Status==0"type=""effect="dark">正常</el-tag>
      <el-tagv-else-if="scope.row.Status==1"type="success"effect="dark">推荐</el-tag>
      <el-tagv-else-if="scope.row.Status==2"type="danger"effect="dark">停用</el-tag>
    </template>
  </el-table-column>

另外,对于一些常见的日期处理,我们可以使用Formatter,Filter等手段进行内容的转义处理,可以去掉后面的时间部分。

<el-table-columnalign="center"label="创建日期"width="120"prop="CreateTime":formatter="dateFormat" />

dataFormat就是一个转义函数,函数代码如下所示。

dateFormat(row, column, cellValue) {return cellValue ? fecha.format(new Date(cellValue), 'yyyy-MM-dd') : ''},

使用的时候,需要在顶部引入一个类库即可

import * as fecha from 'element-ui/lib/utils/date'

对于类似需要进行字典转义的操作,我们可以使用Formatter的方式转义,如增加一个函数来解析对应的值为中文信息

效果可以使用Formatter来转义

productTypeFormat(row, column, cellValue) {var display = this.productTypes.get(cellValue)return display || ''},

也可以使用Filter模式来进行处理。

这里介绍使用Filter的操作处理,首先在界面HTML代码里面增加对应的操作,如下代码所示。

  <el-table-columnalign="center"label="商品类型"width="120"prop="ProductType">
    <templateslot-scope="scope">
      <el-tagtype="danger">  {{ scope.row.ProductType | productTypeFilter }}</el-tag>
    </template>
  </el-table-column>

Filter其实就是一个 | 过滤符号,以及接着一个过滤函数处理即可。

export default{
filters: {
productTypeFilter:
function(value) {if (!value) return '' var display =that.productTypes.get(value)return display || ''}
},

值得注意的是,Filter本身不能引用data里面的属性列表进行转义的需要,如果需要,那么需要在beforeCreate的钩子函数里面记录this的引用,如下代码所示。

对于操作按钮,我们需要增加一行来显示几个按钮即可,如果需要权限控制,可以再根据权限集合判断一下可操作权限即可。

      <el-table-columnlabel="操作"width="140">
        <templatescope="scope">
          <el-row>
            <el-tooltipeffect="light"content="查看"placement="top-start">
              <el-buttonicon="el-icon-search"type="success"circle size="mini"@click="showView(scope.row.ID)" />
            </el-tooltip>
            <el-tooltipeffect="light"content="编辑"placement="top-start">
              <el-buttonicon="el-icon-edit"type="primary"circle size="mini"@click="showEdit(scope.row.ID)" />
            </el-tooltip>
            <el-tooltipeffect="light"content="删除"placement="top-start">
              <el-buttonicon="el-icon-delete"type="danger"circle size="mini"@click="showDelete(scope.row.ID)" />
            </el-tooltip>
          </el-row>
        </template>
      </el-table-column>

这里showView/showEdit/ShowDelete主要就是做一些弹出层前的处理操作,我们在data项里面定义了几个变量,用来确定是那个操作显示的需要。

      isAdd: false,
isEdit:
false,
isView:
false,
isImport:
false,

例如对应编辑操作,我们是需要通过API处理类,获取后端数据,并赋值给编辑框的表单对象上,进行展示即可。

showEdit(id) {//通过ID参数,使用API类获取数据后,赋值给对象展示
      var param ={ id: id }
GetProductDetail(param).then(data
=>{
Object.assign(
this.editForm, data);
})
this.isEdit = true},

对于查看处理,我们除了在每行按钮上可以单击进行查看指定行记录外,我们双击指定的行,也应该弹出对应的查看记录界面

rowDbclick(row, column) {var id =row.IDthis.showView(id);
},

这个就是表格定义里面的一些处理事件

    <el-tablev-loading="listLoading":data="productlist"border
fit
stripe
highlight-current-row
:header-cell-style
="{background:'#eef1f6',color:'#606266'}"@selection-change="selectionChange"@row-dblclick="rowDbclick" >

每个对话框的:visible的属性值,则是确定哪个模态对话框的显示和隐藏。

而对于删除操作,我们只需要确认一下,然后提交远端处理,返回正常结果,就提示用户删除成功即可。如下逻辑代码所示。

showDelete(id) {this.$confirm('您确认删除选定的记录吗?', '操作提示',
{
type:
'warning' //success,error,info,warning //confirmButtonText: '确定', //cancelButtonText: '取消' }
).then(()
=>{//删除操作处理代码 this.$message({
type:
'success',
message:
'删除成功!'});
}).
catch(() =>{this.$message({
type:
'info',
message:
'已取消删除'});
});
},

以上就是常规表格列表页面查询、列表展示、字段转义的一些常规操作,以及对新增、编辑、查看、删除操作的一些常规处理,通过对这些模型的操作,减少了我们以往重新获取对应DOM的繁琐操作,是的数据的操作处理,变得方便了很多。

为了方便读者理解,我列出一下前面几篇随笔的连接,供参考:

循序渐进VUE+Element 前端应用开发(1)--- 开发环境的准备工作

循序渐进VUE+Element 前端应用开发(2)--- Vuex中的API、Store和View的使用

循序渐进VUE+Element 前端应用开发(3)--- 动态菜单和路由的关联处理

循序渐进VUE+Element 前端应用开发(4)--- 获取后端数据及产品信息页面的处理

循序渐进VUE+Element 前端应用开发(5)--- 表格列表页面的查询,列表展示和字段转义处理


循序渐进VUE+Element 前端应用开发(6)--- 常规Element 界面组件的使用

循序渐进VUE+Element 前端应用开发(7)--- 介绍一些常规的JS处理函数

循序渐进VUE+Element 前端应用开发(8)--- 树列表组件的使用


循序渐进VUE+Element 前端应用开发(9)--- 界面语言国际化的处理

循序渐进VUE+Element 前端应用开发(10)--- 基于vue-echarts处理各种图表展示

循序渐进VUE+Element 前端应用开发(11)--- 图标的维护和使用


循序渐进VUE+Element 前端应用开发(12)--- 整合ABP框架的前端登录处理


循序渐进VUE+Element 前端应用开发(13)--- 前端API接口的封装处理

循序渐进VUE+Element 前端应用开发(14)--- 根据ABP后端接口实现前端界面展示

循序渐进VUE+Element 前端应用开发(15)--- 用户管理模块的处理

循序渐进VUE+Element 前端应用开发(16)--- 组织机构和角色管理模块的处理

循序渐进VUE+Element 前端应用开发(17)--- 菜单管理

循序渐进VUE+Element 前端应用开发(18)--- 功能点管理及权限控制

VUE+Element 前端应用开发框架功能介绍

循序渐进VUE+Element 前端应用开发(19)--- 后端查询接口和Vue前端的整合

使用代码生成工具快速生成基于ABP框架的Vue+Element的前端界面

循序渐进VUE+Element 前端应用开发(20)--- 使用组件封装简化界面代码

循序渐进VUE+Element 前端应用开发(21)--- 省市区县联动处理的组件使用

循序渐进VUE+Element 前端应用开发(22)--- 简化main.js处理代码,抽取过滤器、全局界面函数、组件注册等处理逻辑到不同的文件中

循序渐进VUE+Element 前端应用开发(23)--- 基于ABP实现前后端的附件上传,图片或者附件展示管理

循序渐进VUE+Element 前端应用开发(24)--- 修改密码的前端界面和ABP后端设置处理

循序渐进VUE+Element 前端应用开发(25)--- 各种界面组件的使用(1)

循序渐进VUE+Element 前端应用开发(26)--- 各种界面组件的使用(2)

电商商品数据库的设计和功能界面的处理

循序渐进VUE+Element 前端应用开发(27)--- 数据表的动态表单设计和数据存储

循序渐进VUE+Element 前端应用开发(28)--- 附件内容的管理

循序渐进VUE+Element 前端应用开发(29)--- 高级查询条件的界面设计

部署基于.netcore5.0的ABP框架后台Api服务端,以及使用Nginx部署Vue+Element前端应用

循序渐进VUE+Element 前端应用开发(30)--- ABP后端和Vue+Element前端结合的分页排序处理

循序渐进VUE+Element 前端应用开发(31)--- 系统的日志管理,包括登录日志、接口访问日志、实体变化历史日志

循序渐进VUE+Element 前端应用开发(32)--- 手机短信动态码登陆处理

循序渐进VUE+Element 前端应用开发(33)--- 邮件参数配置和模板邮件发送处理

使用代码生成工具快速开发ABP框架项目

使用Vue-TreeSelect组件实现公司-部门-人员级联下拉列表的处理

使用Vue-TreeSelect组件的时候,用watch变量方式解决弹出编辑对话框界面无法触发更新的问题

在我们开发BS页面的时候,往往需要了解常规界面组件的使用,小到最普通的单文本输入框、多文本框、下拉列表,以及按钮、图片展示、弹出对话框、表单处理、条码二维码等等,本篇随笔基于普通表格业务的展示录入的场景介绍这些常规Element组件的使用,使得我们对如何利用Element组件有一个大概的认识。

1、列表界面和其他模块展示处理

在前面随笔《
循序渐进VUE+Element 前端应用开发(5)--- 表格列表页面的查询,列表展示和字段转义处理
》介绍了基于列表展示了相关数据,并在列表界面整合了增删改查等常规的业务操作处理。

常规的列表展示界面,一般分为几个区域,一个是查询区域,一个是列表展示区域,一个是底部的分页组件区域。查询区域主要针对常规条件进行布局,以及增加一些全局或者批量的操作,如导入、导出、添加、批量添加、批量删除等按钮;而其中主体的列表展示区域,是相对比较复杂一点的地方,需要对各项数据进行比较友好的展示,可以结合Tag,图标,按钮等界面元素来展示,其中列表一般后面会包括一些对单行记录处理的操作,如查看、编辑、删除的操作,如果是批量删除,可以放到顶部的按钮区域。

对于常规按钮、表格、分页组件,前面已经做了相关的介绍,这里就不再赘述。

在介绍具体界面组件的时候,我们先来了解下,整体的界面布局,我们把常规的列表界面,新增、编辑、查看、导入等界面放在一起,除了列表页面,其他内容以弹出层对话框的方式进行处理,如下界面示意所示。

每个对话框的:visible的属性值,则是确定哪个模态对话框的显示和隐藏。

在Vue的JS模块里面,我们除了定义对应的对话框显示的变量外,对每个对话框,我们定义一个表单信息用来进行数据的双向绑定处理。

常规的新增、编辑、查看、导入等内容的定义,作为一个对话框组件定义,常规的对话框组件的使用代码如下所示。

<el-dialogtitle="提示":visible.sync="dialogVisible"width="30%":before-close="handleClose">
  <span>这是一段信息</span>
  <spanslot="footer"class="dialog-footer">
    <el-button@click="dialogVisible = false">取 消</el-button>
    <el-buttontype="primary"@click="dialogVisible = false">确 定</el-button>
  </span>
</el-dialog>

为了控制对话框的样式,我们这里注意下footer的slot,这个我们一般是把处理按钮放在这里,如对于查看界面对话框,我们定义如下所示。

一般来说,对于表单内容比较多的场景,我们一般分开多个选项卡进行展示或者录入,这样方便管理,查看界面整体效果如下所示。

对于对话框的数据绑定,我们在打开对话框前,先通过API模块请求获得JSON数据,然后绑定在对应的对话框模型属性上即可,如对于查看界面,我们的处理逻辑如下所示。

showView(id) {var param ={ id: id }
GetProductDetail(param).then(data
=>{
Object.assign(
this.viewForm, data);
})
this.isView = true},

对于表格的双击,我们同样绑定它的查看明细处理操作,如下模板代码和JS代码所示。

模板HTML代码如下:

<el-tablev-loading="listLoading":data="productlist"border
fit
stripe
highlight-current-row
:header-cell-style
="{background:'#eef1f6',color:'#606266'}"@selection-change="selectionChange"@row-dblclick="rowDbclick" >

JS逻辑代码如下

rowDbclick(row, column) {var id =row.IDthis.showView(id);
},

2、常规界面组件的使用

一般情况下,我们使用界面组件的时候,参考下官网《
Element组件使用
》,寻找对应组件的代码进行参考,就差不多了,这里还是就各种常规的Element组件进行大概的介绍吧。

1)表单和表单项、单文本框

对于表单,我们一般定义一个对应的名称,并设置它的data对应的模型名称即可,如下所示。

<el-formref="viewForm":model="viewForm"label-width="80px">

而表单项,一般是定义好表单项的Label即可,然后在其中插入对应的录入控件或者展示控件。如对于单文本组件使用,如下所示。

 <el-form-itemlabel="产品编号">
   <el-inputv-model="editForm.ProductNo" />
 </el-form-item>

其中 v-model="editForm.ProductNo"  就是对应绑定的数据。

而表单项,可以添加对字段的验证处理,在数据提交前,可以校验客户的录入是否有效等。

  <el-form-itemprop="email"label="邮箱":rules="[
{ required: true, message: '请输入邮箱地址', trigger: 'blur' },
{ type: 'email', message: '请输入正确的邮箱地址', trigger: ['blur', 'change'] }
]"
> <el-inputv-model="dynamicValidateForm.email"></el-input> </el-form-item>

注意这里表单项,必须添加一个prop的属性设置,如 prop="email" 所示。

一般为了控制布局,我们还结合el-row进行一个布局的处理,如下代码所示(一行等于span为24,span=12也就是一行放两个控件组)。

<el-row>
  <el-col:span="12">
    <el-form-itemlabel="产品编号">
      <el-inputv-model="editForm.ProductNo" />
    </el-form-item>
  </el-col>
  <el-col:span="12">
    <el-form-itemlabel="条码">
      <el-inputv-model="editForm.BarCode" />
    </el-form-item>
  </el-col>
</el-row>

2)、下拉列表控件的绑定

下拉列表的绑定处理,也是通过 v-model 进行值的绑定,而选项则可以通过数据列表进行绑定。

<el-form-itemlabel="商品类型">
  <el-selectv-model="editForm.ProductType"filterable=""placeholder="请选择">
    <el-optionv-for="(item, key) in typeList":key="key":label="item.value":value="item.key"
    />
  </el-select>
</el-form-item>

而选项中的 typeList,我们可以在页面初始化的时候获取出来即可。

created() {//获取产品类型,用于绑定字典等用途
    GetProductType().then(data =>{if(data) {
data.forEach(item
=>{this.productTypes.set(item.id, item.name)this.typeList.push({ key: item.id, value: item.name })
})
//获取列表信息 this.getlist()
}
});
},

对于textarea常规的多行文本框,其实和普通单行文本框处理差不多,指定它的type="textarea" 和 rows的数值即可。

  <el-tab-panelabel="说明"name="second">
    <el-form-itemlabel="说明">
      <el-inputv-model="editForm.Description"type="textarea":rows="10" />
    </el-form-item>
  </el-tab-pane>

而对于一些可能需要展示HTML内容的,我们可以使用DIV控件来展示,通过v-html标识来处理包含HTML代码的内容。

  <el-tab-panelabel="详细说明">
    <el-form-itemlabel="详细说明">
      <divclass="border-radius"v-html="viewForm.Note" />
    </el-form-item>
  </el-tab-pane>

3)、图片展示

对于一些需要展示服务器图片,我们请求后,根据Element图片组件的设置处理即可,如下包括单个图片和多个图片的展示和预览操作。

图片展示的代码如下所示。

  <el-tab-panelabel="图片信息">
    <el-form-itemlabel="封面图片">
      <el-imagestyle="width: 100px; height: 100px":src="viewForm.Picture":preview-src-list="[viewForm.Picture]"
      />
    </el-form-item>
    <el-form-itemlabel="Banner图片">
      <el-imagestyle="width: 100px; height: 100px":src="viewForm.Banner":preview-src-list="[viewForm.Banner]"
      />
    </el-form-item>
    <el-form-itemlabel="商品展示图片">
      <el-imagev-for="item in viewForm.pics":key="item.key"class="border-radius":src="item.pic"style="width: 100px; height: 100px;padding:10px":preview-src-list="getPreviewPics()"
      />
    </el-form-item>
  </el-tab-pane>

上图中,如果是单个图片,那么预览我们设置一个集合为一个url即可,如 [viewForm.Banner],如果是多个图片,需要通过一个函数来获取图片列表,如 getPreviewPics() 函数所示。

getPreviewPics() {//转换ViewForm.pics里面的pic集合
      var list =[]if (this.viewForm.pics) {this.viewForm.pics.forEach(item =>{if(item.pic) {
list.push(item.pic)
}
})
}
returnlist
}

4)、第三方扩展控件

对于一些需要使用扩展组件的,我们一般搜索下解决方案,通过npm安装对应的组件即可解决,如对于条码和二维码,我使用 @chenfengyuan/vue-barcode和 @chenfengyuan/vue-qrcode,一般在Github上搜索下关键字,总能找到一些很受欢迎的第三方组件。

安装这些组件都有具体的说明,如下所示(
如果卸载,直接修改install为uninstall即可
)。

npm install @chenfengyuan/vue-barcode vue

以及

npm install @chenfengyuan/vue-qrcode vue

条码和二维码的展示效果如下所示

如果全局引入barcode和qrcode 组件,我们在main.js里面引入即可,如下代码所示

//引入barcode,qrcode
import VueBarcode from '@chenfengyuan/vue-barcode';
import VueQrcode from
'@chenfengyuan/vue-qrcode';
Vue.component(VueBarcode.name, VueBarcode);

富文本编辑,我这里采用了 Tinymce 第三方组件来实现编辑处理,展示效果如下所示。

代码如下所示

  <el-tab-panelabel="详细说明"name="third">
    <el-form-itemlabel="详细说明">
      <tinymcev-model="editForm.Note":height="300" />
    </el-form-item>
  </el-tab-pane>

以上就是一些常规的界面组件的使用,后面在继续介绍文件上传和图片结合的操作。

3、自定义组件的创建使用

使用Vue的比以往BS开发的好处,就是可以很容易实现组件化,这点很好,一旦我们定义好一个控件,就可以在多个界面里面进行使用,非常方便,而且封装性可以根据自己的需要进行处理。

查询区域一般的界面效果如下所示,除了包含一些常用的查询条件,一般会有一些下拉列表,这些可能是后台字典里面绑定的内容,可以考虑作为一个通用的字典下拉列表组件来做。

其实界面录入的时候,也往往需要这些条件下拉列表的。

那么我们来定义一个自定义组件,并在界面上使用看看。

在Components目录创建一个目录,并创建一个组件的vue文件,命名为my-dictdata.vue,如下所示。

界面模板代码我们就一个select组件为主即可。

<template>
  <el-selectv-model="svalue"filterable clearable placeholder="请选择">
    <el-optionv-for="(item, index) in dictItems":key="index":label="item.Text":value="item.Value"
    />
  </el-select>
</template>

script脚本逻辑代码如下所示。

<script>
//引入API模块类方法
import { GetDictData } from'@/api/dictdata'exportdefault{
name:
'MyDictdata',//组件的名称 props: {
typeName: {
//字典类型方式,从后端字典接口获取数据 type: String,default:''},
options: {
//固定列表方式,直接绑定 type: Array,default: ()=>{return[] }
}
},
data() {
return{
dictItems: [],
//设置的字典列表 svalue:'' //选中的值 }
},
watch: {
//判断下拉框的值是否有改变 svalue(val, oldVal) {if(val!==oldVal) {this.$emit('input',this.svalue);
}
}
},
mounted() {
varthat= this;if(this.typeName&& this.typeName!== '') {//使用字典类型,从服务器请求数据 GetDictData(this.typeName).then(data=>{if(data) {
data.forEach(item
=>{if(item&& typeof(item.Value)!== 'undefined' &&item.Value!== '') {
that.dictItems.push(item)
}
});
}
})
}
else if(this.options&& this.options.length> 0) {//使用固定字典列表 this.options.forEach(item=>{if(item&& typeof(item.Value)!== 'undefined' &&item.Value!== '') {
that.dictItems.push(item)
}
});
}
//设置默认值 this.svalue= this.value;
},
methods: {

}
}
</script>

主要就是处理字典数据的获取,并绑定到模型对象上即可。

在页面上使用前,需要引入我们定义的组件

import myDictdata from '@/components/Common/my-dictdata'

然后包含进去components里面即可

export default{
components: { myDictdata},

那么原来需要直接使用select组件的代码

<el-selectv-model="searchForm.ProductType"filterable clearable placeholder="请选择">
  <el-optionv-for="(item, key) in typeList":key="key":label="item.value":value="item.key"
  />
</el-select>

则可以精简为一行代码

<my-dictdatav-model="searchForm.ProductType"type-name="商品类型" />

而对于固定列表的,我们也可以通用的处理代码

<my-dictdatav-model="searchForm.Status":options="Status" />

其中Status是定义的一个对象集合

Status: [
{ Text:
'正常', Value: 0},
{ Text:
'推荐', Value: 1},
{ Text:
'停用', Value: 2}
]

是不是非常方便,而得到的效果则不变。

以上就是多个页面内容,通过对话框层模式整合在一起,并介绍如何使用,以及对界面中常见的Element组件进行介绍如何使用,以及定义一个字典列表的主定义组件,用于简化界面代码使用,

为了方便读者理解,我列出一下前面几篇随笔的连接,供参考:

循序渐进VUE+Element 前端应用开发(1)--- 开发环境的准备工作

循序渐进VUE+Element 前端应用开发(2)--- Vuex中的API、Store和View的使用

循序渐进VUE+Element 前端应用开发(3)--- 动态菜单和路由的关联处理

循序渐进VUE+Element 前端应用开发(4)--- 获取后端数据及产品信息页面的处理

循序渐进VUE+Element 前端应用开发(5)--- 表格列表页面的查询,列表展示和字段转义处理


循序渐进VUE+Element 前端应用开发(6)--- 常规Element 界面组件的使用

循序渐进VUE+Element 前端应用开发(7)--- 介绍一些常规的JS处理函数

循序渐进VUE+Element 前端应用开发(8)--- 树列表组件的使用


循序渐进VUE+Element 前端应用开发(9)--- 界面语言国际化的处理

循序渐进VUE+Element 前端应用开发(10)--- 基于vue-echarts处理各种图表展示

循序渐进VUE+Element 前端应用开发(11)--- 图标的维护和使用


循序渐进VUE+Element 前端应用开发(12)--- 整合ABP框架的前端登录处理


循序渐进VUE+Element 前端应用开发(13)--- 前端API接口的封装处理

循序渐进VUE+Element 前端应用开发(14)--- 根据ABP后端接口实现前端界面展示

循序渐进VUE+Element 前端应用开发(15)--- 用户管理模块的处理

循序渐进VUE+Element 前端应用开发(16)--- 组织机构和角色管理模块的处理

循序渐进VUE+Element 前端应用开发(17)--- 菜单管理

循序渐进VUE+Element 前端应用开发(18)--- 功能点管理及权限控制

VUE+Element 前端应用开发框架功能介绍

循序渐进VUE+Element 前端应用开发(19)--- 后端查询接口和Vue前端的整合

使用代码生成工具快速生成基于ABP框架的Vue+Element的前端界面

循序渐进VUE+Element 前端应用开发(20)--- 使用组件封装简化界面代码

循序渐进VUE+Element 前端应用开发(21)--- 省市区县联动处理的组件使用

循序渐进VUE+Element 前端应用开发(22)--- 简化main.js处理代码,抽取过滤器、全局界面函数、组件注册等处理逻辑到不同的文件中

循序渐进VUE+Element 前端应用开发(23)--- 基于ABP实现前后端的附件上传,图片或者附件展示管理

循序渐进VUE+Element 前端应用开发(24)--- 修改密码的前端界面和ABP后端设置处理

循序渐进VUE+Element 前端应用开发(25)--- 各种界面组件的使用(1)

循序渐进VUE+Element 前端应用开发(26)--- 各种界面组件的使用(2)

电商商品数据库的设计和功能界面的处理

循序渐进VUE+Element 前端应用开发(27)--- 数据表的动态表单设计和数据存储

循序渐进VUE+Element 前端应用开发(28)--- 附件内容的管理

循序渐进VUE+Element 前端应用开发(29)--- 高级查询条件的界面设计

部署基于.netcore5.0的ABP框架后台Api服务端,以及使用Nginx部署Vue+Element前端应用

循序渐进VUE+Element 前端应用开发(30)--- ABP后端和Vue+Element前端结合的分页排序处理

循序渐进VUE+Element 前端应用开发(31)--- 系统的日志管理,包括登录日志、接口访问日志、实体变化历史日志

循序渐进VUE+Element 前端应用开发(32)--- 手机短信动态码登陆处理

循序渐进VUE+Element 前端应用开发(33)--- 邮件参数配置和模板邮件发送处理

使用代码生成工具快速开发ABP框架项目

使用Vue-TreeSelect组件实现公司-部门-人员级联下拉列表的处理

使用Vue-TreeSelect组件的时候,用watch变量方式解决弹出编辑对话框界面无法触发更新的问题