新项目每次都需要去配置一个新的开发环境,索性直接搭一个模板,为以后快速开发使用。

项目地址:vue-cli-vant-starter

vue-cli 和 vant 结合的项目开发模板,主要内容如下(后续新增的内容会在其后使用方括号标识添加时间):

  1. axios 或者 $axios 添加到 Vue.prototype ,对 axios 的封装是基于 vue-cli-plugin-axios 插件。

  2. axios 的拦截器进行配置,调用 axios 发送请求的时候自动添加 loading 效果,请求返回的时候,判断请求内容的正确,错误的话直接提示错误信息。

  3. 并发请求时,只有当最后一个请求完成的时候才会关闭 loading 效果。

  4. 添加在路由切换的时候取消上个页面未完成的 axios 请求。

  5. 添加本地代理 http-proxy-middleware 及相应的配置说明。

  6. 增加自定义参数:

    1. showLoading: 是否需要 loading 加载,至于样式仍是有你自由控制。
    2. 关于在短时间内发送多条相同请求处理逻辑的相关字段:
      1. 本插件默认是按照仅保留最初的发送请求链接。
      2. needLast: 需要最新的发送请求链接,以前发送的可以直接 cancel ,这种情况一般适用于搜索框发送请求。
      3. needAll: 所有的发送请求链接都需要
  7. vant 引入组件采用的是自动按需引入插件,均已经配置完善。

  8. Rem 适配,使用以下两个工具:

    1. postcss-pxtorem 是一款 postcss 插件,用于将单位转化为 rem
    2. 设置 rem 基准值可参见 public/index.html 的第 10 ~ 51 行,代码引自 TIM-手机版

模板说明

  1. 本模板暂时的技术栈为: vue + vue-cli + vue-router + vuex + vant + axios + less(如果你使用的是其他的css预编译器请自行配置)

项目使用

  1. 先将本项目 Fork 到你的 github ,方便日后你对其进行修改。
  2. 将你 github 上的远程库克隆到本地。

或者是将本项目克隆到本地,去除远程库,再添加你自己的远程库:

git remote rm origin
git remote add origin <远程库地址>

安装依赖及插件

npm install

启动开发模式(热更新)

npm run serve

生产模式打包

npm run build

更多详细配置

请看 Configuration Reference

如果你使用的是 vue ui ,会发现项目名称可能不是你需要的,这个时候只需要将 package.jsonpackage-lock.json 文件中的 name 修改为你希望的名称,然后重启项目。

Logo

前往低代码交流专区

更多推荐