「使用 webpack 5 从0到1搭建React + TypeScript 项目环境」3. 资源模块

2022-10-24 18:31:45 浏览数 (1)

「使用 webpack 5 从0到1搭建React TypeScript 项目环境」3. 资源模块

资源模块(asset module)是一种模块类型,它允许使用资源文件(字体,图标等)而无需配置额外 loader

webpack 5 之前,通常使用:

  • raw-loader 将文件导入为字符串
  • url-loader 将文件作为 data URI 内联到 bundle
  • file-loader 将文件发送到输出目录

资源模块类型(asset module type),通过添加 4 种新的模块类型,来替换所有这些 loader

  • asset/resource 发送一个单独的文件并导出 URL。之前通过使用 file-loader 实现。
  • asset/inline 导出一个资源的 data URI。之前通过使用 url-loader 实现。
  • asset/source 导出资源的源代码。之前通过使用 raw-loader 实现。
  • asset 在导出一个 data URI 和发送一个单独的文件之间自动选择。之前通过使用 url-loader,并且配置资源体积限制实现。

当在 webpack 5 中使用旧的 assets loader(如 file-loader/url-loader/raw-loader 等)和 asset 模块时,你可能想停止当前 asset 模块的处理,并再次启动处理,这可能会导致 asset 重复,你可以通过将 asset 模块的类型设置为 'javascript/auto' 来解决。

接下来我们简单介绍一下如何配置,详细请看资源模块 | webpack 中文文档 (docschina.org)

我们在webpack.config.common.js中添加如下配置:

代码语言:javascript复制
{
    test: /.(png|jpg|jpeg|gif|woff|woff2|eot|ttf|otf)$/i,
    type: "asset/resource",
    generator: {
     filename: 'static/[hash][ext][query]'
    },
},

接下来我们在src/index.tsx中引入图片:

代码语言:javascript复制
import React from 'react';
import ReactDOM from 'react-dom';
import jpg from './assets/picture.jpg'

const App = () => {
  return (
    <>
      <p>hello world</p>
      <img src={jpg} alt="" width='100px' height='100px'/>
    </>
  );
};

ReactDOM.render(
  <React.StrictMode>
    <App />
  </React.StrictMode>,
  document.getElementById("root")
);

由于这里我们通过 ES6 的方式导入图片,为了使 TypeScript 可以识别图片模块,我们需要在src/typings.d.ts中加入以下内容:

代码语言:javascript复制
declare module "*.svg";
declare module "*.png";
declare module "*.jpg";
declare module "*.jpeg";
declare module "*.gif";
declare module "*.bmp";
declare module "*.tiff";

通过yarn build打包后,打开html文件查看我们可以看到图片资源已生效:

image-20220112204539791

至此,我们已经可以在代码里引入图片和字体资源了

0 人点赞