erp-plus
v1.0.124
Published
ERP Plus 组件封装库 基于 Element Plus 进行二次封装的组件库,提供更高级的组件抽象和业务场景适配。
Readme
ERP Plus 组件封装库 基于 Element Plus 进行二次封装的组件库,提供更高级的组件抽象和业务场景适配。
🚀 特性 ✅ 基于 Element Plus 2.x 版本
📦 开箱即用,简化复杂组件使用
🎨 统一的样式和交互规范
🔧 高度可配置和可扩展
📱 响应式设计,支持移动端
🌐 TypeScript 支持
🎯 业务场景优化
📦 安装
使用 npm
npm install erp-plus
使用 yarn
yarn add erp-plus
使用 pnpm
pnpm add erp-plus
🎛️ 布局大小档位(默认档 / 稍小档) 组件库样式支持两档,由引用方控制切换:
| 档位 | 外观基线 | 如何启用 |
| --- | --- | --- |
| 默认档 | master 分支样式 | 什么都不做(不加任何根类即命中默认档) |
| 稍小档 | feature/workflow_20260903 分支样式 | 给 <html> 加 app-size-small(或 erp-size-small),或用下面任一入口 |
三种启用方式(任选其一):
// ① 安装时配置(推荐)
import ErpPlus from 'erp-plus'
app.use(ErpPlus, { icons, size: 'small' })
// ② 运行时切换
import { setErpSize, getErpSize } from 'erp-plus'
setErpSize('small') // 或 setErpSize('default')
getErpSize() // => 'small' | 'default'
// ③ 纯 CSS:宿主自行加根类
document.documentElement.classList.add('app-size-small')与主应用(erp-vue-plus)联动:
主应用已按 appStore.size 在 <html> 上切换 app-size-small。qiankun 子应用与主应用共享同一个 <html>,
因此子应用无需做任何事即可自动跟随主应用档位。
⚠️ 注意:install 只在显式传入 size 时才操作 DOM;不传则不改动宿主 <html>,
以免子应用误关掉主应用的档位。
样式文件说明:
| 文件 | 作用 |
| --- | --- |
| src/styles/default.scss | 默认档(html:not(.app-size-small):not(.erp-size-small)),内容 = master 分支原样 |
| src/styles/size.scss | 稍小档(html.app-size-small, html.erp-size-small),内容 = 当前分支原样 |
| src/styles/_tier.scss | scoped 组件(Card / Pagination / Table)用的 tier-default / tier-small mixin |
两档选择器互斥,同一元素只会命中其中一套。新增或调整档位样式请按档写进对应文件,
不要在组件 <style> 里直接写档位声明(组件内只保留两档一致的样式)。
