移动端适配实践

img

viewport 视图、视窗

移动端设备中,整块显示屏就相当于视图、视窗

在移动端设备中, 浏览器视图并不是整个屏幕。因此viewport又被分为了3种layout viewport 、visual viewport、ideal viewport

layout viewport

大部分浏览器把viewport的宽度设为了980px 这个浏览器默认设置的视图被称为 layout viewport。我们可以使用document.documentElement.clientWidth 来获取

lvisual viewport

layout viewport的宽度是远大于浏览器宽度的,因此我们需要一个新的viewport来代表浏览器的可视区域宽度,这个视图则被成为 visual viewport 我们可以使用 window.innerWidth 来获取

ideal viewport

现在越来越多的网站都会为移动设备进行单独的设计,所以必须还要有一个能完美适配移动设备的ideal viewport

viewport 单位 vw、vh

vw、vh将viewport分成了一百份。vw即 viewport width vh即viewport height

1vw等于视图单位的1%的宽度

1vh等于视图单位的1%的高度

如果设计稿的视图为375px 那么1vw 等于 3.75px

要使用viewport适配 我们必须安装postcss-px-to-viewport这个包。这包和postcss-pxtorem类似。

不仅名字相似,功能也有相似的地方

postcss-pxtorem是将 px单位转换为rem单位。

postcss-px-to-viewport则是将px单位转换为vw、vh

1
2
//引入 postcss-px-to-viewport
pnpm i postcss-px-to-viewport --save-dev

安装完成后 我们需要进行postcss插件相关的配置,在根目录新建一个名为postcss.config.js的文件,如果项目中已包含该文件则无需新建。在文件中写入如下代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
//postcss.config.js

module.exports = {
plugins: {
'postcss-px-to-viewport': {
unitToConvert: "px", // 要转化的单位
viewportWidth: 375, // 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/], // 设置忽略文件,用正则做目录名匹配
}
}
}

注意:postcss-px-to-viewport 同样存在第三方组件库兼容性的问题。比如在设计稿为750px时使用vant组件库会将vant组件的样式缩小。

vant组件库的设计稿是按照375px来开发的。因此在viewportWidth750px时会出现转换问题

解决第三方组件库兼容性问题

cnjm-postcss-px-to-viewport

基于postcss-px-to-viewport,只是增加了可以配置不同的设计稿尺寸,比如当使用vant时,375的设计尺寸可能与你的要求不符合

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

1
2
3
if(opts.customFun){
opts.viewportWidth = opts.customFun({file:rule.source.input.file});
}

下面是配置:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// postcss.config.js
const path = require('path');
module.exports = () => {
return {
plugins: {
autoprefixer: {
overrideBrowserslist: ['Android 4.1', 'iOS 7.1', 'Chrome > 31', 'ff > 31', 'ie >= 8']
},
// 修改插件名称
'cnjm-postcss-px-to-viewport': {
unitToConvert: 'px', // 要转化的单位
viewportWidth: 750, // UI设计稿的宽度
unitPrecision: 3, // 转换后的精度,即小数点位数
propList: ['*'], // 指定转换的css属性的单位,*代表全部css属性的单位都进行转换
viewportUnit: 'vw', // 指定需要转换成的视窗单位,默认vw
fontViewportUnit: 'vw', // 指定字体需要转换成的视窗单位,默认vw
selectorBlackList: ['ignore'], // 指定不转换为视窗单位的类名,
minPixelValue: 1, // 默认值1,小于或等于1px则不进行转换
mediaQuery: true, // 是否在媒体查询的css代码中也进行转换,默认false
replace: true, // 是否转换后直接更换属性值
exclude: [], // 设置忽略文件,用正则做目录名匹配
landscape: false, // 是否处理横屏情况
// 如果没有使用其他的尺寸来设计,下面这个方法可以不需要,比如vant是375的
customFun: ({ file }) => {
// 这个自定义的方法是针对处理vant组件下的设计稿为375问题
const designWidth = path.join(file).includes(path.join('node_modules', 'vant')) ? 375 : 750;
return designWidth;
}
}
}
};
};

读取的node_modules中的文件是vant,那么就将设计稿变为375px。如果读取的文件不是vant的文件,那么就将设计稿变为750px。这样就可以避免vant组件在750px下出现样式缩小的问题了。

总结

解决移动端适配的问题,形成模板,在团队内部推广。

px -> rem 的形式,使用上效率不高(自己去算,获取其他方式),还不太工程化,麻烦且难以维护。

因此我引入了这种方式,形成了一套模板,并集成到脚手架之中, 提升团队研发效率。


移动端适配实践
http://example.com/2024/07/12/移动端适配实践/
作者
lyric
发布于
2024年7月12日
许可协议