@gs_w/orbit-ui

Orbit UI

企业级 Vue 3 组件库，基于 Element Plus、ECharts 二次封装，开箱即用的业务组件。

特性

• 基于 Element Plus / ECharts：复用成熟底层组件与可视化能力，按需引入，统一交互规范与主题
• TypeScript 优先：组件 props / events 全类型化，提供完整 .d.ts 类型声明
• 业务覆盖：表格、图表、三维地图、表单、反馈等组件开箱即用
• 双格式产物：ESM + CJS，运行时依赖全部 external，不污染消费方依赖

安装

npm install @gs_w/orbit-ui

运行时依赖 element-plus / echarts 等由消费方提供，需同时安装并引入 Element Plus 样式：

npm install element-plus echarts

快速上手

完整引入

import { createApp } from 'vue';
import ElementPlus from 'element-plus';
import 'element-plus/dist/index.css';
import OrbitUi from '@gs_w/orbit-ui';
import '@gs_w/orbit-ui/style.css';

const app = createApp(App);
app.use(ElementPlus);
app.use(OrbitUi);

按需引入

<script setup>
import { ObButton, ObTable } from '@gs_w/orbit-ui';
import '@gs_w/orbit-ui/style.css';
</script>

中文本地化

Orbit UI 安装时默认启用中文（zh-cn），EP 组件内置文案（分页、日期选择、空数据等）无需额外配置即为中文。如需切换语言或覆盖其它全局配置（size / zIndex / namespace 等），通过安装选项透传：

import en from 'element-plus/es/locale/lang/en';

app.use(OrbitUi, { locale: en });          // 切换语言
app.use(OrbitUi, { size: 'small', zIndex: 3000 }); // 其它全局配置

组件列表

Composables

• useTheme —— 深 / 浅色主题切换
• useRequest —— 轻量请求状态管理（loading / error / data）
• ObLoadingService —— 函数式全屏 Loading

许可证

MIT