cssLoader

  • 类型: Object | Function
  • 默认值: undefined

通过 tools.cssLoader 可以修改 css-loader 的配置项。默认配置如下:

{
  modules: {
    auto: true,
    exportLocalsConvention: 'camelCase',
    localIdentName: rsbuildConfig.output.cssModules.localIdentName,
    // isServer 表示 node (SSR) 构建
    // isWebWorker 表示 web worker 构建
    exportOnlyLocals: isServer || isWebWorker,
  },
  sourceMap: rsbuildConfig.output.sourceMap.css,
  // importLoaders 在编译 css 文件时为 `1`,在编译 sass/less 文件时为 `2`
  importLoaders: 1 || 2,
}
TIP

在使用 Rspack 作为打包工具时,仅支持在 injectStyles 时使用该配置。

修改 CSS Modules 相关配置,推荐使用 output.cssModules 配置项。

Object 类型

当此值为 Object 类型时,会与默认配置进行深层合并 (deep merge)。比如:

export default {
  tools: {
    cssLoader: {
      modules: {
        exportOnlyLocals: true,
      },
    },
  },
};

Function 类型

当此值为 Function 类型时,默认配置作为第一个参数传入,你可以直接修改配置对象,也可以返回一个对象作为最终配置。比如:

export default {
  tools: {
    cssLoader: (config) => {
      config.modules.exportOnlyLocals = true;
      return config;
    },
  },
};