目录
入门
访问 Storybook 网站,详细了解 Storybook 并开始使用。
文档
文档可在 Storybook 文档网站 上找到。
示例
查看 组件百科,了解领先团队如何使用 Storybook。
使用 storybook.new 在 Stackblitz 中快速创建示例项目。
Storybook 附带了许多用于组件设计、文档、测试、交互性等的 附加组件。Storybook 的 API 使得以各种方式配置和扩展成为可能。它甚至已扩展以支持移动端的 React Native、Android、iOS 和 Flutter 开发。
社区
如需更多帮助,请在 仓库的 GitHub 讨论区 中分享您的问题。
项目
支持的框架
渲染器 | 演示 | |
---|---|---|
React | ||
Angular | ||
Vue 3 | ||
Web Components | ||
React Native | ||
HTML | ||
Ember | ||
Svelte | ||
Preact | ||
Qwik | ||
SolidJS | ||
Android、iOS、Flutter |
附加组件
附加组件 | |
---|---|
a11y | 在 Storybook 中测试组件的可访问性 |
actions | 在用户与 Storybook UI 中的组件交互时记录操作 |
backgrounds | 允许用户在 Storybook UI 中选择背景 |
cssresources | 动态地将 CSS 资源添加到组件 iframe 或从其中移除 |
design assets | 在您的故事旁边查看图像、视频和网络链接 |
docs | 为您的组件添加高质量文档 |
events | 交互式地向响应 EventEmitter 的组件触发事件 |
google-analytics | 报告故事的 Google Analytics |
graphql | 在 Storybook 故事中查询 GraphQL 服务器 |
jest | 在 Storybook 中查看组件的单元测试结果 |
links | 在故事之间创建链接 |
measure | 在 Storybook UI 中直观地检查布局和框模型 |
outline | 在 Storybook UI 中直观地调试 CSS 布局和对齐 |
query params | 模拟查询参数 |
storysource | 在 Storybook UI 中查看故事的代码 |
viewport | 使用 Storybook 更改响应式组件的显示大小和布局 |
查看 附加组件/框架支持表
为了继续改善您的体验,我们最终不得不弃用或删除某些附加组件,以支持新的更好的工具。
如果您正在使用 info/notes,我们强烈建议您迁移到 docs,这里有一个指南 可以帮助您。
如果您正在使用 contexts,我们强烈建议您迁移到 toolbars,这里有一个指南 可以帮助您。
如果您正在使用 addon-storyshots,我们强烈建议您迁移到 Storybook test-runner,这里有一个指南 可以帮助您。
徽章和演示材料
我们有一个徽章!将其链接到您的实时 Storybook 示例。
[![Storybook](https://cdn.jsdelivr.net.cn/gh/storybookjs/brand@main/badge/badge-storybook.svg)](link to site)
如果您正在寻找在 Storybook 演示中使用的材料,例如徽标、视频材料和我们使用的颜色,您可以在我们的 品牌仓库 中找到所有内容。
社区
- 通过 @storybookjs 发布推文
- 在 storybook.js.org 和 Medium 上写博客
- 在 Discord 上聊天
- 在 YouTube 上观看视频和直播
贡献
欢迎您对 Storybook 进行贡献!
想找一个第一个要解决的问题吗?
- 当我们认为问题适合刚接触代码库或 OSS 的人时,我们会使用 标签进行标记。
- 联系我们,我们会找到适合您技能和学习兴趣的内容。
开发脚本
Storybook 组织为一个单一仓库。有用的脚本包括
yarn start
运行带有测试故事的沙盒模板 Storybook
yarn task
与上面相同,但允许您自定义沙盒(例如,选择其他框架)
yarn lint
布尔值检查代码是否符合代码风格检查规则 - 使用 remark 和 eslint
yarn lint:js
- 将检查 jsyarn lint:md
- 将检查 markdown 和代码示例yarn lint:js --fix
- 将自动修复 js
yarn test
布尔值检查所有单元测试是否通过 - 使用 jest
yarn run test --core --watch
- 将在监视模式下运行核心测试
赞助商
成为赞助商,以便在 Github 上的 README 中显示您的徽标和网站 URL。[成为赞助商]
赞助者
通过进行定期捐赠,您可以支持我们和我们的工作。[成为赞助者]
许可证
- 结束 -