vue移动端适配方案 === postcss-px-to-viewport

目录

主角是谁

痛点在哪里

人们希望有这样一种方案...

两种方案都很好,但我偏爱后者

在vue项目中引入试试

需要注意的配置

关于兼容第三方UI库

cnjm-postcss-px-to-viewport


主角是谁

在今天这篇文章中,我并不会在这里讲一些移动端视口的概念,包括物理像素和逻辑像素,理想视口,dpr等等等等,我只介绍这样一种非常不错的移动端适配方案:post-css-to-viewport,如果我说这种方案能解决98%以上的移动端布局痛点,

痛点在哪里

在之前有一种流行已久的移动端适配方案,那就是rem,我想下面这两句代码,有不少老移动端都不会陌生:

复制代码
    const deviceWidth = document.documentElement.clientWidth || document.body.clientWidth;
    document.querySelector('html').style.fontSize = deviceWidth / 7.5 + 'px';

没错,在那个移动端UI稿尺寸为750*1334满天飞的时代,这两句代码确实给开发者带来了很大的方便,这样设置根font-size后,px和rem的转换比例成了100, 为比如UI稿一个长宽分别为120px*40px,那么开发者对应的写成1.2rem*0.4rem就可以了

这种换算已经是颇为方便,但是并非所有的项目都能这样去设置一个方便换算的比例系数,当比例系数为100时,小数点往前面挪两位就行了,然而有的项目设置的换算系数千奇百怪,有50的,有16的,很多已经严重超出口算力所能及的范畴了。所以后来诞生的px-to-rem或者px2rem就是为了解决这个问题

人们希望有这样一种方案...

  • 首先,无论换算方不方便,我都不想换算(就是这么懒🤭),我也不想去操心什么转换系数
  • 其次,有些属性或者类选择器我不想进行转换
  • css代码要足够简洁,我只希望看到一种单位,那就是px

两种方案都很好,但我偏爱后者

第一种方案是lib-flexible+postcss-pxtorem,在相当长一段时间里,这两个插件搭配都是解决移动端布局的神器,lib-flexible是阿里手淘系开源的一个库,用于设置font-size,同时处理一些窗口缩放的问题。其中一位主要贡献者正是阿里的大神winter。

直到今天,我仍然可以说,lib-flexible+postcss-pxtorem是解决移动端布局的主流,但是我们可以好好想一想,它是否有什么不足?

从我个人来说,我认为它主要有以下两个不足:

  1. 两个插件需要配套使用,而且rootValue设置的值不好理解
  1. rem是相对于html元素字体单位的一个相对单位,从本质上来说,它属于一个字体单位,用字体单位来布局,并不是太合适

翻阅其github地址,可以看到这样一段有意思的话:

第二种方案是viewport,postcss-px-to-viewport就是这样一款优秀的插件,它解决了以上提到的痛点,也满足以上提到的理想要求。它将px转换成视口单位vw,众所周知,vw本质上还是一种百分比单位,100vw即等于100%,即window.innerWidth

在vue项目中引入试试

创建一个vue项目并安装该插件

复制代码
npm create vite@latest my-project  

npm i  postcss-px-to-viewport -D

在项目根目录下添加.postcss.config.cjs文件, 添加如下配置:

如果项目包含有效的 PostCSS 配置 (任何受 postcss-load-config 支持的格式,例如 postcss.config.js),它将会自动应用于所有已导入的 CSS。

复制代码
module.exports = {
  plugins: {

    "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, // 是否处理横屏情况
    },
  },
};

重新运行项目,使配置文件生效

我们写一段测试代码来验证一下:

复制代码
<template>
  <div class="test-viewport">测试转换</div>
</template>
 
<style  scoped>
  /* 设计稿的宽度是750px 「750px = 100vw 」
  1vw = 750px / 100 = 7.5px
  100px = 100px里面有多少个vw = 100px / 7.5px = 13.333333333333334vw
    */
.test-viewport {
  width:750px;
  height: 100px;
  font-size: 30px;
  text-align: center;
  line-height: 100px;
  background: #13b5b1;
}
</style>

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

