本文小编为大家详细介绍“webpack5新特性Asset Modules资源模块怎么用”,内容详细,步骤清晰,细节处理妥当,希望这篇“webpack5新特性Asset Modules资源模块怎么用”文章能帮助大家解决疑惑,下面跟着小编的思路慢慢深入,一起来学习新知识吧。
webpack
可以将很多类型的文件写入最后打包的js
文件,写入的方法有两种,一个是 Asset Modules
另一个是 Loaders
这一篇我们就来讨论 Asset Modules
。Asset Modules
(资源模块)是webpack5
的新特性,它允许使用资源文件(字体,图标等)而无需配置额外 loader, webpack低版本的处理方式以及详情参考官方文档。
资源模块类型(asset module type),通过添加 4 种新的模块类型, 下面引入官文的一部分来直接介绍。
asset/resource
发送一个单独的文件并导出 URL。之前通过使用file-loader
实现。asset/inline
导出一个资源的 data URI。之前通过使用url-loader
实现。asset/source
导出资源的源代码。之前通过使用raw-loader
实现。asset
在导出一个 data URI 和发送一个单独的文件之间自动选择。之前通过使用url-loader
,并且配置资源体积限制实现。
图片打包(asset/resource)
将一张图片(jpg/png/jpeg)放在工程文件夹里, 然后写一个加载图片的函数,生产一个图片元素,设置其src等属性,再挂载到body上。文件目录如下
src/ addImg.js cat.jpeg index.js
addImg.js
的内容如下
import CatImg from './cat.jpeg';function addImg () { const img = document.createElement('img'); img.alt = 'Cat'; img.width = 300; img.src = CatImg; const body = document.querySelector('body'); body.appendChild(img);}export default addImg;
这里import
一个jpeg
后缀的文件,webpack
是不知道该如何处理的,我们需要通过wepack.config.js
配置
module.exports = { entry: './src/index.js', output: { filename: 'bundle.js', path: path.resolve(__dirname, './dist') }, mode: 'none', module: { rules: [ { test: /\.(png|jpg|jpeg)/, type: 'asset/resource' } ] }}
npm run build
之后在浏览器打开html文件,会发现图片已经在页面上渲染了,再观察打包之后的dist文件夹,图片数据也在其中,这就是以assert/resource
方式打包的结果,简单讲图片打包进入了dist
文件夹, 这和后边的asset/inline
(后面会介绍)的方式有直接区别。
publicPath
刚才打包的结果,如果打开浏览器控制台,可以看见img元素的src地址指向了一个本地的绝对路径
这个路径是如何指定的呢?是通过output
属性下的publicPath
, 其默认值是 "auto"
, 可以试一下配置了是通过output属性下的publicPath: "auto"
和刚才的打包结果是一样的,那么如果想使用相对路径,在本例中用html文件的相对路径去指定图片的src publicPath: 'dist/'
,打包后同样可以成功渲染图片,但是观察其img的src的指向已经发生了变化,使用的相对路径。
比如实际项目,静态资源会打包到cdn
服务器上,那么可以配置 publicPath
为一个具体的cdn
地址,如 http://somecdn.com/someasset/
, 那么其静态资源路径前缀就会是这个地址。
asset/inline 模块
接着上面的部分,inline
主要区别的于 resource
是打包的结果,inline会将文件直接以base64
的方式写入最后产出的bundle.js 一般情况下,对于一些svg
文件使用inline
的方式打包是比较合理的,当然对于较大的图片也不是不行,只不过最后bundle.js的体积会变大,这在生产环境不是很理想。
改写对于图片类数据打包的方式为 type: 'asset/inline'
可以从控制台看出打出的包体积变大了,且打开bundle.js看的话会看见base64
的部分
那么结论就是这两种打包方式各有利弊,inline虽然把数据写入到js
文件中,但也减少了一次网络请求。还是要根据实际的生产需求来决策,理论上一些小的sv
g要写到bundle
中,而大图是分包部署在cdn
服务上比较合理。
asset 模块
上面的两种设定都指定了一种绝对的方法,那么有没有更灵活的方式呢?就是asset
类型的处理方式。将图片文件处理的方式改为 type: 'asset'
, 这会根据资源的大小来决定是以inline的方式还是以recource的方式进行打包,其默认值阀值是8kb
, 如果文件大小小于8kb
,那么文件将以inline
的方式进行打包,反之则相当于recource
的方式。当然我也可以改写阈值:
module: { rules: [ { test: /\.(png|jpg|jpeg)/, type: 'asset', parser: { dataUrlCondition: { maxSize: 3 * 1024 // 3kb } } } ] }
asset/source 模块
source
类型一般处理一些文本数据,可以将内容处理成JS
的string
数据,比如处理txt
文件, webpack配置如下
catAlt.txt 文件只有一段字符串
文件引入并以字符串形式调用
可以执行打包看最后的结果,txt
里的内容以字符串的形式插入到了img.alt
属性上
读到这里,这篇“webpack5新特性Asset Modules资源模块怎么用”文章已经介绍完毕,想要掌握这篇文章的知识点还需要大家自己动手实践使用过才能领会,如果想了解更多相关内容的文章,欢迎关注编程网行业资讯频道。