# easy-ep-ui

**Repository Path**: develop-utils/easy-ep-ui

## Basic Information

- **Project Name**: easy-ep-ui
- **Description**: 基于element plus ui 二次封装
- **Primary Language**: HTML
- **License**: AFL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-23
- **Last Updated**: 2026-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Element-UI, 业务系统, 后台管理系统, 二次封装, vue3

## README

# Easy EP UI

基于 Vue3 + TypeScript + Element Plus 的企业级二次封装组件库，面向高频 CRUD 场景，开箱即用。

## 特性

- 🚀 基于 Vue3 + TypeScript + Element Plus 构建
- 📦 支持全量引入和按需引入，Tree-shaking 友好
- 🌐 内置国际化支持（中英文）
- 🛠️ 面向企业高频 CRUD 场景设计
- 📚 完整的 TypeScript 类型定义

## 安装

```bash
npm install easy-ep-ui
# or
yarn add easy-ep-ui
# or
pnpm add easy-ep-ui
```

## 快速开始

### 全量引入

```ts
import { createApp } from 'vue'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import EasyEpUI from 'easy-ep-ui'
import 'easy-ep-ui/dist/style.css'

const app = createApp(App)
app.use(ElementPlus)
app.use(EasyEpUI)
app.mount('#app')
```

### 按需引入

```ts
import { createApp } from 'vue'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import { EeDictSelect, EeStatusTag } from 'easy-ep-ui'
import 'easy-ep-ui/dist/style.css'

const app = createApp(App)
app.use(ElementPlus)
app.component(EeDictSelect.name, EeDictSelect)
app.component(EeStatusTag.name, EeStatusTag)
app.mount('#app')
```

## 组件列表

| 组件 | 说明 |
| --- | --- |
| `EeDictSelect` | 字典下拉选择，支持静态数据与异步请求 |
| `EeStatusTag` | 状态标签，值到颜色/文本的自动映射 |
| `EeSearchBar` | 搜索栏，多字段搜索、折叠展开、一键重置 |
| `EeFormDialog` | 弹窗表单，集成表单验证与提交流程 |
| `EeFormTable` | 查询表格，搜索+表格+分页一体化 |
| `EeDeptCascader` | 部门树形级联选择 |
| `EeRemoteSelect` | 通用远程下拉组件 |
| `EeRoleSelect` | 角色选择 |
| `EeUserSelect` | 人员选择 |

## 本地开发

```bash
# 安装依赖
npm install

# 启动文档开发服务器
npm run docs:dev

# 构建组件库
npm run build

# 构建文档
npm run docs:build
```

## 发布

```bash
# 补丁版本 (0.0.x)
npm run pub:patch

# 小版本 (0.x.0)
npm run pub:minor

# 大版本 (x.0.0)
npm run pub:major
```

## License

MIT