以前做移动端项目的时候都是用 rem 来做适配,现在基本上都是通过 viewport 单位来做。 postcss-px-to-viewport 就是一个将 px 单位转换为视口单位的 (vw, vh, vmin, vmax) 的 PostCSS 插件,它可以将你 CSS 中的 px 单位转化为 vw,1vw 等于 1/100 视口宽度。

# 1. 安装

npm install postcss-px-to-viewport --save-dev

# 2. 配置参数

在项目根目录创建 postcss.config.js 文件,添加如下配置。

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

启动项目,此时已经自动进行了转换,会根据 postcss.config.js 文件中的 viewportWidth 的值将 px 转换为 vw ,比如说设置 div 宽度为 750px,转换后就是 100vw。此时的样式如下:

输入

.class {
    margin: -10px .5vh;
    padding: 5vmin 9.5px 1px;
    border: 3px solid black;
    border-bottom-width: 1px;
    font-size: 14px;
    line-height: 20px;
}

输出

.class {
    margin: -3.125vw .5vh;
    padding: 5vmin 2.96875vw 1px;
    border: 0.9375vw solid black;
    border-bottom-width: 1px;
    font-size: 4.375vw;
    line-height: 6.25vw;
}

# 3.vant

# (1). 问题 1 vant 中组件的 css 单位没有转换

将所有的配置好之后,启动项目,添加了 vant 的组件后,打开检查,发现仍然是 px 单位,没有进行转换。

postcss-px-to-viewport 移动端适配1.png 因为 postcss.config.js 文件中的 exclude 参数将整个 node_modules 文件夹中的组件都给排除掉了,安装的插件会使用它默认的单位,将 exclude 改为 []

# (2). 问题 2 转视口单位后的 vant 组件特别小

此时 vant 组件的单位也进行了转换,但是展示会特别的小。

postcss-px-to-viewport 移动端适配2.png

通过排查,在 github 上找到 vant 的官方 demo,发现 vant 设置视口宽度是 375,而我们设置的宽度为 750,所以 vant 组件在转换之后会宽高都变为原来的一半大小。

postcss-px-to-viewport 移动端适配3.png

所以我们要设置当转换到 vant 组件样式的单位时,将视口宽度设置为 375,将 postcss.config.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: ["*"], // 指定转换的 css 属性的单位,* 代表全部 css 属性的单位都进行转换
                viewportUnit: "vw", // 指定需要转换成的视窗单位,默认 vw
                fontViewportUnit: "vw", // 指定字体需要转换成的视窗单位,默认 vw
                selectorBlackList: [], // 指定不转换为视窗单位的类名,
                minPixelValue: 1, // 默认值 1,小于或等于 1px 则不进行转换
                mediaQuery: true, // 是否在媒体查询的 css 代码中也进行转换,默认 false
                //replace: true, // 是否转换后直接更换属性值
                exclude: [], // 设置忽略文件,用正则做目录名匹配 /node_modules/
                landscape: false // 是否处理横屏情况
            }
        }
    }
}

此时页面已经恢复了正常。

postcss-px-to-viewport 移动端适配4.png

# 4. 行内样式

后续在使用 vant 的 image 组件的时候发现,在传入 width 和 height 750 之后,图片超出了页面,打开检查发现仍然是 px 单位,没有转化为 vw,传入的 width 和 height 是加到了 img 标签父元素的行内样式上,创建一个 div 实验了一下, postcss-px-to-viewport 不会对行内样式进行转换,只会转换卸载 style 标签中的样式。给 image 组件添加了 class,展示正常。

使用 width 和 height 传入:

postcss-px-to-viewport 移动端适配5.png

使用 class 控制样式: postcss-px-to-viewport 移动端适配6.png