项目地址:
https://github.com/PanJiaChen/vue-element-admin
在前面两篇文章中已经把基础工作环境构建完成,也已经把后台核心的登录和权限问题完成了,现在手摸手,一起进入实操。
去年十月份开始用 vue 做管理后台的时候毫不犹豫的就选择了 element-ui,那时候 vue2.0 刚发布也没多久,市面上也没有很多其它的 vue2.0 的 ui 框架可供选择。虽然 element-ui 也有很多的不足,前期的bug也不少,但我还是选择了它,简单说一下我选择element-ui的原因吧:
说了这么多优点,作为一个资深element-ui用户还是有些要抱怨的~和react老大哥 Ant Design 相比还是有一定的差距的,不管是组件的丰富性,参数的可配性还是文档的完整性,亦或是UI的交互和美观度。不过 ant 也是经过了近9k次commit的不断打磨,才有了今天。我也相信 element-ui也会越来越好的。
这里还有一些其它的框架(只讨论pc端的框架)大家可以自行选择:
简单列举了一些主流的框架,不得不感慨现在vue的生态圈真是太繁荣了,上述框架楼主并没有深入使用过,不好发表太多建议,大家自行甄别适合自己业务的框架吧。
这里开始我们会开始介绍一些结合Element的开发经验。
有些产品就是这么残忍,能完成需求就不错了,还要让我们做动态换肤。Element官网上也提供了自定义主题的方案 同时也提供了一个在线自定义主题的demo
是不是很酷,作者也说明了实现的方案 地址,大概思路:
我看完觉得真的还是有点复杂的。有没有简单的方案呢? 让我们思考一下,让我们自己写动态换肤该怎么写呢?最常见的方法就是写两套主题,一套叫day theme ,一套叫night theme,night theme主题 都在一个.night-theme的命名空间下,我们动态的在body上add .night-theme , remove .night-theme。这就是最简单的动态换肤。所以我们也能不能顺着这个思路,基于 element-ui 实现动态换肤呢?
首先我们下载官方通过的 Theme generator ,一个专门用来生成Element主题的工具。按照文档,我们生成了需要的主题。
之后就是我们要做的事情了,将这个主题的每个元素外面包裹一个class 来做命名空间。 我们这里用到了gulp-css-wrap这个神器,轻轻松松就完成了我们想要的结果
var path = require('path')var gulp = require('gulp')var cleanCSS = require('gulp-clean-css');var cssWrap = require('gulp-css-wrap');var customThemeName='.custom-theme'gulp.task('css-wrap', function() { return gulp.src( path.resolve('./theme/index.css')) .pipe(cssWrap({selector:customThemeName})) .pipe(cleanCSS()) .pipe(gulp.dest('dist'));});gulp.task('move-font', function() { return gulp.src(['./theme/fonts/**']).pipe(gulp.dest('dist/fonts'));});gulp.task('default',['css-wrap','move-font']);复制代码
这样就得到了一个以.custom-theme为命名空间的自定义主题了,之后我们在项目中引入主题
//main.jsimport 'assets/custom-theme/index.css'复制代码
我们在换肤的地方toggleClass(document.body, 'custom-theme')一直toggle body 的 class就可以了。我们就简单实现了动态换肤效果。
不过这种模式实现换肤也是有一个弊端的,它等于把这两个主题都打包在了项目里,如果你的项目主题需要七八种,这种模式就不适合了。我们就需要动态的加载css,下面就是最简单的动态添加css的例子,当然你可以封装一下,增加成功或者失败回调,判断是否加载过改资源等等就不展开了。
var head = document.getElementsByTagName('HEAD').item(0);var style = document.createElement('link');style.href = 'style.css';style.rel = 'stylesheet';style.type = 'text/css';head.appendChild(style);复制代码
更新(2017.12)
element-ui 官方更新了2.0版本,同时也提供了一个新的换肤思路。 文档
这里又有谈一下导航栏的问题,本项目里的侧边栏是根据 router.js 配置的路由并且根据权限动态生成的,这样就省去了写一遍路由还要手动再写一次侧边栏这种麻烦事,但也遇到了一个问题,路由可能会有多层嵌套,很多人反馈自己的侧边栏会有三级,甚至还有五级的。所以重构了一下侧边栏,使用了递归组件,这样不管你多少级,都能愉快的显示了。代码
侧边栏高亮问题: 很多人在群里问为什么自己的侧边栏不能跟着自己的路由高亮,其实很简单,element-ui官方已经给了default-active所以我们只要
:default-active="$route.path"复制代码
将default-active一直指向当前路由就可以了,就是这么简单。
点击侧边栏 刷新当前路由
在用 spa(单页面开发) 这种开发模式之前,大部分都是多页面后台,用户每次点击侧边栏都会重新请求这个页面,用户渐渐养成了点击侧边栏当前路由来刷新页面的习惯。但现在 spa 就不一样了,用户点击当前高亮的路由并不会刷新view,因为vue-router会拦截你的路由,它判断你的url并没有任何变化,所以它不会触发任何钩子或者是view的变化。issue地址,社区也对该问题展开了激烈讨论。
尤大本来也说要增加一个方法来强刷view,但后来他又改变了心意/(ㄒoㄒ)/~~。但需要就摆在这里,我们该怎么办呢?他说了不改变current URL 就不会触发任何东西,那我可不可以强行触发东西你?上有政策, 下有对策我们变着花来hack。方法也很简单,通过不断改变url的query来触发view的变化。我们监听侧边栏每个link 的 click事件,每次点击都给router push 一个不一样的query 来确保会重新刷新view。
clickLink(path) { this.$router.push({ path, query: { t: +new Date() //保证每次点击路由的query项都是不一样的,确保会重新刷新view } })}复制代码
但这也有一个弊端就是 url 后面有一个很难看的 query 后缀如 xxx.com/article/list?t=1496832345025,但我司用户们表示能接受。。。只能暂时这样hack了,不知道大家有没有更好的方法,学习学习。
经过好几个版本的迭代,element-ui 的table组件已经能满足大部分业务需求了。不过rowSpan colSpan表格行/列合并现在并不是支持(element-ui2.0版本之后开始支持)。官方对此功能的更新情况可以关注这个issue。
这里我着重讲一下table表格几个常用的业务形态。
这里主要是基于Sortable
import Sortable from 'sortablejs'let el = document.querySelectorAll('.el-table__body-wrapper > table > tbody')[0]let sortable = Sortable.create(el)复制代码
在table mounted之后申明Sortable.create(el) table的每行tr就可以随意拖拽了,麻烦的目前我们的排序都是基于dom的,我们的数据层list并没有随之改变。所以我们就要手动的来管理我们的列表。
this.sortable = Sortable.create(el, { onEnd: evt => { //监听end事件 手动维护列表 const tempIndex = this.newList.splice(evt.oldIndex, 1)[0]; this.newList.splice(evt.newIndex, 0, tempIndex); }});复制代码
这样我们就简单的完成了 table 拖拽排序。这里如果不是基于 dom 的排序推荐使用Vue.Draggable。完整代码
table内联编辑也是一个常见的需求。
其实也很简单,当我们拿到 list 数据之后先洗一下数据,每一条数据里面插入一个edit[ true or false ]判断符,来表示当前行是否处于编辑状态。之后就是通过v-show动态切换不同的相应view就可以了。完整代码
{
{ scope.row.title }} 编辑完成复制代码
通过dialog来编辑,新建,删除table的元素这种业务场景相对于前面说的两种更加的常见。而且也有不少的小坑。 首先我们要明确一个点 vue 是一个MVVM框架,我们传统写代码是命令式编程,拿到table这个dom之后就是命令式对dom增删改。而我们现在用声明式编程,只用关注data的变化就好了,所以我们这里的增删改都是基于list这个数组来的。这里我们还要明确一点vue 列表渲染注意事项
由于 JavaScript 的限制, Vue 不能检测以下变动的数组: * 当你利用索引直接设置一个项时,例如: vm.items[indexOfItem] = newValue
所以我们想改变table中第一条数据的值,通过this.list[0]=newValue这样是不会生效的。
解决方案:// Array.prototype.splice`example1.items.splice(indexOfItem, 1, newValue)复制代码
所以我们可以通过
//添加数据this.list.unshift(this.temp);//删除数据 const index = this.list.indexOf(row); //找到要删除数据在list中的位置this.list.splice(index, 1); //通过splice 删除数据//修改数据const index = this.list.indexOf(row); //找到修改的数据在list中的位置this.list.splice(index, 1,this.updatedData); //通过splice 替换数据 触发视图更新复制代码
这样我们就完成了对table的增删改操作,列表view也自动响应发生了变化。这里在修改数据的时候还有一个小坑需要主要。 当我们拿到需要修改行的数据时候不能直接将它直接赋值给dialog,不然会发生下面的问题。
如上图所示,我们在dialog里面改变状态的时候,遮罩下面的table里面该行的状态也在那里跟着一只变化着。原因想必大家都猜到了。赋值的数据是一个objec引用类型共享一个内存区域的。所以我们就不能直接连等复制,需要重新指向一个新的引用,方案如下:
//赋值对象是一个objthis.objData=Object.assign({}, row) //这样就不会共用同一个对象//数组我们也有一个巧妙的防范newArray = oldArray.slice(); //slice会clone返回一个新数组复制代码
tab在后台项目中也比较常用的。假设我们有四个tab选项,每个tab都会向后端请求数据,但我们希望一开始只会请求当前的tab数据,而且tab来回切换的时候不会重复请求,只会实例化一次。首先我们想到的就是用v-if 这样的确能做到一开始不会挂载后面的tab,但有一个问题,每次点击这个tab组件都会重新挂载一次,这是我们不想看到的,这时候我们就可以用到了。
keep-alive 包裹动态组件时,会缓存不活动的组件实例,而不是销毁它们。 它是一个抽象组件:它自身不会渲染一个 DOM 元素,也不会出现在父组件链中。
所以我们就可以这样写tabs了
复制代码
Select 选择器直接使用没有什么太多问题,但很多时候我们需要通过Select来回显一些数据,当我们 select 绑定一个obj value回显就会很蛋蛋了,它要求必须保持同一个引用issue。这就意味着,我们回显数据的时候想先要找到该数据在arr中的位置,再回塞:demo。这还不是在远程搜索的情况下,如果是远程搜索的情况还要当疼。 这里推荐一下vue-multiselect 它能完美的解决前面Element select的问题。目前也是vue component 中比较好用的一个,ui也非常的好看,建议大家可以尝试性用一下,真的非常的不错。
Upload本身没什么好说的,文档写的蛮清楚了。这里主要说一下怎么将Upload组件和七牛直传结合在一起。
这里我们选择api直传的方式,就是我们首先要通过后端(go,node,php都可以)文档生成七牛上传必要的token(上传凭证)和key(资源的最终名称)。 所以现在只要想办法讲token和key塞进post请求里面就可以了,好在官方也提供了这个方法。
。但怎么才能先异步的拿到token再将它塞入请求里呢?
这时候我们又发现了before-upload 这个钩子还支持promise简直合我们的心意。 但我们写着写着怎样才能动态的改变之前的dataObj呢?通过看源码发现我们可以_self._data这样子拿到我们想要的数据。线上代码
将文件拖到此处,或点击上传
复制代码
在使用Element的时候,官方提供了很多可以自己写render function的地方,但由于Element内部都是用jsx 写render function的,所以demo也都是jsx,但很多人自己项目中其实是没有安装的,导致报错。但说真的用createElement裸写render 函数还是有些蛋蛋。我们要用jsx,首先要安装 babel-plugin-transform-vue-jsx 安装方法如下:
npm install babel-plugin-syntax-jsx babel-plugin-transform-vue-jsx babel-helper-vue-jsx-merge-props babel-preset-es2015 --save-dev 复制代码
.babelrc:文件
{ "presets": ["es2015"], "plugins": ["transform-vue-jsx"]}复制代码
这样我们就可以愉快的使用 jsx 写render function了。
**click事件不触发问题:**一直有人在群里问Click Me怎么不触发click事件,虽然element文档还有完善的空间但这种问题大家还真要自己好好认真看一下官方的FAQ了。
官方说明了所有的原生事件必须添加 .native 修饰符。
修改element样式问题: 用ui组件总免不了需要对它做一些个性化定制的需求,所以我们就要覆盖element的一些样式。 首先我们要了解一下vue scoped是什么,很多人非常喜欢用scoped,妈妈再也不用担心样式冲突问题了,其实scoped也没有很神秘的,它就是基于PostCss的,加了一个作用局的概念。
//编译前.example { color: red;}//编译后.example[_v-f3f3eg9] { color: red;}复制代码
它和我们传统的命名空间的方法避免css冲突没有什么本质性的区别。 现在我们来说说怎么覆盖element-ui样式。由于element-ui的样式我们是在全局引入的,所以你想在某个view里面覆盖它的样式就不能加scoped,但你又想只覆盖这个页面的element样式,你就可在它的父级加一个class,以用命名空间来解决问题。
.aritle-page{ //你的命名空间 .el-tag { //element-ui 元素 margin-right: 0px; }}复制代码
建议向楼主一样专门建一个scss文件里专门自定义element-ui的各种样式。线上代码
其它关于element相关的东西真的没有什么好说的了,人家文档和源码就放在那里,有问题就去看文档,再去issue里找找,再去看看源码,大部分问题都能解决了。给一个诀窍其实大部分诡异的问题都可以通过加一个key或者 Vue.nextTick来解决。。
管理后台富文本也是一个非常重要的功能,楼主在这里也踩了不少的坑。楼主在项目里最终选择了 tinymce
这里在简述一下推荐使用tinymce的原因:tinymce 是一家老牌做富文本的公司(这里也推荐 ckeditor,也是一家一直做富文本的公司,新版本很不错),它的产品经受了市场的认可,不管是文档还是配置的自由度都很好。在使用富文本的时候有一点也很关键就是复制格式化,之前在用一款韩国人做的富文本summernote被它的格式化坑的死去活来,但 tinymce 的去格式化相当的好,它还有一个增值项目就是powerpaste,那是无比的强大,支持从word里面复制各种东西,都不会有问题。富文本还有一点也很关键,就是拓展性。楼主用tinymce写了好几个插件,学习成本和容易度都不错,很方便拓展。最后一点就是文档很完善,基本你想得到的配置项,它都有。tinymce也支持按需加载,你可以通过它官方的build页定制自己需要的plugins。 我再来分析一下市面上其它的一些富文本:
楼主列举了很多富文本但并没有列举任何 vue 相关的富文本,主要是因为富文本真的比想象中复杂,在前面的文章里也说过了,其实用 vue 封装组件很方便的,没必要去用人家封装的东西什么vue-quill vue-editor这种都只是简单包了一层,没什么难度的。还不如自己来封装,灵活性可控性更强一点。还有一点基于 vue 真没什么好的富文本,不像 react 有 facebook 出的 draft-js,ory 出的 editor,这种大厂出的产品。
当然你也可以选择一些付费的富文本编辑器,作者自己公司里面有一个项目就使用了 froala-editor 这款编辑器。不管是美观和易用性都是不错的,公司买的是专业版,一年也就 $349 ,价格也是很合理的,但其实省去的程序员开发陈本可能远不止这个价钱。
这里来简单讲一下在自己项目中使用 Tinymce 的方法。
由于目前使用 npm 安装 Tinymce 方法比较负责复杂而且还有一些问题(日后可能会采用该模式)。:space_invader:
目前采用全局引用的方式。代码地址:static/tinymce static目录下的文件不会被打包, 在 index.html 中引入。
使用 由于富文本不适合双向数据流,所以只会 watch 传入富文本的内容一次变化,只会就不会再监听了,如果之后还有改变富文本内容的需求。 可以通过 this.refs.xxx.setContent() 来设置
源码也很简单,有任何别的需求都可以在 @/components/Tinymce/index.vue 中自行修改。
markdown 我们这里选用了 simplemde-markdown-editor ,简单的用vue封装了一下地址,如果需求方能接受 markdown 就一定要用 markdown,坑真心会比富文本少很多。这里我们用markdown做了编辑器,还需要一个能解析的的东西。可以你传给后端让后端帮你转化,也可以前端自己来,这里推荐一个转化库showdown。使用方法:
import('showdown').then(showdown => { //用了 Dynamic import const converter = new showdown.Converter();//初始化 this.html = converter.makeHtml(this.content)//转化})复制代码
用法也很简单两行代码就完成了markdown to html,当然它还有很多个性画的配置,大家有需求自行研究吧。
这里先明确一点,如果你的业务需求对导出文件的格式没有什么要求,不建议导出成xlsx格式的,直接导出成csv的就好了,真的会简单很多。创建一个a标签,写上data:text/csv;charset=utf-8头,再把数据塞进去,encodeURI(csvContent)一下就好了,详情就不展开了,大家可以借鉴这个stackoverflow回答。 我们重点说一下转xlsx,我们这里用到了js-xlsx,一个功能很强大excel处理库,只是下载各种格式excel,还支持读取excel,但上手难度也非常大,相当的复杂,其中涉及不少二进制相关的东西。不过好在官方给了我们一个demo例子,我们写不来还抄不来么,于是我们就借鉴官方的例子来改造了一下,具体原理就不详细说了,真的很复杂。。。 重点是我们怎么使用!首先我们封装一个Export2Excel.js, 它又依赖三个库
require('script-loader!file-saver'); //保存文件用require('script-loader!vendor/Blob'); //转二进制用require('script-loader!xlsx/dist/xlsx.core.min'); //xlsx核心由于这几个文件不支持import引入,所以我们需要`script-loader`来将他们挂载到全局环境下。复制代码
它暴露了两个接口export_table_to_excel和export_json_to_excel,我们常用export_json_to_excel因为更加的可控一点,我们可以自由的洗数据。
handleDownload() { require.ensure([], () => { // 用 webpack Code Splitting xlsl还是很大的 const { export_json_to_excel } = require('vendor/Export2Excel'); const tHeader = ['序号', '文章标题', '作者', '阅读数', '发布时间']; // excel 表格头 const filterVal = ['id', 'title', 'author', 'pageviews', 'display_time']; const list = this.list; const data = this.formatJson(filterVal, list); // 自行洗数据 按序排序的一个array数组 export_json_to_excel(tHeader, data, '列表excel'); })},formatJson(filterVal, jsonData) { return jsonData.map(v => filterVal.map(j => v[j]))}复制代码
管理后台图表也是常见得需求。这里图表就只推荐ECharts,功能齐全,社区demo也丰富gallery。我还是那个观点,大部分插件建议大家还是自己用vue来包装就好了,真的很简单。ECharts支持webpack引入,图省事可以将ECharts整个引入var echarts = require('echarts');不过ECharts还是不小的,我们大部分情况只是用到很少一部分功能,我平时习惯于按需引入的。
// 引入 ECharts 主模块var echarts = require('echarts/lib/echarts');// 引入柱状图require('echarts/lib/chart/bar');// 引入提示框和标题组件require('echarts/lib/component/tooltip');require('echarts/lib/component/title');复制代码
webpack中使用ECharts文档 ECharts按需引入模块文档 接下来我们就要在vue中声明初始化ECharts了。因为ECharts初始化必须绑定dom,所以我们只能在vue的mounted生命周期里初始化。
mounted() { this.initCharts();},methods: { this.initCharts() { this.chart = echarts.init(this.$el); this.setOptions(); }, setOptions() { this.chart.setOption({ title: { text: 'ECharts 入门示例' }, tooltip: {}, xAxis: { data: ["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"] }, yAxis: {}, series: [{ name: '销量', type: 'bar', data: [5, 20, 36, 10, 10, 20] }] }) }}复制代码
就这样简单,ECharts就配置完成了,这时候你想说我的data是远程获取的,或者说我动态改变ECharts的配置该怎么办呢?我们可以通过watch来触发setOptions方法
//第一种 watch options变化 利用vue的深度 watcher,options一有变化就重新setOptionwatch: { options: { handler(options) { this.chart.setOption(this.options) }, deep: true },}//第二种 只watch 数据的变化 只有数据变化时触发EChartswatch: { seriesData(val) { this.setOptions({series:val}) }}复制代码
其实都差不多,还是要结合自己业务来封装。后面就和平时使用ECharts没有什么区别了。题外话ECharts的可配置项真心多,大家使用的时候可能要花一点时间了解它的api的。知乎有个问题:百度还有什么比较良心的产品?答案:ECharts,可见ECharts的强大与好用。
创建与编辑 其实后台创建与编辑功能是最常见的了,它区别去前台项目多了改的需求,但大部分创建页面与编辑页面字段和ui几乎是一样的,所以我们准备公用一个component来对应不同的页面。有两种常见的方法,来区别创建与编辑。
computed: { isEdit() { return this.$route.meta.isEdit // 根据meta判断 // return this.$route.path.indexOf('edit') !== -1 // 根据路由判断 }},created() { if (this.isEdit) { this.fetchData(); }},复制代码
就这样简单的实现了多路由复用了一个component,其实不只是创建和编辑可以这样用,如两个列表的一模一样,只是一个是内部文章另一个是调取外部文章都能复用组件,通过meta的方式来判断调取不同的接口。