怎么搭建按需加载的Vue组件库
小编给大家分享一下怎么搭建按需加载的Vue组件库,相信大部分人都还不怎么了解,因此分享这篇文章给大家参考一下,希望大家阅读完这篇文章后大有收获,下面让我们一起去了解一下吧!
按需加载的原理
按需加载,本质上是把一个组件库的不同组件 拆分成不同文件 ,按照需要引用对应的文件,而该文件暴露一个 install方法 ,供Vue.use使用。 比如:我只想引用element库里的一个Button组件
importButtonfrom'element-ui/lib/Button.js' importButtonfrom'element-ui/lib/theme-chalk/Button.css' Vue.use(Button);
上面的写法比较繁琐,而且需要知道每个组件的实际路径,使用起来并不方便,所以我们还需要借助一个转换插件。
先来看看 element 是怎么做的,官方的的「快速手上」:
element使用一个了babel插件,作用就是代码转换:
import{Button}from'components' //转换为 varbutton=require('components/lib/button') require('components/lib/button/style.css')
到这我们可以知道,要搭建一个按需加载的组件库。 主要工作 需要两点:
组件独立打包 ,单个文件对应单个组件
引入 代码转换 的插件
组件代码的编写规范
我们在项目的跟目录建一个文件夹packages,下面放我们的组件:
packages下每一个文件夹对应一个组件所需要的资源,在index.js定义组件的install方法。而packages/index.js存放了在全量加载时用的install方法
packages/Button/index.js:
importButtonfrom'./src/main'; Button.install=function(Vue){ Vue.component(Button.name,Button); }; exportdefaultButton;
packages/Button/src/main.vue:
我是一个Button组件
packages/index.js:
importButtonfrom'./Button'; importLoadingfrom'./Loading'; importLoadMorefrom'./LoadMore'; constcomponents=[ Button, LoadMore, Loading ]; constinstall=function(Vue){ components.forEach(component=>{ Vue.component(component.name,component); }); } if(typeofwindow!=='undefined'&&window.Vue){ install(window.Vue) } exportdefault{ install,//全量引入 Button, LoadMore, Loading };
webpack配置
组件代码写好了,接下来需要配置一下webpack的打包逻辑。我们复用vue-cli生成的模板,在上面做一些必要更改:
多入口
每个组件独立生成一个对应的js和css,这就需要我们在入口处就把组件的引用定义好:
webpack.prod.conf.js:
constentrys={ Button:path.resolve(__dirname,'../packages/Button'), index:path.resolve(__dirname,'../packages') }; constwebpackConfig=merge(baseWebpackConfig,{ entry:entrys, //...... });
上述配置每增加一个组件都需要修改entrys,我们可以优化一下,使其 动态生成 :
webpack.prod.conf.js:
constentrys=require(./getComponents.js)([组件目录入口]); constwebpackConfig=merge(baseWebpackConfig,{ entry:entrys, ...... });
getComponents.js:
constfs=require('fs'); constpath=require('path'); /** *判断刚路径是否含有index.js *@param{String}dir */ functionhasIndexJs(dir){ letdirs=[]; try{ dirs=fs.readdirSync(dir); }catch(e){ dirs=null; } returndirs&&dirs.includes('index.js'); } /** *获取指定入口和入口下包含index.js的文件夹的路径 *@param{String}entryDir */ constgetPath=function(entryDir){ letdirs=fs.readdirSync(entryDir); constresult={ index:entryDir }; dirs=dirs.filter(dir=>{ returnhasIndexJs(path.resolve(entryDir,dir)); }).forEach(dir=>{ result[dir]=path.resolve(entryDir,dir); }); returnresult; } module.exports=getPath;
修改webpack的输出
默认生成的js文件并不支持ES6引入,在这里我们设置成 umd
output:{ path:config.build.assetsRoot, filename:utils.assetsPath('[name].js'), library:'LoadOnDemand', libraryTarget:'umd' },
配置 babel-plugin-component -D
上面的组件库打包发布到npm上之后。我们在使用的时候npm install babel-plugin-component -D之后,修改一下.babelrc.js:
"plugins":[ [ "component", { "libraryName":"load-on-demand",//组件库的名字 "camel2Dash":false,//是否把驼峰转换成xx-xx的写法 "styleLibrary":{ "base":false,//是否每个组件都默认引用base.css "name":"theme"//css目录的名字 } } ] ],
这里提一下属性 camel2Dash ,默认是开启的,开启状态下假如你的组件名是vueCompoent,引用的css文件会变成vue-component.css。
以上是“怎么搭建按需加载的Vue组件库”这篇文章的所有内容,感谢各位的阅读!相信大家都有了一定的了解,希望分享的内容对大家有所帮助,如果还想学习更多知识,欢迎关注恰卡编程网行业资讯频道!
推荐阅读
-
vue表格组件教程学习(vue proxytable只能在开发环境跨域吗)
vueproxytable只能在开发环境跨域吗?跨域问题来源于JavaScript的同源策略,即只有协议主机名端口号(如...
-
Vue组件的自定义事件和全局事件总线怎么使用
Vue组件的自定义事件和全局事件总线怎么使用这篇“Vue组件的自定...
-
vue中消息订阅与发布如何使用
vue中消息订阅与发布如何使用这篇文章主要介绍“vue中消息订阅与...
-
Vue显示图片的方式有哪些
Vue显示图片的方式有哪些这篇文章主要介绍“Vue显示图片的方式有...
-
vue引入静态jquery报错如何解决
vue引入静态jquery报错如何解决这篇文章主要介绍“vue引入...
-
vue-cropper怎么实现裁剪图片
-
怎么用Vue+NodeJS实现大文件上传
怎么用Vue+NodeJS实现大文件上传本文小编为大家详细介绍“怎...
-
Vue如何实现简易跑马灯效果
Vue如何实现简易跑马灯效果本文小编为大家详细介绍“Vue如何实现...
-
Vue怎么指定不编译的文件夹和favicon.ico
Vue怎么指定不编译的文件夹和favicon.ico这篇文章主要介...
-
Vue中的插槽怎么使用