vue项目实战经验汇总

1.vue 框架使用注意事项和经验

本文主要总结了在开发 vue 项目中的一些实践经验和踩过的一些坑,后续会接着更新,便于后期复盘,希望也对你有所帮助

1.1 解决 Vue 动态路由参数变化, 页面数据不更新

问题描述:

遇到动态路由如:/page/:id
从 /page/1 切换到 /page/2 发现页面组件没有更新

解决方式:
给增加一个不同:key 值,这样 vue 就会识别这是不同的了。

<router-view :key="key"></router-view>
  ...
  computed:{
	    key(){
	        return this.$route.path + Math.random();
	    }
	}

1.2 vue 组件里定时器销毁问题

问题描述:
在 a 页面写一个定时器,每秒钟打印一次,然后跳转到 b 页面,此时可以看到,定时器依然在执行。
推荐的解决方式:
通过 $once 这个事件侦听器器在定义完定时器之后的位置来清除定时器。

const timer = setInterval(() => {
	// 定时器操作
}, 1000)

// 通过 $once 来监听定时器,在 beforeDestroy 钩子可以被清除。
this.$once('hook:beforeDestroy', () => {
clearInterval(timer);
})

1.3 vue 实现按需加载组件的两种方式

1. 使用 resolve => require(['./ComponentA'], resolve),方法如下:

const ComponentA = resolve => require(['./ComponentA'], resolve)
  1. 使用 ()=> import(), 具体代码如下:
const ComponentA = () => import('./ComponentA')

1.4 组件之间,父子组件之间的通信方案

组件之间的通信方案:

  • 通过事件总线(bus),即通过发布订阅的方式
  • vuex
  • 父子组件:
  • 父组件通过 prop 向自组件传递数据
  • 子组件绑定自定义事件,通过 this.$emit(event,params) 来调用自定义事件
  • 使用 vue 提供的 $parent/$children & $refs 方法来通信
  • provide/inject
  • 深层次组件间的通信 $attrs, $listeners

实现细节可参考:https://m.jb51.net/article/167304.htm

1.5 vue 中 $event 的用法 -- 获取当前父元素,子元素,兄弟元素

<button @click = “fun($event)”>点击</button>
  ...

methods: {
fun(e) {
// e.target 是你当前点击的元素
// e.currentTarget 是你绑定事件的元素
#获得点击元素的前一个元素
e.currentTarget.previousElementSibling.innerHTML
#获得点击元素的第一个子元素
e.currentTarget.firstElementChild
# 获得点击元素的下一个元素
e.currentTarget.nextElementSibling
# 获得点击元素中 id 为 string 的元素
e.currentTarget.getElementById("string")
# 获得点击元素的 string 属性
e.currentTarget.getAttributeNode('string')
# 获得点击元素的父级元素
e.currentTarget.parentElement
# 获得点击元素的前一个元素的第一个子元素的 HTML 值
e.currentTarget.previousElementSibling.firstElementChild.innerHTML

}
    },

1.6 vue 常用工具函数总结

/*
 日期相关 dateFormater:格式化时间
 timestampToTime
 * */
function dateFormater(formater, t){
   let date = t ? new Date(t) : new Date(),
      Y = date.getFullYear() + '',
      M = date.getMonth() + 1,
      D = date.getDate(),
      H = date.getHours(),
      m = date.getMinutes(),
      s = date.getSeconds();
   return formater.replace(/YYYY|yyyy/g,Y)
      .replace(/YY|yy/g,Y.substr(2,2))
      .replace(/MM/g,(M<10?'0':'') + M)
      .replace(/DD/g,(D<10?'0':'') + D)
      .replace(/HH|hh/g,(H<10?'0':'') + H)
      .replace(/mm/g,(m<10?'0':'') + m)
      .replace(/ss/g,(s<10?'0':'') + s)
}
//  dateFormater('YYYY-MM-DD HH:mm', 1580787420000)//==> "2020-02-04 11:37"
// dateFormater('YYYYMMDDHHmm', new Date()) //==> 201906261830

/*
获取 Url 参数,返回一个对象

  • */
    function GetUrlParam(){
    let url = document.location.toString();
    let arrObj = url.split("?");
    let params = Object.create(null)
    if (arrObj.length > 1){
    arrObj = arrObj[1].split("&");
    arrObj.forEach(item=>{
    item = item.split("=");
    params[item[0]] = item[1]
    })
    }
    return params;
    }
    // ?a=1&b=2&c=3 ==> {a: "1", b: "2", c: "3"}

