如何在Vue3项目中使用vw实现移动端适配
From: 大漠 W3cplus 2018-01-25
有关于移动端的适配布局一直以来都是众说纷纭，对应的解决方案也是有很多种。在《使用Flexible实现手淘H5页面的终端适配》提出了Flexible的布局方案，随着viewport单位越来越受到众多浏览器的支持，因此在《再聊移动端页面的适配》一文中提出了vw来做移动端的适配问题。到目前为止不管是哪一种方案，都还存在一定的缺陷。言外之意，还没有哪一个方案是完美的。
事实上真的不完美？其实不然。最近为了新项目中能更完美的使用vw来做移动端的适配。探讨出一种能解决不兼容viewport单位的方案。今天整理一下，与大家一起分享。如果方案中存在一定的缺陷，欢迎大家一起拍正。
准备工作
对于Flexible或者说vw的布局，其原理不在这篇文章进行阐述。如果你想追踪其中的原委，强烈建议你阅读早前整理的文章《使用Flexible实现手淘H5页面的终端适配》和《再聊移动端页面的适配》。
说句题外话，由于Flexible的出现，也造成很多同学对rem的误解。正如当年大家对div的误解一样。也因此，大家都觉得rem是万能的，他能直接解决移动端的适配问题。事实并不是如此，至于为什么，我想大家应该去阅读flexible.js源码，我相信你会明白其中的原委。
回到我们今天要聊的主题，怎么实现vw的兼容问题。为了解决这个兼容问题，我将借助Vue官网提供的构建工程以及一些PostCSS插件来完成。在继续后面的内容之前，需要准备一些东西：
- NodeJs
- NPM
- Webpack
- Vue-cli
- postcss-import
- postcss-url
- postcss-aspect-ratio-mini
- postcss-cssnext
- autoprefixer
- postcss-px-to-viewport
- postcss-write-svg
- cssnano
- postcss-viewport-units
- Viewport Units Buggyfill
对于这些起什么作用，先不阐述，后续我们会聊到上述的一些东西。
使用Vue-cli来构建项目
对于NodeJs、NPM和Webpack相关介绍，大家可以查阅其对应的官网。这里默认你的系统环境已经安装好Nodejs、NPM和Webpack。我的系统目前使用的Node版本是v10.16.0；NPM的版本是v6.11.3。事实上，这些都并不重要。
使用Vue-cli构建项目
为了不花态多的时间去深入的了解Webpack（Webpack对我而言，太蛋疼了），所以我直接使用Vue-cli来构建自己的项目，因为我一般使用Vue来做项目。如果你想深入的了解Webpack，建议你阅读下面的文章：
Webpack文档
Awesome Webpack
Webpack 教程资源收集
Vue+Webpack开发可复用的单页面富应用教程
接下来的内容，直接使用Vue官方提供的Vue-cli的构建工具来构建Vue项目。首先需要安装Vue-cli：
$ npm install -g vue-cli
全局先安装Vue-cli，假设你安装好了Vue-cli。这样就可以使用它来构建项目：
vue create vw-layout
根据命令提示做相应的操作(以下是我个人的配置)：
Vue CLI v3.11.0
┌───────────────────────────┐
│ Update available: 4.1.1 │
└───────────────────────────┘
? Please pick a preset: Manually select features
? Check the features needed for your project: Babel, Router, Vuex, CSS Pre-processors, Linter
? Use history mode for router? (Requires proper server setup for index fallback in production) Yes
? Pick a CSS pre-processor (PostCSS, Autoprefixer and CSS Modules are supported by default): Sass/SCSS (with node-sass)
? Pick a linter / formatter config: Standard
? Pick additional lint features: (Press to select, to toggle all, to invert selection)Lint on save
? Where do you prefer placing config for Babel, PostCSS, ESLint, etc.? In package.json
? Save this as a preset for future projects? (y/N)
进入到刚创建的vw-layout:
cd vw-layout
然后执行:
npm run serve
在浏览器执行http://localhost:8080，就可以看以默认的页面效果：
这时，可以看到的项目结构如下：
在vue-cli3中是没有.postcssrc.js和vue.config.js的，需要自己创建。
创建完成后需要安装以下插件
npm install postcss-import
npm install postcss-url
npm i postcss-aspect-ratio-mini postcss-px-to-viewport postcss-write-svg postcss-cssnext postcss-viewport-units cssnano --S
npm i cssnano-preset-advanced --save-dev
安装完成之后可以在package.json中查看是否安装成功
简单的说一下这几个插件。
postcss-import
postcss-import相关配置可以点击这里。目前使用的是默认配置。只在.postcssrc.js文件中引入了该插件。
postcss-import主要功有是解决@import引入路径问题。使用这个插件，可以让你很轻易的使用本地文件、node_modules或者web_modules的文件。这个插件配合postcss-url让你引入文件变得更轻松。
postcss-url
postcss-url相关配置可以点击这里。该插件主要用来处理文件，比如图片文件、字体文件等引用路径的处理。
在Vue项目中，vue-loader已具有类似的功能，只需要配置中将vue-loader配置进去。
postcss-cssnext
postcss-cssnext其实就是cssnext。该插件可以让我们使用CSS未来的特性，其会对这些特性做相关的兼容性处理。
cssnano
cssnano主要用来压缩和清理CSS代码。在Webpack中，cssnano和css-loader捆绑在一起，所以不需要自己加载它。不过你也可以使用postcss-loader显式的使用cssnano。
cssnano集成了一些其他的PostCSS插件，如果你想禁用cssnano中的某个插件的时候，可以像下面这样操作：
"cssnano": {
autoprefixer: false,
"postcss-zindex": false
}
上面的代码把autoprefixer和postcss-zindex禁掉了。前者是有重复调用，后者是一个讨厌的东东。只要启用了这个插件，z-index的值就会重置为1。这是一个天坑，千万记得将postcss-zindex设置为false。
postcss-px-to-viewport
postcss-px-to-viewport插件主要用来把px单位转换为vw、vh、vmin或者vmax这样的视窗单位，也是vw适配方案的核心插件之一。
postcss-aspect-ratio-mini
postcss-aspect-ratio-mini主要用来处理元素容器宽高比。在实际使用的时候，具有一个默认的结构
<div aspectratio>
<div aspectratio-content></div>
</div>
在实际使用的时候，你可以把自定义属性aspectratio和aspectratio-content换成相应的类名，比如：
<div class="aspectratio">
<div class="aspectratio-content"></div>
</div>
我个人比较喜欢用自定义属性，它和类名所起的作用是同等的。结构定义之后，需要在你的样式文件中添加一个统一的宽度比默认属性：
[aspectratio] {
position: relative;}[aspectratio]::before {
content: '';
display: block;
width: 1px;
margin-left: -1px;
height: 0;}[aspectratio-content] {
position: absolute;
top: 0;
left: 0;
right: 0;
bottom: 0;
width: 100%;
height: 100%;}
如果我们想要做一个188:246（188是容器宽度，246是容器高度）这样的比例容器，只需要这样使用：
[w-188-246] {
aspect-ratio: '188:246';}
有一点需要特别注意：aspect-ratio属性不能和其他属性写在一起，否则编译出来的属性只会留下aspect-ratio的值，比如：
<div aspectratio w-188-246 class="color"></div>
编译前的CSS如下：
[w-188-246] {
width: 188px;
background-color: red;
aspect-ratio: '188:246';}
编译之后：
[w-188-246]:before {
padding-top: 130.85106382978725%;}
主要是因为在插件中做了相应的处理，不在每次调用aspect-ratio时，生成前面指定的默认样式代码，这样代码没那么冗余。所以在使用的时候，需要把width和background-color分开来写：
[w-188-246] {
width: 188px;
background-color: red;
}
[w-188-246] {
aspect-ratio: '188:246';}
这个时候，编译出来的CSS就正常了：
[w-188-246]
{
width: 25.067vw;
background-color: red;}
[w-188-246]:before {
padding-top: 130.85106382978725%;}
postcss-write-svg
postcss-write-svg插件主要用来处理移动端1px的解决方案。该插件主要使用的是border-image和background来做1px的相关处理。比如：
@svg 1px-border {
height: 2px;
@rect {
fill: var(--color, black);
width: 100%;
height: 50%;
}
}
.example {
border: 1px solid transparent;
border-image: svg(1px-border param(--color #00b1ff)) 2 2 stretch;}
编译出来的CSS:
.example {
border: 1px solid transparent;
border-image: url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' height='2px'%3E%3Crect fill='%2300b1ff' width='100%25' height='50%25'/%3E%3C/svg%3E") 2 2 stretch;
}
上面演示的是使用border-image方式，除此之外还可以使用background-image来实现。比如：
@svg square {
@rect {
fill: var(--color, black);
width: 100%;
height: 100%;
}
}#example {
background: white svg(square param(--color #00b1ff));}
编译出来就是：
#example {
background: white url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg'%3E%3Crect fill='%2300b1ff' width='100%25' height='100%25'/%3E%3C/svg%3E");
}
CSS Modules
Vue中的vue-loader已经集成了CSS Modules的功能，个人建议在项目中开始使用CSS Modules。特别是在Vue和React的项目中，CSS Modules具有很强的优势和灵活性。建议看看CSS In JS相关的资料。在Vue中，使用CSS Modules的相关文档可以阅读Vue官方提供的文档《CSS Modules》。
postcss-viewport-units
postcss-viewport-units插件主要是给CSS的属性添加content的属性，配合viewport-units-buggyfill库给vw、vh、vmin和vmax做适配的操作。
这是实现vw布局必不可少的一个插件，因为少了这个插件，这将是一件痛苦的事情。后面你就清楚。
到此为止，有关于所需要的PostCSS已配置完。并且简单的介绍了各个插件的作用，至于详细的文档和使用，可以参阅对应插件的官方文档。
完整的.postcssrc.js代码如下：
module.exports = {
plugins: {
"postcss-import": {
},
"postcss-url": {
},
"postcss-aspect-ratio-mini": {
},
"postcss-write-svg": {
utf8: false
},
'postcss-px-to-viewport': {
unitToConvert: "px",
viewportWidth: 750, // 视窗的宽度，对应的是我们设计稿的宽度，一般是750
viewportHeight: 1334, // 视窗的高度，根据750设备的宽度来指定，一般指定1334，也可以不配置
unitPrecision: 3, // 指定`px`转换为视窗单位值的小数位数（很多时候无法整除）
viewportUnit: 'vw', // 指定需要转换成的视窗单位，建议使用vw
fontViewportUnit: "vw",
selectorBlackList: ['.ig-'], // 指定不转换为视窗单位的类，在该类型名下写不会转换为vw，可以无限添加,建议定义一至两个通用的类名
minPixelValue: 1, // 小于或等于`1px`不转换为视窗单位，你也可以设置为你想要的值
mediaQuery: false, // 允许在媒体查询中转换`px`
replace: true,
exclude: /(\/|\\)(node_modules)(\/|\\)/
},
'postcss-viewport-units': {
filterRule: rule => rule.selector.includes('::after') && rule.selector.includes('::before')
},
"cssnano": {
"cssnano-preset-advanced": {
zindex: false,
autoprefixer: false
},
}
}
}
vw兼容方案
使用viewport的polyfill：Viewport Units Buggyfill。使用viewport-units-buggyfill主要分以下几步走：
方法一
1.引入JavaScript文件
viewport-units-buggyfill主要有两个JavaScript文件：viewport-units-buggyfill.js和viewport-units-buggyfill.hacks.js。你只需要在你的HTML文件中引入这两个文件。比如在Vue项目中的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>
你也可以使用其他的在线CDN地址，也可将这两个文件合并压缩成一个.js文件。这主要看你自己的兴趣了。
2.在HTML文件中调用viewport-units-buggyfill，比如：
<script>
window.onload = function () {
window.viewportUnitsBuggyfill.init({
hacks: window.viewportUnitsBuggyfillHacks
});
}</script>
方法二
1.使用npm 安装npm install viewport-units-buggyfill
2.在main.js中
//vw 兼容适配
const hacks = require('viewport-units-buggyfill/viewport-units-buggyfill.hacks');
const viewportUnitsBuggyfill = require('viewport-units-buggyfill');
viewportUnitsBuggyfill.init({
hacks, });
Viewport Units Buggyfill还提供了其他的功能。详细的这里不阐述了。但是content也会引起一定的副作用。比如img和伪元素::before(:before)或::after（:after）。在img中content会引起部分浏览器下，图片不会显示。这个时候需要全局添加：
img {
content: normal !important;}
到了这个时候，你就不需要再担心兼容问题了。
总结
如果你看到这里了，希望这篇文章对你有所帮助。能帮助你解决项目中的实际问题，让你不再担心移动端的适配问题。当然更希望的是你在实际的项目中用起这个方案，把碰到的问题及时反馈给偶。如果你有更好的方案，欢迎在下面的评论中与我们一起分享。