Webpack实现Vue行内样式px转vw的Loader开发指南

需求背景

需求

借助PostCSS处理CSS文件，可以高效完成网站适配开发。只需调整参数，样式按设计稿的px编写，Webpack编译时即可自动转换为rem或vw等单位。

然而，标签内部的行内样式px该如何处理？PostCSS并未提供转换此类样式的功能。

探索与思路

探索

启动思路

在进行Vue项目开发时，遇到了上述需求。例如，期望代码能根据设定的基准值自动转换为vw单位。


<h3 style="font-size: 28px;margin-top: 10px" width="500px">Test</h3>

我希望他能根据我设置的基准值自动转换成vw。


<h3 width="00vw" style="font-size: 00vw; margin-top: 00vw;">Test</h3>

实现这一功能离不开编译工具Webpack。Webpack提供loader和plugin两种机制，究竟选择哪一种？通过查阅资料，我从一篇关于将React内联样式px转换为rem的文章中获得了灵感。

没错，就是webpack-loader

编写一个Webpack Loader，在编译阶段读取Vue文件内容，通过正则表达式识别需要转换的px值，再通过公式将其转换为vw。

实现步骤

开始行动

1、了解loader的实现原理

编写Loader非常简单，主要逻辑是接收source参数，执行处理操作，最后返回处理后的source。这里的source对应每个被Loader匹配到的文件。


module.exports = function (source) {
 // 干些坏事
 return source
}

2、如何让loader干坏事

首先观察一个简单的Vue文件，通常包含三个部分：<template>、<script>和<style>。


<template>
 <div>
  <h3 style="font-size: 28px;margin-top: 10px" width="500px">Test</h3>
 </div>
</template>

<script>
 export default {
  name: '',
  components: {},
  created () {},
  mounted () {},
  methods: {}
 }
</script>

<style lang="less">
 h3 {
  font-size: 20px;
 }
</style>

已知<style>部分已由PostCSS处理转换，因此我们将重点放在<template>内部的“00px”行内样式上。

实际上，source对应的就是一个完整的Vue文件。在该示例中，28px、10px和500px是需要转换的目标值，首先使用正则表达式将它们全部提取出来。

先提取template部分，以防止误转换style部分的内容。


const template = /<template>([\s\S]+)<\/template>/gi

// 匹配出来的部分
<template>
 <div>
  <h3 style="font-size: 28px;margin-top: 10px" width="500px">Test</h3>
 </div>
</template>

匹配px的正则


const ZPXRegExp = /(\d+)px/

对template里面的px进行转换


module.exports = function (source) {
 let _source = ''
 // 如果当前的source里面存在template
 if (template.test(source)) {
  // 匹配template部分
  _source = source.match(template)[0]
 }
 // 匹配出template里面的px
 let pxGlobalRegExp = new RegExp(ZPXRegExp.source, 'ig')
 if (pxGlobalRegExp.test(_source)) {
  // px转换vw，核心部分
  let $_source = _source.replace(pxGlobalRegExp, createPxReplace(defaults.viewportWidth, defaults.minPixelValue, defaults.unitPrecision, defaults.viewportUnit))
  // 转换之后替换回source中，返回函数值
  return source.replace(template, $_source)
 } else {
  //没有就不转，直接返回
  return source
 }
}

px转vw的公式

这里使用的是postcss-px-to-viewport内部实现的转换公式。


function createPxReplace (viewportSize, minPixelValue, unitPrecision, viewportUnit) {
 // 不用好奇$0, $1是怎么来的，他们是replace第二个参数提供的
 return function ($0, $1) {
  if (!$1) return
  var pixels = parseFloat($1)
  if (pixels <= minPixelValue) return
  return toFixed((pixels / viewportSize * 100), unitPrecision) + viewportUnit
 }
}
function toFixed (number, precision) {
 var multiplier = Math.pow(10, precision + 1),
  wholeNumber = Math.floor(number * multiplier)
 return Math.round(wholeNumber / 10) * 10 / multiplier
}

使用和postcss-px-to-viewport类似的配置

一个基本的配置大概包含这些信息


let defaultsProp = {
 unitToConvert: 'px',
 viewportWidth: 750,
 unitPrecision: 5,
 viewportUnit: 'vw',
 fontViewportUnit: 'vw',
 minPixelValue: 1
}

给webpack-loader加上option


const loaderUtils = require('loader-utils')

const opts = loaderUtils.getOptions(this)
const defaults = Object.assign({}, defaultsProp, opts)

好了，现在我们实现了一个可以干坏事的loader，😯不，是做好事！

我们来看看转换成果


<h3 width="66.66667vw" style="font-size: 3.73333vw; margin-top: 1.33333vw;">Test</h3>

反思与总结

反思

虽然实现了最初的需求，但心中仍存疑虑，因为还有一些潜在问题未完全理清。后续若有所悟，再进行完善。

源码

style-vw-loader

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持本站。

使用Webpack Loader实现Vue行内样式px转vw

需求背景

探索与思路

实现步骤

反思与总结

实用工具推荐