close
  • 简体中文
  • Rspack 内置 CSS

    pluginRspackBuiltinCss 是一个实验性插件,用 Rspack 内置的 css/* 模块类型替代 css-loaderstyle-loaderCssExtractRspackPlugin

    rsbuild.config.ts
    import { pluginRspackBuiltinCss } from '@rsbuild/core';
    
    export default {
      plugins: [pluginRspackBuiltinCss()],
    };

    插件会保留 PostCSS、Lightning CSS、Sass、Less 等插件添加的 loader。

    CSS Modules

    通过 output.cssModules 配置 CSS Modules。插件支持:

    • auto:布尔值
    • exportLocalsConvention
    • localIdentName
    • modelocalglobalpure
    • namedExport

    以下配置暂不支持,并会输出警告:

    • auto 的正则和函数值
    • exportGlobals
    • modeicss 和函数值

    对于 output.cssModules 未覆盖的 Rspack parser 和 generator 配置,可以通过插件参数设置:

    rsbuild.config.ts
    import { pluginRspackBuiltinCss } from '@rsbuild/core';
    
    export default {
      plugins: [
        pluginRspackBuiltinCss({
          parser: {
            url: false,
            import: false,
          },
          generator: {
            localIdentHashSalt: 'custom-salt',
          },
        }),
      ],
    };

    parser 支持 exportTypeurlimportresolveImportanimationcontainercustomIdentsdashedIdentsfunctiongrid

    generator 支持 esModulelocalIdentHashDigestlocalIdentHashDigestLengthlocalIdentHashFunctionlocalIdentHashSalt

    暂不支持 CSS ?url 导入。