集成Vanilla Extract与 Storybook 集成

在 TypeScript 中获取零运行时样式表。

先决条件

本配方假设您已经有一个使用 Vanilla-extract 的应用程序，并且刚刚按照入门指南设置了 Storybook >= 7.0。还没有？请遵循 Vanilla-extract 的设置说明，然后运行

# Add Storybook:
npm create storybook@latest

配置您的 Storybook 构建器

如果您的项目中已经使用了 Vanilla Extract，则可能已经安装了这些依赖项。

首先，安装所需的依赖项

# For Vite users
yarn add -D @vanilla-extract/vite-plugin
 
# For Webpack users
yarn add -D @vanilla-extract/webpack-plugin mini-css-extract-plugin

Vite

对于 Vite 用户，Storybook 会使用您的项目中的vite.config.js 作为其构建配置。这意味着如果您的项目使用了 Vanilla Extract，它也已经为您的 Storybook 配置好了。🎉

您可以在 Stackblitz 上查看完整示例。

Webpack

对于 Webpack 用户，@storybook/addon-styling-webpack 只需几行代码即可让您的 Storybook 与 Vanilla Extract 一起运行。

运行以下脚本安装并注册插件

npx storybook@latest add @storybook/addon-styling-webpack

这将运行一个配置脚本，引导您完成插件的设置。如果出现提示，请选择Vanilla Extract 作为您的 CSS 处理器。

配置脚本失败了吗？

本质上，此命令运行 npx @storybook/auto-config styling，它负责读取您的项目并尝试为所需的工具配置 Storybook Webpack。如果直接运行该命令无法解决您的问题，请考虑在 @storybook/auto-config 仓库上提交错误报告，以便我们进一步改进。有关 Less 的手动配置说明，请参阅文档。

手动配置 Webpack

有关手动配置的示例，您可以在 Stackblitz 上查看完整示例。

参与进来

现在您已准备好将 Vanilla Extract 与 Storybook 一起使用了。🎉 如果您在工作中使用了 Vanilla Extract，我们非常乐意听取您对 Vanilla Extract + Storybook 体验的反馈。

在 Discord 加入维护者和我们蓬勃发展的社区。

标签

贡献者

ShaunEvening