React18+TS+Vite 从0自定义组件库实战复杂项目
来百度APP畅享高清图片
步骤一:项目初始化
- 创建项目:使用 Vite 初始化一个新项目,选择 TypeScript 模板:
- bashnpm init @vitejs/app my-custom-components --template react-tscd
- my-custom-components
- 安装依赖:安装开发所需的依赖项:
- bashnpm install --save react react-dom
步骤二:组件开发
- 创建组件:在 src/components 目录下创建你的自定义组件,例如 Button.tsx:
- tsximport React from 'react';interface ButtonProps { label: string; onClick: () => void;}const Button: React.FC<ButtonProps> = ({ label, onClick }) =>
- { return ( <button onClick={onClick}> {label} </button> );};export default Button;
- 编写样式:如果需要,可以在组件目录下编写相应的样式文件。
步骤三:文档编写
- 安装文档工具:安装文档编写和展示所需的工具,例如 storybook:
- bashnpx sb init
- 编写文档:在 .storybook 目录下编写你的组件文档,例如 Button.stories.tsx:
- tsximport React from 'react';import { Story, Meta } from '
- @storybook/react';import Button from '../src/components/Button
- ';export default { title: 'Example/Button', component: Button,} as Meta;const Template: Story = (args) => <Button {...args} />
- ;export const Primary = Template.bind({});Primary.args =
- { label: 'Primary Button', onClick: () => alert
- ('Button clicked!'),};
步骤四:测试与调试
- 测试组件:编写测试用例并确保组件的功能和表现符合预期。
- 调试:使用开发者工具和调试器对组件进行调试,确保没有潜在的问题。
步骤五:发布
- 构建组件库:使用 Vite 构建你的组件库:
- bashnpm run build
- 发布到 npm:将组件库发布到 npm 上:
- bashnpm loginnpm publish --access public
结语
通过以上步骤,你可以完成一个基本的 React 组件库的开发流程。记得持续维护你的组件库,响应用户的反馈,并不断改进和完善组件的功能和文档。祝你的组件库开发顺利!