2021年12月vue+postcss+vant移动端自适应方案

1、安装插件

yarn add postcss-px-to-viewport -D

2、在项目根目录下添加.postcssrc.js文件配置如下

module.exports = {
  plugins: {
    autoprefixer: {}, // 用来给不同的浏览器自动添加相应前缀，如-webkit-，-moz-等等
    "postcss-px-to-viewport": {
      unitToConvert: "px", // 要转化的单位
      viewportWidth: 750, // UI设计稿的宽度
      unitPrecision: 6, // 转换后的精度，即小数点位数
      propList: ["*"], // 指定转换的css属性的单位，*代表全部css属性的单位都进行转换
      viewportUnit: "vw", // 指定需要转换成的视窗单位，默认vw
      fontViewportUnit: "vw", // 指定字体需要转换成的视窗单位，默认vw
      selectorBlackList: ["wrap"], // 指定不转换为视窗单位的类名，
      minPixelValue: 1, // 默认值1，小于或等于1px则不进行转换
      mediaQuery: true, // 是否在媒体查询的css代码中也进行转换，默认false
      replace: true, // 是否转换后直接更换属性值
      exclude: [/node_modules/], // 设置忽略文件，用正则做目录名匹配
      landscape: false // 是否处理横屏情况
    }
  }
};

3、重新运行项目，使配置文件生效

4、我们写一段测试代码来验证一下：

<template>
  <div class="test-viewport">测试转换</div>
</template>

<style lang="less" scoped>
.test-viewport {
  width: 750px;
  height: 100px;
  font-size: 40px;
  text-align: center;
  line-height: 100px;
  background: #13b5b1;
}
</style>

5、打开控制台，可以看到已经进行了转换

需要注意的配置 

• propList: 当有些属性的单位我们不希望转换的时候，可以添加在数组后面，并在前面加上!号，如propList: ["*","!letter-spacing"],这表示：所有css属性的属性的单位都进行转化，除了letter-spacing的
• selectorBlackList：转换的黑名单，在黑名单里面的我们可以写入字符串，只要类名包含有这个字符串，就不会被匹配。比如selectorBlackList: ['wrap'],它表示形如wrap,my-wrap,wrapper这样的类名的单位，都不会被转换

关于兼容第三方UI库

当然，当我们引入一些第三方库的时候，比如vant，上面配置的exclude去掉，表示全部内容进行vw转换，会遇到这样的问题：

 

像这个TabBar，变得非常的小，被压扁了。

其实vant官网也是给出了关于viewport的适配方案，在github找一个名为vant-demo的项目，可以看到其配置如下，github链接：

很尴尬，vant团队的是根据375px的设计稿去做的，理想视口宽度为375px。

那么，我们是否也要叫UI重新出一版375px的设计稿？

或者，我们在书写的过程心算一下，所有标注的尺寸都除以2？

让我们回到webpack本身，重新看一下这份.postcssrc.js文件，它除了暴露一个对象，也可以暴露一个函数，无论暴露什么，在webpack运行时，都会被我们配置的海量文件读取并执行。

暴露函数有一个好处，可以拿到webpack运行的当前执行文件的信息。

那么我们可以有这样一个思路：如果读取的是vant相关的文件，viewportWidth就设为375，如果是其他的文件，我们就按照我们UI的宽度来设置viewportWidth，即750。

改写.postcssrc.js文件配置如下：

const path = require('path');

module.exports = ({ webpack }) => {
  const designWidth = webpack.resourcePath.includes(path.join('node_modules', 'vant')) ? 375 : 750;

  return {
    plugins: {
      autoprefixer: {},
      "postcss-px-to-viewport": {
        unitToConvert: "px",
        viewportWidth: designWidth,
        unitPrecision: 6,
        propList: ["*"],
        viewportUnit: "vw",
        fontViewportUnit: "vw",
        selectorBlackList: [],
        minPixelValue: 1,
        mediaQuery: true,
        exclude: [],
        landscape: false
      }
    }
  }

}

 注意：这里使用path.join('node_modules', 'vant')是因为适应不同的操作系统， 在mac下结果为node_modules/vant，而在windows下结果为node_modules\vant

另外，收到有同学反馈关于Cannot read property 'dirname' of undefined的问题，我本地由于是macOS系统，多次尝试无法复现该问题，猜测有可能是平台问题或打包工具问题，换成了取用编译的webpack对象中的resourcePath。

重新运行后发现，不仅vant相关组件的单位被转换成了vw，而且其比例也是完全正确的。