vue移动端布局适配方案之postcss-px-to-viewport

wwf1225

已于 2025-03-26 13:04:29 修改

阅读量386

点赞数

文章标签： vue.js postcss 前端

于 2025-03-26 13:04:07 首次发布

原文链接：https://blog.csdn.net/HanYaLi39/article/details/136186480

版权

vue移动端布局适配方案之postcss-px-to-viewport_vue postcss-px-to-viewport-CSDN博客

一、前言
在项目中本地开发时使用px，但是界面上线以后，样式需要根据视口大小来调整宽度，我们可以用viewport单位，现在viewport单位越来越受到众多浏览器的支持。它可以将CSS中的px单位转化为视口单位vw，众所周知，vw本质上还是一种百分比单位，100vw即等于100%（1vw等于1/100视口宽度），即window.innerWidth。

二、postcss-px-to-viewport 使用
1、安装
npm install postcss-px-to-viewport --save-dev
1
或者使用yarn进行安装

$ yarn add -D postcss-px-to-viewport
1
2、在项目根目录下添加.postcssrc.js文件或postcss.config.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 // 是否处理横屏情况
}
}
};

项目中用过的配置

// eslint-disable-next-line no-undef
module.exports = {
plugins: {
'postcss-px-to-viewport': {
viewportWidth: 375
}
}
}

3、然后重新运行项目，使配置文件生效。
三、需要注意的配置
propList: 当有些属性的单位我们不希望转换的时候，可以添加在数组后面，并在前面加上!号，如propList: [“*”,“!letter-spacing”],这表示：所有css属性的属性的单位都进行转化，除了letter-spacing的
selectorBlackList：转换的黑名单，在黑名单里面的我们可以写入字符串，只要类名包含有这个字符串，就不会被匹配。比如selectorBlackList: [‘wrap’],它表示形如wrap,my-wrap,wrapper这样的类名的单位，都不会被转换
四、可能遇到的问题
@keyframes 和media查询里的px默认是不转化的，设置mediaQuery： true则媒体查询里也会转换px
@keyframes可以暂时手动填写vw单位的转化结果
五、关于兼容第三方UI库
参考：https://blog.csdn.net/sinat_17775997/article/details/127101451
当我们引入一些第三方库的时候，比如vant，上面配置的exclude去掉，表示全部内容进行vw转换，会遇到这样的问题，这个TabBar，变得非常的小，被压扁了。
解决思路：如果读取的是vant相关的文件，viewportWidth就设为375，如果是其他的文件，我们就按照我们UI的宽度来设置viewportWidth，即750。
改写.postcssrc.js文件或者是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: ["*"],
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
————————————————