移动端viewport适配Vant,完美解决375/750尺寸适配问题

1,517 阅读3分钟

vant的参考尺寸是 375, 设计稿的尺寸是750, 如何在webpack/vite 配置postcss-px-to-viewport

安装

npm i postcss-px-to-viewport-8-plugin -D

默认配置

在项目根目录下添加 postcss.config.js 文件

module.exports = () => {
  return {
    plugins: {
      "postcss-px-to-viewport-8-plugin": {
        unitToConvert: "px", // 需要转换的单位,默认为"px"
        viewportWidth: 375, // 设计稿的视口宽度
        unitPrecision: 5, // 单位转换后保留的精度
        propList: ["*"], // 能转化为vw的属性列表,!font-size表示font-size后面的单位不会被转换
        viewportUnit: "vw", // 希望使用的视口单位
        fontViewportUnit: "vw", // 字体使用的视口单位
        // 需要忽略的CSS选择器,不会转为视口单位,使用原有的px等单位。
        // 下面配置表示类名中含有'keep-px'都不会被转换
        selectorBlackList: ["keep-px"],
        minPixelValue: 1, // 设置最小的转换数值,如果为1的话,只有大于1的值会被转换
        mediaQuery: false, // 媒体查询里的单位是否需要转换单位
        replace: true, //  是否直接更换属性值,而不添加备用属性
        // exclude: [/node_modules/], // 忽略某些文件夹下的文件或特定文件,例如 'node_modules' 下的文件
        include: [/src/], // 如果设置了include,那将只有匹配到的文件才会被转换
        landscape: false, // 是否添加根据 landscapeWidth 生成的媒体查询条件 @media (orientation: landscape)
        landscapeUnit: "vw", // 横屏时使用的单位
        landscapeWidth: 1338, // 横屏时使用的视口宽度
      },
    },
  };
};

webpack中修改配置

函数入口添加 file 参数,并根据file判断viewportWidth;

module.exports = ({ file }) => {
  return {
    plugins: {
      "postcss-px-to-viewport": {
        viewportWidth:
          file && file.dirname && file.dirname.includes("node_modules/vant") ? 375 : 750,
        unitPrecision: 5,
        viewportUnit: "vw",
        fontViewportUnit: "vw",
        selectorBlackList: [],
        minPixelValue: 1,
        mediaQuery: false
      }
    }
  };
};

vite中修改适配

将 viewportWidth 的值改为函数类型,在函数中判断是否是vant文件,参考下方代码。

module.exports = () => {
  return {
    plugins: {
      "postcss-px-to-viewport-8-plugin": {
        unitToConvert: "px", // 需要转换的单位,默认为"px"
        // viewportWidth: 375, // 设计稿的视口宽度
        viewportWidth: function (file) {
          return file && file.includes("node_modules/vant") ? 375 : 750;
        },
        unitPrecision: 5, // 单位转换后保留的精度
        propList: ["*"], // 能转化为vw的属性列表,!font-size表示font-size后面的单位不会被转换
        viewportUnit: "vw", // 希望使用的视口单位
        fontViewportUnit: "vw", // 字体使用的视口单位
        // 需要忽略的CSS选择器,不会转为视口单位,使用原有的px等单位。
        // 下面配置表示类名中含有'keep-px'都不会被转换
        selectorBlackList: ["keep-px"],
        minPixelValue: 1, // 设置最小的转换数值,如果为1的话,只有大于1的值会被转换
        mediaQuery: false, // 媒体查询里的单位是否需要转换单位
        replace: true, //  是否直接更换属性值,而不添加备用属性
        // exclude: [/node_modules/], // 忽略某些文件夹下的文件或特定文件,例如 'node_modules' 下的文件
        include: [/src/], // 如果设置了include,那将只有匹配到的文件才会被转换
        landscape: false, // 是否添加根据 landscapeWidth 生成的媒体查询条件 @media (orientation: landscape)
        landscapeUnit: "vw", // 横屏时使用的单位
        landscapeWidth: 1338, // 横屏时使用的视口宽度
      },
    },
  };
};