tools.styledComponents

    • 类型: Object | Function | false
    • 默认值:
    {
      displayName: true,
      // 在 SSR 构建中 isSSR 为 true
      ssr: isSSR,
      // 在生产环境构建时启用 `pure` 来优化包体积
      pure: isProd,
      transpileTemplateLiterals: true,
    }

    对应 babel-plugin-styled-components 或使用 SWC 时 @swc/plugin-styled-components 的配置。 值为 Object 类型时,利用 Object.assign 函数与默认配置合并。比如:

    export default {
      tools: {
        styledComponents: {
          pure: false,
        },
      },
    };

    值为 Function 类型时,第一个参数为默认配置,第二个参数提供了一些可以直接调用的工具函数:

    export default {
      tools: {
        styledComponents(config) {
          // 修改 pure 配置
          config.pure = false;
        },
      },
    };

    该特性默认启用,你可以配置 tools.styledComponentsfalse 来关闭该行为,关闭后可以提升编译性能:

    export default {
      tools: {
        styledComponents: false,
      },
    };