移动端布局适配hotcss+postcss-pxtorem

背景

本来团队是搞PC端开发的，前段时间架构调整，移动端人力不足，所以团队把移动端的工作也一起接过来了。

不过由于我们团队以前没开发过移动端的东西，技术积累较少，因此花费了不少时间在基础技术积累上面。

这次介绍一下我们的移动端适配方案的改进过程。

hotcss库

最开始进行移动端开发时，由于工期比较紧张，为了快速构建整个项目，我最后选择使用了hotcss 这个库。这个库的优点其实挺多的：

使用方便
支持不同的设计稿尺寸
支持在js代码中换算适配后的像素
有效解决1px问题

最开始选用这个库的原因其实也是因为使用方便，当初经过测试之后发现可以比较好的还原设计稿的尺寸后，我们就选择使用这个方案了。

不过由于担心cdn访问延迟和dns解析能问题导致hotcss.js资源加载失败，再加上本身源码也不长，我们直接将源码压缩后内联进模板里面。

不过使用一段时间之后，发现hotcss方案确实也有不少的坑。

1px/0.5px问题

经过我们QA同学的真机测试，发现在部分安卓4手机dpr=1的情况下，1px和0.5px的样式经过px2rem的转换后，还是会有问题，在dpr=1的低端机上，跟标签font-size会被计算成20px（还是22.5px有点忘记了），在这种情况下某些很小的像素如1px或者0.5px就有可能因为宽度小于了浏览器显示的最小宽度，所以我们为了兼容1dpr的手机，不得不专门给这种小像素的样式写了一个dpr的选择器的兼容方案（其他css样式同理）：

@mixin border-bottom($width: 1) {
  border-bottom: px2rem($width) solid map-get($defaultColor, borderColor);
  [data-dpr='1'] & {
    border-bottom-width: $width + 'px';
  }
}

这个问题个人感觉更多的还是0.5px导致的，但是架不住UI就是喜欢用0.5px的分割线和border...

设计稿尺寸问题

其实这个问题并不是hotcss库本身的问题，应该让UI同学出设计稿的时候，给前端同学一套统一的尺寸。

但是我们最开始的UI同学由于个人习惯问题，有的给我们的是iOS尺寸的设计稿，这种的尺寸是375px的，有的是安卓尺寸的设计稿360px的。而hotcss这个库需要提前声明$designWidth这个变量，之后使用px2rem()方法的时候才会进行替换，由于css没有作用域的概念，所以需要使用sass和less。

sass文件编译时候也是从上往下顺序执行的，变量声明可以覆盖，因此如果使用了sass或者less这种css扩展语言的话，这个地方应该是没有问题的，不过要记得给每一个sass和less文件都声明$designWidth，否则可能会因为某些文件没有声明变量导致使用了其他页面声明的尺寸而出现异常。

所以最佳的解决办法还是让UI统一尺寸，。

书写繁琐

说实话虽然使用起来很方便，只需要引入一个官方的sdk就完成了移动端适配方案。但是当写起业务css代码的时候，还是感觉hotcss使用起来很繁琐。

当UI稿中的尺寸是这样的时候：

font-size: 16px;
font-height: 20px;
height: 50px;
width: 200px;

我们就不能直接copy过来了，需要对其进行单位转换：

// 这一块代码可以放到common.scss中
@function px2rem($px) {
  @return $px * 320 / $designWidth/20 + rem;
}

$designWidth: 360;

font-size: px2rem(16);
font-height: px2rem(20);
height: px2rem(50);
width: px2rem(200);

总之当业务稳定之后，我们慢慢才发现用这个方案还是非常麻烦的，就经常被同事吐槽。

基于以上种种原因，我们团队在升级打包工具webpack->razzle的过程中，改进了适配方案，采用了hotcss+postcss-pxtorem结合的方案。

hotcss配合postcss-pxtorem

