create-react-app+react-app-rewired搭建viewport解决方案
create-react-app搭建vw-layout解决方案
前言:我第一次接触到vw适配移动端的方案是在大漠先生的博客里(如何在Vue项目中使用vw实现移动端适配),强烈建议没看过的朋友先去看一下这篇博客。vw解决方案早有耳闻,我也很想上手尝试一下,所以想要自己上手配置一个CRA脚手架的解决方案。在自己动手之前也先查了一些资料,其中Ghan的这篇博客很有帮助:使用create-react-app脚手架搭建vw-layout解决方案。和Ghan的方案不同,我研究了下决定借助react-app-rewired来搭建。下面把我的配置过程写在这里,有什么不对的地方欢迎批评,小白第一次配,求轻拍。
先上一些背景资料。主要用到以下几个工具:
react-app-rewired:一个CRA再配置的工具,源自React社区,可以在不eject的情况下自定义配置CRA脚手架创建的app。原理很简单,在项目根目录下新建一个配置文件(config-overrides.js),把webpack的配置作为一个config对象传入react-app-rewired,再用config-overrides中的配置对其做修改,然后用修改后的config对象对项目打包。
react-app-rewire-postcss:一个react-app-rewired中使用的postcss-loader。通过在config-overrides.js中加载这个loader并自定义配置,从而实现修改CRA默认配置的目的。
除此之外还要用到几个常规插件:
cssnano-preset-advanced
postcss-aspect-ratio-mini
postcss-px-to-viewport
postcss-write-svg
cssnano
postcss-viewport-units
postcss-flexbugs-fixes
postcss-preset-env
其中,postcss-flexbugs-fixes、postcss-preset-env是目前版本CRA的默认配置,就不做过多的解释了;由于cssnano的配置中使用了preset: "advanced"配置,需要安装cssnano-preset-advanced包;zhipostcss-aspect-ratio-mini、postcss-px-to-viewport、postcss-write-svg、cssnano、postcss-viewport-units这几个插件是这个方案的核心,大漠先生已经做了非常详细的解释,强烈建议大家去看大漠的这篇文章。
开始
构建
create-react-app vwpage
安装依赖
yarn add postcss-aspect-ratio-mini postcss-px-to-viewport postcss-write-svg postcss-viewport-units cssnano cssnano-preset-advanced react-app-rewired postcss-preset-env --dev //使用yarn作为包管理工具,习惯npm的朋友也可以用npm
这里简单说明一下,大漠先生的教程中提到的postcss-cssnext已经停止维护了,整合进了postcss-preset-env这个项目中,因此不需要再安装postcss-cssnext了,具体信息参见该项目github。
react-app-rewired配置
在项目根目录下新建config-overrides.js文件。内容如下:
module.exports = function override(config, env) { //do stuff with the webpack config... return config; }
安装react-app-rewire-postcss Loaders
yarn add react-app-rewire-postcss --dev
配置config-overrides.js
module.exports = function override(config, env) { require('react-app-rewire-postcss')(config, { plugins: loader => [ require('postcss-flexbugs-fixes'), require('postcss-preset-env')({ autoprefixer: { flexbox: 'no-2009', }, stage: 3, }), require('postcss-aspect-ratio-mini')({}), require('postcss-px-to-viewport')({ viewportWidth: 750, // (Number) The width of the viewport. viewportHeight: 1334, // (Number) The height of the viewport. unitPrecision: 3, // (Number) The decimal numbers to allow the REM units to grow to. viewportUnit: 'vw', // (String) Expected units. selectorBlackList: ['.ignore', '.hairlines'], // (Array) The selectors to ignore and leave as px. minPixelValue: 1, // (Number) Set the minimum pixel value to replace. mediaQuery: false // (Boolean) Allow px to be converted in media queries. }), require('postcss-write-svg')({ utf8: false }), require('postcss-viewport-units')({}), require('cssnano')({ preset: "advanced", autoprefixer: false, "postcss-zindex": false }) ] }); return config; }
兼容方案
大漠老师在博客中提到了Viewport Units Buggyfill作为兼容工具,我简单看了下这个项目的gitHub介绍,这是一个buggyfill,主要是修复某些浏览器中关于viewport实现的bug,而不是作为polyfill在完全不支持viewport的浏览器中来实现它。
1.引入JavaScript文件:
viewport-units-buggyfill主要有两个JavaScript文件:viewport-units-buggyfill.js和viewport-units-buggyfill.hacks.js。你只需要在你的HTML文件中引入这两个文件。比如在react项目中的index.html引入它们:
<script src="//g.alicdn.com/fdilab/lib3rd/viewport-units-buggyfill/0.6.2/??viewport-units-buggyfill.hacks.min.js,viewport-units-buggyfill.min.js"></script>
2.在body中加入以下代码:
<script> window.onload = function () { window.viewportUnitsBuggyfill.init({ hacks: window.viewportUnitsBuggyfillHacks }); } </script>
One more thing
修改项目package.json中的npm scripts:
/* package.json */ "scripts": { - "start": "react-scripts start", + "start": "react-app-rewired start", - "build": "react-scripts build", + "build": "react-app-rewired build", - "test": "react-scripts test --env=jsdom", + "test": "react-app-rewired test --env=jsdom" }
后记:完结撒花~本文简单研究了一下如何搭建viewport解决方案,如有错误欢迎指出。