什么是Storybook?
Storybook 是一个开源的UI组件开发工具,广泛应用于前端开发中。它允许开发者在一个独立的环境中构建和测试组件,确保每个组件的可重用性和稳定性。借助于Storybook,开发者可以实现组件的可视化展示,提升开发效率。
Storybook的优势
使用Storybook 有许多优点:
- 独立性:可以在没有应用的情况下开发组件。
- 可重用性:促进组件的复用,减少代码重复。
- 可测试性:为每个组件提供清晰的状态,方便进行UI测试。
- 团队协作:便于设计师和开发者之间的沟通,提高工作效率。
如何在GitHub上设置Storybook
1. 创建一个新的GitHub项目
首先,您需要在GitHub上创建一个新的项目,您可以按照以下步骤进行:
- 登录到您的GitHub账户。
- 点击右上角的“+”按钮,选择“New repository”。
- 填写项目名称、描述等信息,选择公开或私有,然后点击“Create repository”。
2. 安装Storybook
在您的本地开发环境中,使用以下命令安装Storybook: bash npx sb init
这条命令将自动为您的项目设置Storybook所需的基础结构。
3. 配置Storybook
在项目的根目录下找到.storybook
文件夹,您可以在这里配置您的Storybook。例如,您可以设置主题、添加插件等。
4. 创建组件
在项目中创建您的UI组件,并为每个组件创建一个相应的故事(story)。在每个组件文件夹中,您可以创建一个以.stories.js
或.stories.ts
结尾的文件。
javascript import React from ‘react’; import MyButton from ‘./MyButton’;
export default { title: ‘Example/MyButton’, component: MyButton, };
const Template = (args) => <MyButton {…args} />;
export const Primary = Template.bind({}); Primary.args = { primary: true, label: ‘Button’, };
5. 运行Storybook
使用以下命令启动Storybook: bash npm run storybook
在浏览器中访问http://localhost:6006
,您将看到所有组件的可视化展示。
如何在GitHub上托管Storybook
将您的Storybook项目托管到GitHub Pages上可以通过以下步骤实现:
-
在项目中安装gh-pages包: bash npm install gh-pages –save-dev
-
在package.json中添加以下字段:”homepage”: “http://
.github.io/
“,”scripts”: { “predeploy”: “npm run build”, “deploy”: “gh-pages -d storybook-static