postcss-pxtorem这个工具库的使用介绍网上也到处都有，这个库的优点在于有很强的转换规则，可以适配各种场景。我们在这里使用这个插件是为了自动进行px->rem的转化，其他过程还是由hotcss来进行。

postcss-px2rem的一些参数

require('postcss-pxtorem')({
  rootValue: 75,
  unitPrecision: 5,
  propList: ['*'],
  selectorBlackList: [],
  replace: true,
  mediaQuery: false,
  minPixelValue: 12
})

rootValue是根标签的font-size大小
unitPrecision是转换成rem后的小数位数
propList是需要转换的属性列表
selectorBlackList则是一个对css选择器进行过滤的数组，比如你设置为['fs']，那例如fs-xl类名，里面有关px的样式将不被转换，这里也支持正则写法。
minPixelValue可以设置小于多少尺寸将不会进行转换。

postcss.cofnig.js

const PostCssFlexBugFixes = require('postcss-flexbugs-fixes');
const autoprefixer = require('autoprefixer');
const px2rem = require('postcss-pxtorem');
const path = require('path');
const designWidth = 360; // 统一的视觉稿尺寸
const rootValue = (designWidth * 20) / 320; // root FontSize
module.exports = ctx => {
  const remInclude = [
    /\.rem\.less$/,
    /\.rem\.scss$/,
  ]; // 白名单，命中白名单则进行px2rem转换，包括.rem.less、.rem.scss结尾的文件
  const useRem = remInclude.some(x =>
    x.test(path.join(ctx.file.dirname, ctx.file.basename))
  );
  return {
    plugins: [
      PostCssFlexBugFixes, //修复某些浏览器的flex bug
      autoprefixer({
        // autprefixer
        browsers: ['>1%', 'last 4 versions', 'Firefox ESR', 'not ie < 9'],
        flexbox: 'no-2009'
      }),
      useRem &&
        px2rem({
          rootValue,
          propList: ['*'],
          minPixelValue: 1
        })
    ].filter(Boolean)
  };
};

postcss-pxtorem完成对rem的转换，加上之前hotcss对font-size值的计算以及对viewport的初始化，我们最终完成了移动端的适配方案。

其中设置白名单列表是为了兼容以前老版本使用hotcss时候的写法，在升级razzle完毕之后我们后续的样式全部统一使用.rem.scss作为文件名后缀了，这样在样式文件中正常写px单位即可，postcss会自动为我们进行转换。

hotcss缩放scale的坑

最近使用一些第三方插件（如echarts和视频播放器等）的时候，发现hotcss根据dpr给页面设置的meta[viewport]和插件之间会有坑。

<meta name="viewport" content="width=device-width, initial-scale=0.5, minimum-scale=0.5, maximum-scale=0.5, user-scalable=no">

由于第三方插件一般读取过一次页面的scale之后，后续scale的修改不会影响这些样式。

而hotcss会重新根据dpr重新设置scale，这种情况下当css加载得比js慢的时候，就会导致页面样式会闪烁，并且第三方插件的样式都是根据最开始的scale进行布局的，因此在页面放大之后会显得很小。

不过这种情况一般在本地开发的时候才会出现，线上模式静态资源一般放入cdn，访问速度很快，在css加载速度快于js的时候就不会出现这个问题了。

不过为了在本地开发的时候方便观测样式，我们需要在客户端执行js的时候重新将font-size设置回1.0。

document.documentElement.style.fontSize = `${(window.innerWidth * 20) /
    320 / window.devicePixelRatio}px`;
let viewportEl = document.querySelector('meta[name="viewport"]');
const content = `width=device-width, initial-scale=1, minimum-scale=1, maximum-scale=1, user-scalable=no`;
if (viewportEl) {
  viewportEl.setAttribute('content', content);
} else {
  viewportEl = document.createElement('meta');
  viewportEl.setAttribute('name', 'viewport');
  viewportEl.setAttribute('content', content);
  document.head.appendChild(viewportEl);
}

这样整个页面上的第三方插件在本地调试的时候也是正常大小了~