1.0.1 • Published 5 months ago
@holiang/elpis v1.0.1
elpis
一个企业级应用,通过全栈实现。
model 配置
{
mode:'dashboard', // 模版类型,不同模板类型对应不一样的数据结构
name:'', //名称
desc:'', // 描述
icon:'', // icon
homePage:'', // 首页(项目配置)
// 头部菜单
menu:[{
key:'', // 菜单唯一描述
name:'',// 菜单名称
menuType:'', // 枚举值:group / module
// 当 menuType == group 时,可填
subMenu:[{
// 可递归 menuItem
},...],
// 当 menuType == module 时,可填
moduleType:'', // 枚举值:sider/iframe/custom/schema
// 当 moduleType == sider 时
siderConfig:{
menu:[{
// 可递归 menuItem(除 moduleType === sider)
},...]
},
// 当 moduleType == iframe 时
iframeConfig:{
path:'', // iframe 路径
},
// 当 moduleType == custom 时
customConfig:{
path:'', // 自定义路由路径
},
// 当 moduleType == schema 时
schemaConfig:{
api:'', // 数据源 API (遵循 RESTFUL 规范)
schema:{ // 板块数据结构
type:'object',
properties:{
key:{
...schema, // 标准 schema 配置
type:'', // 字段类型
label:'', // 字段的中文名
// 字段在 table 中的相关配置
tableOpiton:{
...elTableColumnConfig, // 标准 el-table-column 配置
toFixed:0, // 保留小数点后几位
visible:true, // 默认为 true(false时,表示不再表单中显示)
},
// 字段在 search-bar 中的相关配置
searchOption:{
...eleComponentConfig, // 标准 el-form-item 配置
comType:'',// 配置组件类型
default:'',// 默认值
// comType === 'select'
enumList:[], // 下拉框可选项
// comType === 'dynamicSelect'
api:'',
},
// 字段在不同动态 component 中的相关配置,前缀对应 componentConfig 中的键值
// 如:componentConfig.createForm,这里对应 createFormOption
// 字段在 crateForm 中相关配置
createFormOption:{
...elComponentConfig, // 标准 el-component 配置
comType:'',// 配置组件类型
visible:true, // 是否展示,默认为true
disabled:false, // 是否禁用,默认为false
default:'',// 默认值
// comType === 'select'
enumList:[], // 枚举列表
},
// 字段在 editForm 表单中的相关配置
editFormOption:{
...elComponentConfig, // 标准 el-component 配置
comType:'',// 配置组件类型
visible:true, // 是否展示,默认为true
disabled:false, // 是否禁用,默认为false
default:'',// 默认值
// comType === 'select'
enumList:[], // 枚举列表
},
detailpanelOption:{
...eleComponentConfig // 标准 el-component 配置
}
},
...
},
required:[], // 标记哪些字段为必填项
},
// table 相关配置
tableConfig:{
headerButtons:[{
label:'', // 按钮中文名
eventKey:'', // 按钮事件名
// 按钮事件具体配置
eventOption:{
// 当 eventKey === 'showComponent'
comName:'', // 组件名称
},
...elButtonConfig // 标准 el-button 配置
},...],
rowButtons:[{
label:'', // 按钮中文名
eventKey:'', // 按钮事件名
eventOption:{
// 当 eventKey === 'remove'
params:{
// paramKey = 参数的键值
// rowValueKey = 参数值 (当格式为 schema::tableKey 的时候,到 table 中找相应的字段)
paramKey:rowValueKey
}
}, // 按钮事件具体配置
...elButtonConfig // 标准 el-button 配置
},...]
}
},
// search-bar 相关配置
searchConfig:{},
// create-form 表单相关配置
componentConfig:{
// create-form 表单相关配置
createForm:{
title:'', // 表单标题
saveBtnText:'', // 保存按钮文案
},
// edit-form 表单相关配置
editForm:{
mainKey:'', // 表单主键,用于唯一标识要修改的数据对象
title:'', // 表单标题
saveBtnText:'', // 保存按钮文案
},
// detail-panel 相关配置
detailpanel: {
mainKey:'', // 表单主键,用于唯一标识要修改的数据对象
title:'', // 表单标题
},
// ... 支持用户动态扩展
}
},...]
}
服务端启动
const { serverStart } = require("@holiang/elpis");
// 启动 elpis 服务
const app = serverStart({});
自定义服务端
- router-schema
- router
- controller
- service
- extend
- config
前端构建
const { frontendBuild } = require("@holiang/elpis");
// 编译构建前端工程
frontendBuild(process.env._ENV);
自定义页面扩展
- 在
app/pages/
目录下写入口 entry.xxx.js
dashboard / custom-view 自定义页面扩展
- 在
app/pages/dashboard/xxxx
下写页面
dashboard / schema-view / components 动态组件扩展
在
app/pages/dashboard/complex-view/schema-view/components
下写组件配置到
app/pages/dashboard/complex-view/schema-view/components/component-config.js
schema-form 控件扩展
- 在
app/widgets/shema-form/complex-view
下写控件 - 配置道
app/widgets/shcem-form/form-item-config.js
schema-search-bar 控件扩展
- 在
app/widgets/shcema-search-bar/complex-view
下写控件 - 配置道
app/widgets/schema-search-bar/search-item-config.js