首页 > 编程 > JavaScript > 正文

如何基于vue-cli3.0构建功能完善的移动端架子

2019-11-19 11:43:15
字体:
来源:转载
供稿:网友

基于vue-cli3.0构建功能完善的移动端架子,主要功能包括

  • webpack 打包扩展
  • css:sass支持、normalize.css、_mixin.scss、_variables.scss
  • vw、rem布局
  • 跨域设置
  • eslint设置
  • cdn引入
  • 路由设计、登录拦截
  • axios、api 设计
  • vuex状态管理

项目地址: vue-cli3-H5

demo地址: https://zhouyupeng.github.io/vuecli3H5/#/

webpack 打包扩展

vue-cli3.*后目录结构大改,去除了以往的build,config文件夹,要实现配置的改动在根目录下增加vue.config.js进行配置

css:sass支持、normalize.css、_mixin.scss、_variables.scss

使用的css预处理器是sass,对于css mixin,变量这里做了全局引入,并且引入 normalize.css 使HTML元素样式在跨浏览器上表现得的高度一致性

vue.config.js配置

css: {    // 是否使用css分离插件 ExtractTextPlugin    extract: true,    // 开启 CSS source maps?    sourceMap: false,    // css预设器配置项    // 启用 CSS modules for all css / pre-processor files.    modules: false,      sass: {        data: '@import "style/_mixin.scss";@import "style/_variables.scss";' // 全局引入      }    }  }

vw、rem布局

对于移动端适配方案使用的是 网易新闻 的方法,

使用vw + rem布局

/**750px设计稿  取1rem=100px为参照,那么html元素的宽度就可以设置为width: 7.5rem,于是html的font-size=deviceWidth / 7.5**/html {  font-size: 13.33333vw}@media screen and (max-width: 320px) {  html {    font-size: 42.667PX;    font-size: 13.33333vw  }}@media screen and (min-width: 321px) and (max-width:360px) {  html {    font-size: 48PX;    font-size: 13.33333vw  }}@media screen and (min-width: 361px) and (max-width:375px) {  html {    font-size: 50PX;    font-size: 13.33333vw  }}@media screen and (min-width: 376px) and (max-width:393px) {  html {    font-size: 52.4PX;    font-size: 13.33333vw  }}@media screen and (min-width: 394px) and (max-width:412px) {  html {    font-size: 54.93PX;    font-size: 13.33333vw  }}@media screen and (min-width: 413px) and (max-width:414px) {  html {    font-size: 55.2PX;    font-size: 13.33333vw  }}@media screen and (min-width: 415px) and (max-width:480px) {  html {    font-size: 64PX;    font-size: 13.33333vw  }}@media screen and (min-width: 481px) and (max-width:540px) {  html {    font-size: 72PX;    font-size: 13.33333vw  }}@media screen and (min-width: 541px) and (max-width:640px) {  html {    font-size: 85.33PX;    font-size: 13.33333vw  }}@media screen and (min-width: 641px) and (max-width:720px) {  html {    font-size: 96PX;    font-size: 13.33333vw  }}@media screen and (min-width: 721px) and (max-width:768px) {  html {    font-size: 102.4PX;    font-size: 13.33333vw  }}@media screen and (min-width: 769px) {  html {    font-size: 102.4PX;    font-size: 13.33333vw  }}@media screen and (min-width: 769px) {  html {    font-size: 102.4PX;    #app {      margin: 0 auto    }  }

vue.config.js配置

loaderOptions: {  postcss: {    // 这是rem适配的配置    plugins: [      require('postcss-px2rem')({        remUnit: 100      })    ]  }}

开发时跨域设置

devServer: {    open: true, // 启动服务后是否打开浏览器    host: '127.0.0.1',    port: 8088, // 服务端口    https: false,    hotOnly: false,    proxy: 'https://easy-mock.com/' // 设置代理  }

配置完后,本地开发环境的axios的baseUrl要写为 '' ,即空字符串。

发布到线上时如果前端代码不是和后台api放在 同源 下的,后台还需做跨域处理,

eslint standard设置

使用的是 JavaScript standard 代码规范,一个好的编码风格它可以帮助减少团队之间的摩擦,代码阅读起来也更加清爽,更加可读性,不要觉得烦,用了都说好。

这是 JavaScript standard 代码规范的全文

自定义配置,在.eslintrc.js里修改,这里是我给出的配置,4个空格缩进,不检查结尾分号,关闭单var 声明,可自行配置

rules: {  'no-console': process.env.NODE_ENV === 'production' ? 'error' : 'off',  'no-debugger': process.env.NODE_ENV === 'production' ? 'error' : 'off',  indent: [    'error',    4,    {      SwitchCase: 1    }  ],  semi: 0, // 不检查结尾分号,  // 强制使用单引号  quotes: ['error', 'single'],  // 关闭函数名与后面括号间必须空格规则  'space-before-function-paren': 0,  // 关闭var 声明,每个声明占一行规则。  'one-var': 0  }

cdn引入

对于 vue、vue-router、vuex、axios等等这些不经常改动的库、我们让webpack不对他们进行打包,通过cdn引入,可以减少代码的大小、也可以减少服务器的带宽

这里使用的是360的cdn,附上一份公共cdn评测文章 点我

vue.config.js配置

const externals = {  vue: 'Vue',  'vue-router': 'VueRouter',  vuex: 'Vuex',  'mint-ui': 'MINT',  axios: 'axios'}const cdn = {  // 开发环境  dev: {    css: [      'https://lib.baomitu.com/mint-ui/2.2.13/style.min.css'    ],    js: []  },  // 生产环境  build: {    css: [      'https://lib.baomitu.com/mint-ui/2.2.13/style.min.css'    ],    js: [      'https://lib.baomitu.com/vue/2.6.6/vue.min.js',      'https://lib.baomitu.com/vue-router/3.0.1/vue-router.min.js',      'https://lib.baomitu.com/vuex/3.0.1/vuex.min.js',      'https://lib.baomitu.com/axios/0.18.0/axios.min.js',      'https://lib.baomitu.com/mint-ui/2.2.13/index.js'    ]  }}configureWebpack: config => {    if (isProduction) {      // externals里的模块不打包      Object.assign(config, {        externals: externals      })        } else {      // 为开发环境修改配置...    }  },chainWebpack: config => {  // 对vue-cli内部的 webpack 配置进行更细粒度的修改。  // 添加CDN参数到htmlWebpackPlugin配置中, 详见public/index.html 修改  config.plugin('html').tap(args => {    if (process.env.NODE_ENV === 'production') {      args[0].cdn = cdn.build    }    if (process.env.NODE_ENV === 'development') {      args[0].cdn = cdn.dev    }    return args  })}
<!DOCTYPE html><html lang="en"><head>  <meta charset="utf-8" />  <meta http-equiv="X-UA-Compatible" content="IE=edge" />  <!-- DNS预解析 -->  <link rel="dns-prefetch" href="//lib.baomitu.com" />  <meta name="viewport"    content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=0,minimal-ui,viewport-fit=cover" />  <link rel="icon" href="<%= BASE_URL %>favicon.ico" />  <!-- 使用CDN加速的CSS文件,配置在vue.config.js下 -->  <% for (var i in  htmlWebpackPlugin.options.cdn&&htmlWebpackPlugin.options.cdn.css) { %>  <link href="<%= htmlWebpackPlugin.options.cdn.css[i] %>" rel="preload" as="style" />  <link href="<%= htmlWebpackPlugin.options.cdn.css[i] %>" rel="stylesheet" />  <% } %>  <title>vuedemo</title></head><body>  <noscript>    <strong>We're sorry but vuedemo doesn't work properly without JavaScript      enabled. Please enable it to continue.</strong>  </noscript>  <div id="app"></div>  <!-- 使用CDN加速的JS文件,配置在vue.config.js下 -->  <% for (var i in  htmlWebpackPlugin.options.cdn&&htmlWebpackPlugin.options.cdn.js) { %>  <script src="<%= htmlWebpackPlugin.options.cdn.js[i] %>"></script>  <% } %>  <!-- built files will be auto injected --></body></html>

路由设计、登录拦截

const router = new Router({  routes: [    {      path: '/',      name: 'home',      component: Home,      meta: {        auth: false, // 是否需要登录        keepAlive: true // 是否缓存组件      }    },    {      path: '/about',      name: 'about',      component: () =>        import(/* webpackChunkName: "about" */ './views/About.vue'),      meta: {        auth: true,        keepAlive: true      }    },    {      path: '/login',      name: 'login',      component: () =>        import(/* webpackChunkName: "login" */ './views/login.vue'),      meta: {        auth: false,        keepAlive: true      }    },    {      path: '*', // 未匹配到路由时重定向      redirect: '/',      meta: {        // auth: true,        // keepAlive: true      }    }  ]})// 全局路由钩子函数 对全局有效router.beforeEach((to, from, next) => {  let auth = to.meta.auth  let token = store.getters['login/token'];  if (auth) { // 需要登录    if (token) {      next()    } else {      next({        name: 'login',        query: {          redirect: to.path        }      })    }  } else {    next()  }})

在meta中设置是否需要登录以及是否缓存当前组件,

在router.beforeEac路由钩子函数中对登录权限判断,没有登录的跳到登录页面,并且把当前页面传过去,登录后跳回这个页面。

对于页面缓存的在app.vue里进行处理

<keep-alive>  <router-view v-if="$route.meta.keepAlive"></router-view></keep-alive><router-view v-if="!$route.meta.keepAlive"></router-view>

axios、api 设计

对于axios的设计主要是请求拦截器, respone拦截器,以及get,post的二次封装

axios.defaults.timeout = 12000 // 请求超时时间axios.defaults.baseURL = process.env.VUE_APP_BASE_APIaxios.defaults.headers.post['Content-Type'] =  'application/x-www-form-urlencoded;charset=UTF-8' // post请求头的设置// axios 请求拦截器axios.interceptors.request.use(  config => {    // 可在此设置要发送的token    let token = store.getters['login/token'];    token && (config.headers.token = token)    Indicator.open('数据加载中')    return config  },  error => {    return Promise.error(error)  })// axios respone拦截器axios.interceptors.response.use(  response => {    // 如果返回的状态码为200,说明接口请求成功,可以正常拿到数据    // 否则的话抛出错误 结合自身业务和后台返回的接口状态约定写respone拦截器    Indicator.close()    console.log('response', response);    if (response.status === 200 && response.data.code === 0) {      return Promise.resolve(response)    } else {      Toast({        message: response.data.msg,        position: 'middle',        duration: 2000      });      return Promise.reject(response)    }  },  error => {    Indicator.close()    const responseCode = error.response.status    switch (responseCode) {      // 401:未登录      case 401:        break      // 404请求不存在      case 404:        Toast({          message: '网络请求不存在',          position: 'middle',          duration: 2000        });        break      default:        Toast({          message: error.response.data.message,          position: 'middle',          duration: 2000        });    }    return Promise.reject(error)  })/** * 封装get方法,对应get请求 * @param {String} url [请求的url地址] * @param {Object} params [请求时携带的参数] */function get (url, params = {}) {  return new Promise((resolve, reject) => {    axios      .get(url, {        params: params      })      .then(res => {        resolve(res.data)      })      .catch(err => {        reject(err.data)      })  })}/** * post方法,对应post请求 * @param {String} url [请求的url地址] * @param {Object} params [请求时携带的参数] */function post (url, params) {  return new Promise((resolve, reject) => {    axios      .post(url, qs.stringify(params))      .then(res => {        resolve(res.data)      })      .catch(err => {        reject(err.data)      })  })}

为了方便管理api路径,这里把所以请求都放在了api文件夹下,如

import { get, post } from '@/axios/http.js'function getIndex (params) {  return get('/mock/5cb48c7ed491cd741c54456f/base/index', params)}function login(params) {  return post('/mock/5cb48c7ed491cd741c54456f/base/login', params)}export {  getIndex,  login}

其他

去除console.log

装uglifyjs-webpack-plugin插件

 // 上线压缩去除console等信息config.plugins.push(  new UglifyJsPlugin({    uglifyOptions: {      compress: {        warnings: false,        drop_console: true,        drop_debugger: false,        pure_funcs: ['console.log'] // 移除console      }    },    sourceMap: false,    parallel: true  }))

设置alias目录别名

在项目中经常会引用各个地方的文件,配置后可以更加方便的引入了

config.resolve.alias      .set('assets', '@/assets')      .set('components', '@/components')      .set('view', '@/view')      .set('style', '@/style')      .set('api', '@/api')      .set('store', '@/store')

环境变量和模式

在一个产品的前端开发过程中,一般来说会经历本地开发、测试脚本、开发自测、测试环境、预上线环境,然后才能正式的发布。对应每一个环境可能都会有所差异,比如说服务器地址、接口地址、websorket地址…… 等等。在各个环境切换的时候,就需要不同的配置参数,所以就可以用环境变量和模式,来方便我们管理。

.env        # 在所有的环境中被载入.env.local     # 在所有的环境中被载入,但会被 git 忽略.env.[mode]     # 只在指定的模式中被载入.env.[mode].local  # 只在指定的模式中被载入,但会被 git 忽略

自定义的变量VUE_APP_开头,两个特殊的变量:

  • NODE_ENV - 会是 "development"、"production" 或 "test" 中的一个。具体的值取决于应用运行的模式。
  • BASE_URL - 会和 vue.config.js 中的 baseUrl 选项相符,即你的应用会部署到的基础路径。

如我们定义的.env

NODE_ENV = 'development'BASE_URL = '/'VUE_APP_BASE_API = ''

.env.production

NODE_ENV = 'production'BASE_URL = './'VUE_APP_BASE_API = 'https://easy-mock.com/'

在项目中可以用process.env.VUE_APP_*,如process.env.VUE_APP_BASE_API获取到定义的值

全局引入filter

把多个地方用到的过滤器写在一个js里面,复用代码。

// 过滤日期格式,传入时间戳,根据参数返回不同格式const formatTimer = function(val, hours) {  if (val) {    var dateTimer = new Date(val * 1000)    var y = dateTimer.getFullYear()    var M = dateTimer.getMonth() + 1    var d = dateTimer.getDate()    var h = dateTimer.getHours()    var m = dateTimer.getMinutes()    M = M >= 10 ? M : '0' + M    d = d >= 10 ? d : '0' + d    h = h >= 10 ? h : '0' + h    m = m >= 10 ? m : '0' + m    if (hours) {      return y + '-' + M + '-' + d + ' ' + h + ':' + m    } else {      return y + '-' + M + '-' + d    }  }}export default {  formatTimer}

main.js引入

import filters from './filters/index'// 注入全局过滤器Object.keys(filters).forEach(item => {  Vue.filter(item, filters[item])})

使用

{{1555851774 | formatTimer()}}

vue中使用mock.js

查看我以前写的文章点击我

wepback的可视化资源分析工具插件---webpack-bundle-analyzer

用来分析哪些模块引入了哪些代码,进行有目的性的优化代码

在打包环境中加,使用命令npm run build --report

if (process.env.npm_config_report) {  config.plugins.push(new BundleAnalyzerPlugin())}

代码地址 项目地址: vue-cli3-H5

demo地址: https://zhouyupeng.github.io/vuecli3H5/#/

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持武林网。

发表评论 共有条评论
用户名: 密码:
验证码: 匿名发表