0.1.6 • Published 5 months ago
bamboosword v0.1.6
BambooSword UI 组件库
BambooSword 是一个基于 React 和 TypeScript 打造的现代组件库。它旨在提供高质量的 UI 组件,帮助开发者快速构建漂亮的 Web 应用。
安装
通过 npm 或 yarn 安装:
npm install bamboosword --save
# 或
yarn add bamboosword
使用
// 引入样式
import 'bamboosword/dist/index.css';
// 引入组件
import { Button } from 'bamboosword';
function App() {
return (
<Button btnType="primary">点击我</Button>
);
}
特性
- 🎨 精心设计的 UI 组件
- 📦 开箱即用的高质量 React 组件
- 🔧 使用 TypeScript 开发,提供完整的类型定义
- 📃 详细的文档和示例
- 📱 响应式设计
组件
该组件库包含以下组件:
- Button: 按钮组件,支持多种类型和尺寸
- Menu: 菜单组件,支持横向纵向两种模式和下拉菜单
- Icon: 图标组件,基于 FontAwesome 图标
- Input: 输入框组件
- AutoComplete: 自动完成组件
- Upload: 文件上传组件,支持拖拽上传
- Progress: 进度条组件
- Form: 表单组件,支持数据验证
- Select: 选择器组件
- Alert: 警告提示组件
- Tabs: 标签页组件
文档和示例
查看我们的 Storybook 文档 获取详细的使用示例和 API 文档。
开发
项目结构
bamboosword/
├── src/ # 源代码
│ ├── components/ # 组件目录
│ ├── styles/ # 样式文件
│ └── hooks/ # 自定义 Hooks
├── dist/ # 构建输出目录
├── rollup/ # Rollup 配置
├── .storybook/ # Storybook 配置
└── public/ # 静态文件
本地开发
克隆仓库并安装依赖:
git clone https://github.com/cheeseburgertony/bamboosword.git
cd bamboosword
npm install
启动开发服务器:
npm start
运行 Storybook:
npm run storybook
构建
# 构建组件库
npm run build
# 构建 Storybook 静态文件
npm run build-storybook
测试
# 运行测试
npm test
# 运行测试覆盖率
npm test -- --coverage
浏览器支持
- 现代浏览器
- Chrome
- Firefox
- Safari
- Edge
贡献
欢迎贡献代码、报告问题或提出新功能建议!
- Fork 仓库
- 创建你的特性分支:
git checkout -b feature/amazing-feature
- 提交你的更改:
git commit -m 'Add some amazing feature'
- 推送到分支:
git push origin feature/amazing-feature
- 提交 Pull Request