之前的项目中我们打包的对象都是JS文件,那假设我们需要import一个图片应该怎么做呢,如果仍然使用之前的方式进行打包就会报错:
Module parse failed:Unpexpected character ...很明显webpack不能识别图片文件,这里就需要借助loader来告诉webpack如何打包图片文件了
Loader就是一种打包方案,对于某一种类型文件他知道如何打包,帮助webpack完成打包工作。
如果你写过vue,肯定写过类似的语句
import Header from './header.vue'我们需要给之前的webpack配置文件中加入一个module字段,并新增一个rules数组来增加规则:
const path = required('path') module.exports = { mode:'development', entry:{ main:'./src/index.js' }, module:{ rules:[{ test:/\.jpg$/, use:{ loader:'file-loader } }] }, output:{...} }上述其实就是制定了一个规则,告诉webpack遇到以.jpg结尾的文件时候使用file-loader去处理。
这里别忘了先把file-loader安装到项目中:
npm install file-loader -D这样重新npm run bundle就可以看到dist目录下面多出了一个图片文件。
file-loader底层做了这些:当他发现你这边图片文件要打包,首先会把图片移动到dist目录下面去 并改一个名字(名字可以自己定义),然后会得到图片相对于dist目录的一个名称,然后返回给引入模块的变量之中。
file-loader理论上可以处理任何静态资源,例如excel,jpg,png,他实际上就是移动位置然后把新地址返回给变量,只要你的test字段写好就可以。 借助这一点我们尝试把静态资源放到网页上:
import avatar from './avatar.jpg' const img = new Image(); img.src = avatar; .... root.append(img)这里我们继续扩展之前的内容,了解如何对loader进行一些自定义配置和使用。
默认使用file-loader会更改图片文件名称,但是我们希望保持原名该怎么做呢?
这里可以通过对该loader进行配置解决:
... module:{ rules:[{ test:/\.jpg$/, use:{ loader:'file-loader', options:{ name:'[name].[ext]' // 记得包单引号 } } }] } ...这里的[name],[ext]是loader提供的占位符,具体value可以参考对应loader的文档,上述name和ext分别表示处理文件的名称和后缀
大家应该联想到解决方法了,直接修改test字段匹配到更多的图片类型即可:
test:/\.(jpg|png|gif)$/这里可以再添加一个outputPath配置项:
use:{ loader:'file-loader', options:{ name:... outputPath:'images/' } }这里你可能会在其他webpack资料里面看到使用url-loader来对图片进行打包。
这里目前来说url-loader是可以代替file-loader来打包图片文件。
区别在于url-loader是将图片转换为base64存放在bundle.js文件中,而非放到dist目录下。
file-loader的特点:
可以指定要复制和放置资源文件的位置,以及如何使用版本哈希命名以获得更好的缓存。你可以就近管理图片文件,可以使用相对路径而不用担心部署时 URL 的问题。使用正确的配置,webpack 将会在打包输出中自动重写文件路径为正确的 URL。url-loader的特点:
允许你有条件地将文件转换为内联的 base-64 URL (当文件小于给定的阈值),这会减少小文件的 HTTP 请求数。如果文件大于该阈值,会自动的交给 file-loader 处理。目前的最佳时间就是使用url-loader将一些几KB的小图片打包到JS文件中,而大图片移动到dist目录下,保证bundle.js尽快加载完成。
这里你需要配置的就是一个阈值,保证不同区间使用不同策略:
use:{ loader:'url-loader', options:{ ... limit:2048 } }上述表示小于2KB的会打包到bundle,否则就利用file-loader移动到dist目录
项目中通常都会有css文件负责管理样式,直接webpack打包同样无法解析,需要利用loader来处理。
这里我们针对css文件新增一个rule并使用对应loader来解析
module:{ rules:[{...},{ test:/\.css$/, use:['style-loader','css-loader'] }] }然后npm安装一下之后浏览器就可以正常显示了。
接着我们说明一下这两个loader的作用。
css-loader会帮助我们分析多个css文件之间的关系,然后把多个css文件合并成一个css。
style-loader会将上述合并后的css文件挂载在文件的header上面:
<head> ... <style>.avatar{ width:150px; } </style> ... </head>所以在使用css-loader时候需要配合style-loader来使用才行
我们可以使用postcss-loader来补足样式中诸如webkit这种前缀,默认打包是没有的:
transform: webkit-translate(100px,100px)这个loader还要求我们在目录下创建一个postcss.config.js文件,这里对其进行一些配置:
//postcss.config.js module.exports = { plugins:[ require('autoprefixer') ] //使用了一些插件 }需要执行npm install autoprefixer -D来安装插件。然后重新进行一次打包
这里我们可以先写一个有scss特殊语法的文件:
body{ .avatar{ ... } }这里直接修改test匹配规则也是没用的,最终会发现页面挂在的还是scss语法的style,没有进行解析:
<style> body{ .avatar{ ... } } </style>这里还需要借助sass-loader来处理,这里还需要安装node-sass模块来进行解析(这部分官网文档有说明):
npm install sass-loader node-sass -Dless需要使用less-loader,具体使用方式和上述类似
这里继续扩展讲一下css-loader
该配置参数用于css中的一些间接引用的情况:
{ test:/\.scss$/, use:[ 'style-loader', { loader:'css-loader', options:{ importLoaders:2 } }, 'sass-loader', 'postcss-loader' ] }我们在一个index.scss文件里面引入一个新的scss文件:
// index.scss @import './avatar.scss' ...这个时候其实是index.js引用了index.scss,间接引用了avatar.scss,这个时候你引入的scss就有可能不会使用下面的postcss-loader和sass-loader了,如果你希望间接引用的也适用这些loaders,就需要这个配置项,importLoaders:2意味着无论直接引用还是间接引用都会从下到上再使用2个loader!
上述配置的CSS其实是全局共享的,这样很容易导致样式冲突,我们可以配置来保证CSS只在import引入的JS文件中起作用:
{ test:/\.scss$/, use:[ 'style-loader', { loader:'css-loader', options:{ importLoaders:2, modules:true } }, 'sass-loader', 'postcss-loader' ] }这里有时候我们希望项目能展示一些第三方字体,就需要引入字体文件,基于上述打包图片和样式的思路,我们其实直接借助file-loader就行了:
{ test:/\.(eot|ttf|svg)$/, use:{ loader:'file-loader' } }注意webpack里面use的loader是有先后顺序的,从下倒上,从右到左,例如上面的例子当中我们是先执行sass-loader,把scss转成css,然后css-loader打包为一个css,最后style-loader进行挂载
loader主要是解析不同类型的文件,而plugin则是提供一些额外的功能。
其实plugin可以在webpack运行到某个时刻的时候帮你自动做一些事情,有些类似React或vue生命周期函数的概念~
官网推荐的webpack插件有几十个,还有很多第三方插件也有很多功能,没必要一个个学,当我们想实现一些功能可以先搜索,找找有没有方便的插件或者配置
这里我们希望解决一个实际问题,之前我们的dist目录下的HTML文件其实都是手动拷贝过去的,有没有工具能自动完成这个。
这里就可以借助html-webpack-plugin,首先npm install一下:
npm install html-webpack-plugin -D接着我们在配置文件中引入plugin:
module.exports = { mode:'development', entry:{...}, module:{ rules:[...] }, plugins:[new HtmlWebpackPlugin()], output:{...} }接着我们重新打包,该插件会在打包结束之后自动生成一个html文件,并自动包含对应的JS文件。
但是我们会发现界面上面啥也没有,这是因为我们之前的代码逻辑是找到id为root的DOM节点,然后插入一个div节点,但是打包生成的没有这个root。
这里我们可以通过编写一个template文件,来用作插件自动生成的HTML文件的模板:
... <body> <div id='root'></div> </body>然后我们配置:
plugins:[new HtmlWebpackPlugin({ template:'src/index.html' })]接着重新打包就会生成包含root节点的的index.html
有时候我们修改了一下output的文件名,但是打包之后我们发现有新的dist.js文件了,但是bundle.js文件还在,没有删除,我们希望能够把dist目录删除然后再执行打包工作,这时候就可以用这个插件。
注意这个插件不是官方推荐插件,官网搜不到,这里直接安装:
npm install --save-dev clean-webpack-plugin然后添加到plugins数组:
plugins:[ new HtmlWebpackPlugin({...}), new CleanWebpackPlugin(['dist']) ]参数是要删除的目录名