4

前言

涉及技术:

  • nodejs
  • vue-cli4.x
  • vue

搭建环境

1.安装 nodejs,切换到淘宝镜像

自行百度搜索安装,切换镜像

2.全局安装 vue-cli4.x,如果安装了 2.x 或 3.x 先卸载,在重新安装

查看[官网](https://cli.vuejs.org/zh/guide/installation.html) 
卸载2.x:npm uninstall vue-cli -g
卸载3.x:npm uninstall @vue/cli -g
说明:-g 是全局的意思
安装4.x:npm install -g @vue/cli

3.检测vue-cli版本
命令行输入:

vue --version

创建项目

命令行输入 vue ui,打开 vue-cli 管理界面,选择合适位置,点击创建项目:

image.png

输入项目名,选择合适的包管理器或默认,点击下一步:

image.png

选择默认或手动,这里选择手动,下一步:

image.png

选择需要的依赖,vuex 不太熟,我先不选,其他标红的我都选了,点击下一步:

image.png

修改配置,点击创建项目:

image.png

保存为预设,下次创建可以直接选择预设,或者不保存也可以:

image.png

创建完成后的界面:

image.png

点击任务,点击编译和热更新,点击运行:

image.png

没有错误,点击启动app,可以打开项目,项目创建成功:

image.png

添加 UI 框架

这里使用 vant 框架,详情网址点击这里,停止项目,打开依赖,右上角点击安装依赖:

image.png

搜索vant,安装运行时依赖:

image.png

安装 babel-plugin-import 开发依赖,这个可以自动将 import 语句转换为按需加载:

image.png

修改 bable.config.js 配置,添加如下内容(不知道具体什么意思,大体意思是加载 vant 库吧):

plugins: [
    [
      'import', 
      { libraryName: 'vant', libraryDirectory: 'es', style: true }, 
      'vant'
    ]
]

在页面测试是否起作用,这里使用 About.vue 页面(vue-router自动生成的),使用 vant 的按钮试一试:

image.png

点击 vue-cli 管理界面的任务中的运行,打开项目页面:

image.png

image.png

表示 UI 已经生效。

移动端适配

vant 中提供了两种方案,这里使用将 px 转成 viewport 单位的方案:

image.png

在依赖管理中添加开发依赖 postcss-px-to-viewport

image.png

在项目根目录创建 vue.config.js

image.png

添加配置:

const autoprefixer = require('autoprefixer');
const pxtoviewport = require('postcss-px-to-viewport');

module.exports = {
  css: {
    loaderOptions: {
      postcss: {
        plugins: [
          autoprefixer(),
          pxtoviewport({
            viewportWidth: 375
          })
        ]
      }
    }
  }
};

更多详细配置参考官网说明,这里给出一份官方说明的配置:

const autoprefixer = require('autoprefixer');
const pxtoviewport = require('postcss-px-to-viewport');

/** 区分打包环境与开发环境
  * process.env.NODE_ENV==='production'  (打包环境)
  * process.env.NODE_ENV==='development' (开发环境)
  */
 module.exports = {
  /**
   * 应用路径,应用的资源访问都会加上这个路径。
   * 如tomcat容器webapps有两个应用:
   * ROOT、my-app
   * 访问地址为:localhost:8080/、localhost:8080/my-app/,
   * 如果将应用放在my-app中,应用地址为 /my-app/
   * baseUrl 从 Vue CLI 3.3 起已弃用,请使用publicPath
   */
  publicPath: process.env.NODE_ENV === 'production' ? '/wxshop/' : '/',

  /**
   * 当运行 vue-cli-service build 时生成的生产环境构建文件的目录。注意目标目录在构建之前会被清除,默认dist
   */
  outputDir: 'dist',

  // assetsDir: '',//放置生成的静态资源 (js、css、img、fonts) 的 (相对于 outputDir 的) 目录

  /**
   * 指定生成的 index.html 的输出路径 (相对于 outputDir)。也可以是一个绝对路径。
   * 默认: 'index.html'
   */
  indexPath: 'index.html',

  /**
   * 默认情况下,生成的静态资源在它们的文件名中包含了 hash 以便更好的控制缓存。然而,这也要求 index 的 HTML 是被 Vue CLI 自动生成的。
   * 如果你无法使用 Vue CLI 生成的 index HTML,你可以通过将这个选项设为 false 来关闭文件名哈希。
   * 默认:true
   */
  filenameHashing: true,

  /**
   * 构建多页面时使用,具体查看 https://cli.vuejs.org/zh/config/#pages
   * 默认:undefined
   */
  pages: undefined,

  /**
   * js 代码错误检查,如果为true 生产和开发模式都会将错误输出为编译警告,不会使编译失败 https://cli.vuejs.org/zh/config/#lintonsave
   * 默认:true
   */
  lintOnSave: true,

  /**
   * 是否使用包含运行时编译器的 Vue 构建版本。设置为 true 后你就可以在 Vue 组件中使用 template 选项了,
   * 但是这会让你的应用额外增加 10kb 左右。
   * 默认:false
   */
  runtimeCompiler: false,

  /**
   * 默认情况下 babel-loader 会忽略所有 node_modules 中的文件。如果你想要通过 Babel 显式转译一个依赖,可以在这个选项中列出来。
   * 默认:[]
   */
  transpileDependencies: [],

  /**
   * 如果你不需要生产环境的 source map,可以将其设置为 false 以加速生产环境构建。source map 可以在线上环境报错时提示具体的错误位置。
   * 默认:false
   */
  productionSourceMap: false,

  /**
   * 设置生成的 HTML 中 <link rel="stylesheet"> 和 <script> 标签的 crossorigin 属性。
   * 需要注意的是该选项仅影响由 html-webpack-plugin 在构建时注入的标签 - 直接写在模版 (public/index.html) 中的标签不受影响。
   * 默认:undefined
   */
  crossorigin: undefined,

  /**
   * 在生成的 HTML 中的 <link rel="stylesheet"> 和 <script> 标签上启用 Subresource Integrity (SRI)。
   * 如果你构建后的文件是部署在 CDN 上的,启用该选项可以提供额外的安全性。
   * 需要注意的是该选项仅影响由 html-webpack-plugin 在构建时注入的标签 - 直接写在模版 (public/index.html) 中的标签不受影响
   * 另外,当启用 SRI 时,preload resource hints 会被禁用,因为 Chrome 的一个 bug 会导致文件被下载两次。
   * 默认:false
   */
  integrity: false,

  /**
   * 如果这个值是一个对象,则会通过 webpack-merge 合并到最终的配置中。
   * 如果这个值是一个函数,则会接收被解析的配置作为参数。该函数及可以修改配置并不返回任何东西,也可以返回一个被克隆或合并过的配置版本。
   * 更多细节可查阅:配合 webpack > 简单的配置方式
   * 简单的配置方式:https://cli.vuejs.org/zh/guide/webpack.html#%E7%AE%80%E5%8D%95%E7%9A%84%E9%85%8D%E7%BD%AE%E6%96%B9%E5%BC%8F
   * 作用:调整 webpack 配置
   */
  configureWebpack: config => {
      // window.console.log(config);

      if (process.env.NODE_ENV === 'production') {
          // 为生产环境修改配置...
      } else {
          // 为开发环境修改配置...
      }

      // config.resolve.alias
      //     .set("@", resolve("src")) // key,value自行定义,比如.set('@@',     resolve('src/components'))
      //     .set("_c", resolve("src/components"))
      //     .set("_conf", resolve("config"));
  },

  /**
   * 是一个函数,会接收一个基于 webpack-chain 的 ChainableConfig 实例。允许对内部的 webpack 配置进行更细粒度的修改。
   * 更多细节可查阅:配合 webpack > 链式操作
   * 链式操作:https://cli.vuejs.org/zh/guide/webpack.html#%E9%93%BE%E5%BC%8F%E6%93%8D%E4%BD%9C-%E9%AB%98%E7%BA%A7
   */
  chainWebpack: config => {

  },

  /**
   * css 相关配置
   * https://cli.vuejs.org/zh/config/#css-modules
   */
  css: {
      /**
       * 启用 CSS modules, v3中使用 modules 代替 requireModuleExtension,v4相反
       * 默认:true
       * 意义:默认情况下,只有 *.module.[ext] 结尾的文件才会被视作 CSS Modules 模块。
       * 设置为 false 后你就可以去掉文件名中的 .module 并将所有的 *.(css|scss|sass|less|styl(us)?) 文件视为 CSS Modules 模块。
       */
      requireModuleExtension: true,
      /**
       * 是否使用css分离插件
       * 提取 CSS 在开发环境模式下是默认不开启的,因为它和 CSS 热重载不兼容。然而,你仍然可以将这个值显性地设置为 true 在所有情况下都强制提取。
       * 默认:生产环境下是 true,开发环境下是 false
       */
      extract: true,

      /**
       * 是否为 CSS 开启 source map。设置为 true 之后可能会影响构建的性能。
       * 默认:false
       */
      sourceMap: false,

      /**
       * css预设器配置项,向 CSS 相关的 loader 传递选项。vue建议css 相关的 loader 的配置放在此处,而不是放在 webpack 的相关配置处
       * 更多细节可查阅:向预处理器 Loader 传递选项:
       * https://cli.vuejs.org/zh/guide/css.html#%E5%90%91%E9%A2%84%E5%A4%84%E7%90%86%E5%99%A8-loader-%E4%BC%A0%E9%80%92%E9%80%89%E9%A1%B9
       */
      loaderOptions: {
        // 向 postcss-loader 传递选项
        postcss: {
          plugins: [
            autoprefixer(),
            pxtoviewport({
              viewportWidth: 375
            })
          ]
        }
      }
  },
  /**
   * webpack-dev-server 相关配置
   */
  devServer: {
      host: '0.0.0.0',
      port: 8080, // 运行端口
      https: false,
      open: true, // 运行后是否自动打开页面
      hotOnly: false,
      proxy: {// 设置 API 代理
          "/api": {// 匹配 url 前缀
              //代理路径 例如 https://baidu.com
              target: "https://baidu.com",
              // 将主机标头的原点更改为目标URL
              changeOrigin: true,
              ws: true,
              pathRewrite: {
                  "^/api": ""
              }
          }
      },
      before: app => {
          // window.console.log(app);
      },
  },

  /**
   * 构建时开启多进程处理 babel 编译
   * 默认:require('os').cpus().length > 1,即多余1个cpu就开启
   */
  parallel: require('os').cpus().length > 1,

  /**
   * PWA 插件相关配置
   */
  pwa: {},

  /**
   * 第三方插件配置
   */
  pluginOptions: {
      // ...
  }

}

在管理界面重新运行项目,检查元素,单位已经由 px 转换为 vw:

image.png

切换机型,按钮也自适应机型改变大小:

image.png

postcss-px-to-viewport配置说明,可以查看官方说明地址,或下面的说明,以下为默认值:

{
  unitToConvert: 'px', 
  viewportWidth: 320, 
  unitPrecision: 5, 
  propList: ['*'],
  viewportUnit: 'vw',
  fontViewportUnit: 'vw',
  selectorBlackList: [],
  minPixelValue: 1,
  mediaQuery: false,
  replace: true,
  exclude: [],
  landscape: false,
  landscapeUnit: 'vw',
  landscapeWidth: 568
}

unitToConvert:(String) 需要转换的单位,默认为"px"
viewportWidth:(Number) 设计稿的视口宽度
unitPrecision:(Number) 单位转换后保留的精度
propList: (Array) 能转化为vw的属性列表

1、传入特定的CSS属性;
2、可以传入通配符"*"去匹配所有属性,例如:['*'];
3、在属性的前或后添加"*",可以匹配特定的属性. (例如['position*'] 会匹配 background-position-y)
4、在特定属性前加 "!",将不转换该属性的单位 . 例如: ['*', '!letter-spacing'],将不转换letter-spacing
5、"!" 和 "*"可以组合使用, 例如: ['*', '!font*'],将不转换font-size以及font-weight等属性

viewportUnit:(String) 希望使用的视口单位
fontViewportUnit:(String) 字体使用的视口单位
selectorBlackList:(Array) 需要忽略的CSS选择器,不会转为视口单位,使用原有的px等单位。

1、如果传入的值为字符串的话,只要选择器中含有传入值就会被匹配
   例如 selectorBlackList 为 ['body'] 的话, 那么 .body-class 就会被忽略
2、如果传入的值为正则表达式的话,那么就会依据CSS选择器是否匹配该正则
   例如 selectorBlackList 为 [/^body$/] , 那么 body 会被忽略,而 .body 不会

minPixelValue:(Number) 设置最小的转换数值,如果为1的话,只有大于1的值会被转换
mediaQuery: (Boolean) 媒体查询里的单位是否需要转换单位
replace:(Boolean) 是否直接更换属性值,而不添加备用属性
exclude:(Array or Regexp) 忽略某些文件夹下的文件或特定文件,例如 'node_modules' 下的文件,vant不需要排除

1、如果值是一个正则表达式,那么匹配这个正则的文件会被忽略
2、如果传入的值是一个数组,那么数组里的值必须为正则

landscape:(Boolean) 是否添加根据 landscapeWidth 生成的媒体查询条件 @media (orientation: landscape)
landscapeUnit:(String) 横屏时使用的单位
landscapeWidth:(Number) 横屏时使用的视口宽度

适配处理结束。


贝哥哥
89 声望19 粉丝