element-ui的按需引入的配置:文档地址

  1. npm install babel-plugin-component -D
  1. {
  2. "presets": [["es2015", { "modules": false }]],
  3. "plugins": [
  4. [
  5. "component",
  6. {
  7. "libraryName": "element-ui",
  8. "styleLibraryName": "theme-chalk"
  9. }
  10. ]
  11. ]
  12. }
  1. import Vue from 'vue';
  2. import { Button, Select } from 'element-ui';
  3. import App from './App.vue';
  4. Vue.component(Button.name, Button);
  5. Vue.component(Select.name, Select);

三步下来就能方便的使用按需引入的功能了。

其中的原理是什么?babel-plugin-component在其中做了什么?

首先新建一个demo,使用最简化的配置,demo地址

demo中只用了四种钩子:

Program:第一个访问的节点,初始化数据。

ImportDeclaration:处理import import { Button, Select } from 'element-ui';

CallExpression:函数执行会访问到,处理Vue.component(Button.name, Button);

MemberExpression:处理对象访问,Select.name

总结一下处理的过程:

在Program初始化specified等数据,在处理当前文件的过程中这些数据作为全局使用。

在 ImportDeclaration 里将收集import的变量,比如Button,Select等

  1. import { Button, Select } from 'element-ui'

将变量存储到specified中,这个specified会作为后面处理AST的判断条件

  1. specified[spec.local.name] = spec.imported.name

在CallExpression中,根据是否使用到Button等会在AST添加节点,这些节点会转换为下面的代码:

  1. import button form "element-ui/lib/button"

添加节点这个环节使用到@babel/helper-module-imports中的helper方法addSideEffect,addDefault,简化了手动操作。

简单介绍一下helper-module-imports:文档链接

调用addSideEffect方法能够生成类似 import "source"的代码,适合添加css等资源。

调用addDefault方法能够生成类似import _default from "source"的代码,适合添加js。

上面三步之后,想要的AST就构建完成了。以demo为例,源代码:

  1. import { Button } from 'element-ui';
  2. Vue.component(Button.name,Button)

执行npm run build ,babel处理之后的代码是:

  1. var _button = _interopRequireDefault(require("element-ui/lib/theme-chalk/button.css"));
  2. require("element-ui/lib/theme-chalk/base.css");
  3. var _button2 = _interopRequireDefault(require("element-ui/lib/button"));
  4. function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
  5. Vue.component(_button2["default"].name, _Button);

可以看到自动引入了css require("element-ui/lib/theme-chalk/base.css"),引入element-ui不见了,增加了require("element-ui/lib/button")

需要解释一下,上面的import变成了require是因为babel中presets-env的影响;同理_interopRequireDefault也是。

如果在babel.config.json设置modules:false结果将是下面的样子:

  1. import _Button2 from "element-ui/lib/theme-chalk/button.css";
  2. import "element-ui/lib/theme-chalk/base.css";
  3. import _Button from "element-ui/lib/button";
  4. Vue.component(_Button.name, _Button);
  5. // 看起来顺眼多了

在自己检查代码时发现第一个demo的结果Vue.component(_button2["default"].name, _Button);中的_Button是一个错误,代码中没有这个引用,执行起来肯定是要报错的;仔细查看了plugin.js并没有发现问题。当换成直接引入babel-plugin-component的时候就没有了问题,通过对比终于发现@babel/helper-module-imports的版本不同,

  • babel-plugin-component 内部node_modules中依赖的 @babel/helper-module-imports 版本7.0.0
  • 跟随helper-module-transforms一起安装的是7.10.4

切换到版本7.0.0就可以了。

版本问题能够通过修改plugin.js来解决么?看下面的代码:

  1. function importMethod(methodName, file, opts) {
  2. if (!selectedMethods[methodName]) {
  3. ....
  4. selectedMethods[methodName] = addDefault(file.path, path, { nameHint: methodName });
  5. ....
  6. }
  7. // ....
  8. return selectedMethods[methodName];
  9. }

在对Vue.component(Button.name, Button)的访问中需要对参数Button做两次处理,都需要执行到importMethod方法,methodName的值就是"Button",按照执行逻辑两次执行返回的是同一的对象:

  1. {
  2. type:"Identifier",
  3. name:"_Button"
  4. }

生成代码的时候应该是 Vue.component(_button2["default"].name, _button2["default"]),这里却好像把第二个_Button给忘了,猜测难道此处的引用传值导致的么?

考虑到通过一个简单的对象能生成_button2["default"],说明自己也可以创建一个对象生成对应的代码,于是就简单的deepClone一下selectedMethods[methodName],试过之后果然可以,此处并没有查找到真正的原因,只作为探索,代码如下:

  1. function importMethod(methodName, file, opts) {
  2. if (!selectedMethods[methodName]) {
  3. ....
  4. selectedMethods[methodName] = addDefault(file.path, path, { nameHint: methodName });
  5. ....
  6. }
  7. // ....
  8. // 此处的t是types,带有一个cloneDeep的方法
  9. return t.cloneDeep(selectedMethods[methodName]);
  10. }

其实在打断点的时候发现,最终生成生成的AST是正确的,错在代码生成的阶段,经过尝试发现直接把modules:false就可以避免问题。一般来说我们都要把babel的模块处理取消掉,由webpack来处理模块打包,所以这个方案更加合适。

查看有哪些钩子 :地址

babel中插件的执行顺序:插件执行顺序

本文只介绍了四个钩子,原插件还使用了IfStatement,ConditionalExpression,LogicalExpression,VariableDeclarator,Property,ArrayExpression,AssignmentExpression七个钩子,这几个钩子主要是处理特殊的情况,暂时还未遇到。

最后如有错误之处,望指正

版权声明:本文为walkermag原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/walkermag/p/13382627.html