设计稿的宽度是750px 「750px = 100vw 」

1vw = 750px / 100 = 7.5px

100px = 100px里面有多少个vw = 100px / 7.5px = 13.333333333333334vw

需要注意的配置

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

关于兼容第三方UI库

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

像这个button,变得非常的小,被压扁了。

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

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

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

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

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

cnjm-postcss-px-to-viewport

一直希望在vite 中 使用 postcss-px-to-viewport 时可以设置不同的设计尺寸,比如vant是375设计的

而我们可能是750或其他尺寸,一直找了好久都没有合适的解决方案(有个webpack的,不过vite的貌似不行),如果有知道其他好的解决方法的,麻烦告知一下,感激不尽!

干脆就稍加改了一下postcss-px-to-viewport的代码

其实就是在src/index.js中加入了以下代码,把当前文件路径暴露出去,接收一个新的viewportWidth并赋值给opts

具体可以看下源代码

复制代码
if(opts.customFun){
  opts.viewportWidth = opts.customFun({file:rule.source.input.file});
}

下载 安装 cnjm-postcss-px-to-viewport

复制代码
 npm i cnjm-postcss-px-to-viewport

配置时使用cnjm-postcss-px-to-viewport

复制代码
// eslint-disable-next-line @typescript-eslint/no-require-imports
const path = require("path");

const judgeComponent = (file) => {
  const ignore = ["vant"];
  return ignore.some((item) =>
    path.join(file).includes(path.join("node_modules", item))
  );
};

module.exports = {
  plugins: {
  
    "cnjm-postcss-px-to-viewport": {
      unitToConvert: "px", // 要转化的单位
      viewportWidth: 750, // UI设计稿的宽度
      unitPrecision: 6, // 转换后的精度,即小数点位数
      propList: ["*"], // 指定转换的css属性的单位,*代表全部css属性的单位都进行转换
      viewportUnit: "vw", // 指定需要转换成的视窗单位,默认vw
      fontViewportUnit: "vw", // 指定字体需要转换成的视窗单位,默认vw
      minPixelValue: 1, // 默认值1,小于或等于1px则不进行转换
      mediaQuery: true, // 是否在媒体查询的css代码中也进行转换,默认false
      replace: true, // 是否转换后直接更换属性值
      landscape: false, //是否添加根据 landscapeWidth 生成的媒体查询条件 @media (orientation: landscape)
      landscapeUnit: "rem", //横屏时使用的单位
      landscapeWidth: 1134, //横屏时使用的视口宽度
      include: [],
      exclude: [], // 设置忽略文件,用正则做目录名匹配
      customFun: ({ file }) => {
        // 这个自定义的方法是针对处理vant组件下的设计稿为375问题
        const designWidth = judgeComponent(file) ? 375 : 750;
        return designWidth;
      },
    },
  },
};
相关推荐
VT.馒头2 分钟前
【力扣】2695. 包装数组
前端·javascript·算法·leetcode·职场和发展·typescript
css趣多多13 分钟前
一个UI内置组件el-scrollbar
前端·javascript·vue.js
-凌凌漆-21 分钟前
【vue】pinia中的值使用 v-model绑定出现[object Object]
javascript·vue.js·ecmascript
C澒33 分钟前
前端整洁架构(Clean Architecture)实战解析:从理论到 Todo 项目落地
前端·架构·系统架构·前端框架
C澒40 分钟前
Remesh 框架详解:基于 CQRS 的前端领域驱动设计方案
前端·架构·前端框架·状态模式
Charlie_lll43 分钟前
学习Three.js–雪花
前端·three.js
onebyte8bits1 小时前
前端国际化(i18n)体系设计与工程化落地
前端·国际化·i18n·工程化
C澒1 小时前
前端分层架构实战:DDD 与 Clean Architecture 在大型业务系统中的落地路径与项目实践
前端·架构·系统架构·前端框架
BestSongC1 小时前
行人摔倒检测系统 - 前端文档(1)
前端·人工智能·目标检测
0思必得02 小时前
[Web自动化] Selenium处理滚动条
前端·爬虫·python·selenium·自动化