//toFullScreen:全屏
function toFullScreen(){
let elem = document.body;
elem.webkitRequestFullScreen
? elem.webkitRequestFullScreen()
: elem.mozRequestFullScreen
? elem.mozRequestFullScreen()
: elem.msRequestFullscreen
? elem.msRequestFullscreen()
: elem.requestFullScreen
? elem.requestFullScreen()
: alert("浏览器不支持全屏");
}

//exitFullscreen:退出全屏
function exitFullscreen(){
let elem = parent.document;
elem.webkitCancelFullScreen
? elem.webkitCancelFullScreen()
: elem.mozCancelFullScreen
? elem.mozCancelFullScreen()
: elem.cancelFullScreen
? elem.cancelFullScreen()
: elem.msExitFullscreen
? elem.msExitFullscreen()
: elem.exitFullscreen
? elem.exitFullscreen()
: alert("切换失败, 可尝试 Esc 退出");
}

1.7 axios 二次封装 http 请求

import axios from 'axios'
import router from '@/router'
import {removeSessionStorage} from './storage';
import Vue from 'vue'
import { Message } from 'element-ui' // 引用 element-ui 的加载和消息提示组件
// 请求超时时间配置
axios.defaults.timeout = 30000;
// api 地址配置
axios.defaults.baseURL = "";
// console.log(process.env.VUE_APP_BASE_API)
Vue.prototype.$http = axios
// 在全局请求和响应拦截器中添加请求状态
let loading = null

// 请求拦截器
axios.interceptors.request.use(
config => {
config.headers = {
'Content-Type': 'application/json'
};
// loading = Loading.service({text: '拼命加载中'})
let token = sessionStorage.getItem('-token-');
if (token) {
config.headers['token'] = token;
}
return config
},
error => {
return Promise.reject(error)
}
)

// 响应拦截器
axios.interceptors.response.use(
response => {
if (loading) {
loading.close()
}
//console.log(response)
const code = response.status
if ((code >= 200 && code < 300) || code === 304) {
let errorCode = response.data.errCode;
if(errorCode==='000000'){
return Promise.resolve(response.data)
}else {
if (errorCode === 'SYS0404') {
router.push({
name: 'error',
params: {
isTimeout: false,
path: router.currentRoute.path,
desc: '您请求的资源找不到 (错误码:404)',
},
});
} else if (errorCode === 'SYS0401') {
removeSessionStorage('-token-');
router.replace({
path: '/login',
query: {
redirect: router.currentRoute.fullPath
}
});
}
// Message.error(response.data.message)
return Promise.resolve(response.data)
}
// return Promise.resolve(response.data)
} else {
return Promise.reject(response)
}
},
error => {
if (loading) {
loading.close();
}
console.log(error);
if (error.response) {
switch (error.response.status) {
case 401:
case 403:
// 返回 401 清除 token 信息并跳转到登陆页面
removeSessionStorage('-token-');
router.replace({
path: '/login',
query: {
redirect: router.currentRoute.fullPath
}
});
break;
case 404:
Message.error('网络请求不存在');
console.log('错误码:404 路由跳转 currentRoute %o', router.currentRoute.path);
router.push({
name: 'error',
params: {
isTimeout: false,
path: router.currentRoute.path,
desc: '您请求的资源找不到 (错误码:404)',
},
});
break;
case 502:
router.push({
name: 'error',
params: {
isTimeout: false,
path: router.currentRoute.path,
desc: '网关错误 (错误码:502),请联系系统管理员',
},
});
break;
default:
Message.error(error.response.data.message ||'系统出错,请联系系统管理员(错误码:'+error.response.status+')!');
}
} else {
let controlParam = {
desc: '',
path: router.currentRoute.path,
isTimeout: false,
};
// 请求超时或者网络有问题
if (error.message.includes('timeout')) {
Message.error('请求超时!请检查网络是否正常');
controlParam.desc = '网络断开,请检查您的网络';
controlParam.isTimeout = true;
} else {
Message.error('请求失败,请检查网络是否已连接');
controlParam.desc = '页面加载失败';
}
router.push({
name: 'error',
params: controlParam,
});
}
return Promise.reject(error);
}
);

2.elementui 组件修改经验总结

2.1 element-ui 中步骤条的深度使用

2.1.1element-UI 的操作步骤 steps 每一项添加事件, 比如 click,hover

