在确定了后台系统的详细规划和整体功能以后,花费时间更多的其实是对技术细节的打磨。本主题借鉴我开发个人网站 魚立说 的经验,整理了在开发后台系统过程可能会遇到的各种技术要点。
本文来源:魚立说。本文链接:https://www.yulisay.com/d/endskills.html,支持微信浏览器打开。
更多精彩文章,请移步 魚立说个人网站 翻看。欢迎欣赏,吐槽不足之处。
涉及到的代码已经整理到 https://github.com/yulis-say/web-full-stack 中的 end-skills 目录,若觉得有用,请分享并 star 。
1 后台开发小结
下面对后台系统的开发技术要点依次进行概括,包括必要的说明和资源引导。
1.1 后台系统模板
搭建后台系统,为了省时省力,可以选用一些流行的后台系统模板。关于这部分,可以阅读本站整理的《流行的后台管理系统模板》一文。
考虑到技术的流行性和后台功能的完善,本站使用了基于 Vue.js 和 Element-UI 实现的 vue-admin-template 作为参考,进行了后台系统的搭建和二次开发。
参考 vue-element-admin 后台系统模板,最终的后台系统效果将如图所示:
1.2 vue-admin-template 使用技巧
配置代理请求,解决跨域问题。做如下修改:
修改 .env.development 文件,VUE_APP_BASE_API 表示某个前缀: VUE_APP_BASE_API = '/api' 修改 vue.config.js 文件,当遇到以 VUE_APP_BASE_API 开头的请求时,就会把 target 字段加上: devServer: { …… proxy: { [process.env.VUE_APP_BASE_API]: { target: 'http://api.com',// 你自己的域名 secure: false,// 配置 https 接口 changeOrigin: true,// 是否跨域 pathRewrite: { ['^' + process.env.VUE_APP_BASE_API]: '/api'// 替换配置中的前缀 } } } }
修复 Markdown 排版样式。使用 tui.editor 作为新编辑器,请参考 https://github.com/PanJiaChen/vue-element-admin/commit/3057489cc66e17b97a77512c1e3621b96c37a4ba 修复此 bug。具体修改:
1. 把 package.json 文件中的 "tui-editor" 依赖替换成 "@toast-ui/editor"; 2. 使用参考中的 src/components/MarkdownEditor/index.vue 文件内容替代你本地的文件内容。
去除浏览器控制台输出的 async-validator 验证警告:
将 node_modules/async-validator 目录中的 es/util.js、lib/util.js 两个文件里的 console.warn(type, errors); 注释掉
在编译源码的时候,Eslint 校验失败的时候会进行一些提示:
Strings must use singlequote. 必须使用单引号,不能使用双引号。 Trailing spaces not allowed. 需要删除多余的空格。 Attribute ':sizeOpts' must be hyphenated. 属性有大写,需要使用"-"取代。
1.3 Vue.js 使用技巧
$nextTick() 会在下次 DOM 更新循环结束之后执行延迟回调。在修改数据之后立即使用这个方法,可以获取更新后的 DOM。
handler() 会在被侦听对象的 property 改变时被调用,不论其被嵌套多深。
computed 用来监控自定义变量,可以在页面上进行双向数据绑定展示出结果或作其他处理,比较适合对多个变量或者对象进行处理后返回一个结果值。
报错:Critical dependency: the request of a dependency is an expression. 解决:将 babel-eslint 更换至稳定版本,比如由 "^10.0.3" 更换至 7.2.3。
1.4 Element-UI 使用技巧
el-upload 上传组件,可以使用 http-request 自定义上传方法。如下代码做了简略处理:
<el-upload ref="upload" accept=".jpg, .jpeg, .png, .gif" :http-request="uploadFile" > uploadFile(params) { return new Promise((resolve, reject) => { const formData = new FormData() formData.append('file', file) getImage(formData).then(response => { this.tempUrl = response.data resolve(true) }).catch(() => { reject(false) }) }) }
调整 $confirm 提示框按钮位置。$confirm 提示框的按钮默认顺序是取消、确定,修改代码进行调整:
# CSS 调整 .el-btn-custom-cancel { float: right; margin-left: 10px; } # 设置 $confirm 按钮样式 this.$confirm( …… cancelButtonClass: 'btn-custom-cancel', …… }
报错:Uncaught (in promise) cancel. 因为 this.$msgbox 没有使用 .catch(),无法捕获到取消操作。可以这么写:
this.$msgbox({ …… }).catch(error => error)
2 更多有用的网站
Vue.js :一套用于构建用户界面的渐进式 JavaScript 框架,遵循 MIT 开源协议。网址:https://cn.vuejs.org/。
Element :网站快速成型工具,一套为开发者、设计师和产品经理准备的基于 Vue 2.0 的桌面端组件库。网址:https://element.eleme.cn。
npm :JavaScript 世界的包管理工具,并且是 Node.js 平台的默认包管理工具。通过 npm 可以安装、共享、分发代码,管理项目依赖关系。网址:https://www.npmjs.com/。
Webpack :一个静态模块打包器(module bundler),会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成一个或多个 bundle。网址:https://www.webpackjs.com。
axios :一个基于 promise 的 HTTP 库,可以用在浏览器和 Node.js 中。网址:http://www.axios-js.com/。
3 参考链接
② Markdown components can not preview html content · Issue #3308 · PanJiaChen/vue-element-admin