集成香草精与 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 仓库上提交 bug 报告，以便我们进一步改进。有关 Less 的手动配置说明，您可以参考文档。

手动配置 Webpack

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

参与进来

现在您已准备好在 Storybook 中使用 Vanilla Extract。🎉 如果您在工作中也使用 Vanilla Extract，我们很乐意听取您关于 Vanilla Extract + Storybook 体验的反馈。

加入维护者和我们蓬勃发展的社区，请访问 Discord。