<el-steps :space="200" :active="1" finish-status="success">
  <el-step @click.native="on_click(1)" title="已完成"></el-step>
  <el-step @click.native="on_click(2)" title="进行中"></el-step>
  <el-step @click.native="on_click(3)" title="步骤 3"></el-step>
</el-steps>

2.1.2 具体业务交互
https://blog.csdn.net/weixin_40098371/article/details/88027949
2.1.3 改变文字方向
http://masterfile.aigcbbs.cn/Flxk_ponnL9-XGVgWC4oN9nMaLT5
变为
img2

调整 css,设置 magin 和 background

.el-step__main {
    white-space: normal;
    text-align: left;
    margin-top: -31px;
    margin-left: 25px;
}

}
i
.el-step__title {
font-size: 16px;
line-height: 38px;
background: #FFF;
width: 50px;
position: relative;
z-index: 1;
}

2.2 v-loading 框中的提示文字换行

http://masterfile.aigcbbs.cn/FqhTNvfq32I8Zn1M0tsyV_SA6oES

2.3 路由菜单项双击控制台报错

// 解决菜单双击报错
const originalPush = VueRouter.prototype.push
VueRouter.prototype.push = function push(location) {
  return originalPush.call(this, location).catch(err => err)
}

3.Vue 项目配置

3.1 Vue-cli3 配置开发、生产和测试环境

  • 创建开发环境变量 .env.development
  • 创建生产环境变量 .env.production
  • 创建测试环境变量 .env.test

image
注意环境变量的前缀必须是 VUE_APP
image
在其他文件中通过 process.env.VUE_APP_BASE_API 来访问,例如在接口文件代码中

import axios from 'axios'
import router from '@/router'
// 请求超时时间配置
axios.defaults.timeout = 30000;
// api 地址配置
axios.defaults.baseURL = "process.env.VUE_APP_BASE_API";

对应的 package.json 配置为

"scripts": {
  "serve": "vue-cli-service serve --mode development",
  "build": "vue-cli-service build --mode production",
  "test": "vue-cli-service build --mode test",
  },

3.2 开发环境中代理的切换配置

为了应对这样的跨域场景,在代码开发时,devServer 要代理到本地后端,测试时,又要去修改代理到测试环境,上线后,调试新问题有可能代理到线上环境

对 vue.config.js 的进行配置

const Timestamp = new Date().getTime();  // 当前时间为了防止打包缓存不刷新,所以给每个 js 文件都加一个时间戳
const proxyTargetMap = {
    prod: 'https://xxx.xxx.com/',
    dev: 'http://192.168.200.230:6379',
    test: 'http://test.xxx.com',
    local: 'http://localhost:8080/'
}
let proxyTarget = proxyTargetMap[process.env.API_TYPE] || proxyTargetMap.local
module.exports = {
    publicPath: process.env.NODE_ENV === 'production' ? '/' : '/',
    outputDir: 'dist',
    assetsDir: 'static',
    lintOnSave: false, // 是否开启 eslint 保存检测
    productionSourceMap: false, // 是否在构建生产包时生成 sourcdeMap
    // 调整内部的 webpack 配置。
    // 查阅 https://github.com/vuejs/vue-docs-zh-cn/blob/master/vue-cli/webpack.md
    chainWebpack: () => { },
    //configureWebpack 这部分打包文件添加时间戳,防止缓存不更新
    configureWebpack: {
        output: { // 输出重构  打包编译后的 文件名称  【模块名称. 版本号. 时间戳】
            filename: `[name].${process.env.VUE_APP_Version}.${Timestamp}.js`,
            chunkFilename: `[name].${process.env.VUE_APP_Version}.${Timestamp}.js`
        },
    },
devServer : {
    <span class="hljs-attr">proxy</span>: {
        <span class="hljs-string">'/api'</span> : {
            <span class="hljs-attr">target</span>: proxyTarget,
            <span class="hljs-attr">changeOrigin</span>: <span class="hljs-literal">true</span>,
            <span class="hljs-attr">pathRewrite</span>: {
                <span class="hljs-string">'^/api'</span> : <span class="hljs-string">''</span>
            }
        }
    }
}

};

对应的 package.json 配置为

"scripts": {
  "serve": "vue-cli-service serve --mode development",
+  "serve:dev": "cross-env API_TYPE=dev vue-cli-service serve --mode development",
+  "serve:test": "cross-env API_TYPE=test vue-cli-service serve --mode development",
  "build": "vue-cli-service build --mode production",
  "test": "vue-cli-service build --mode test",
  },