1.0.0 • Published 1 month ago

@skystill/elips v1.0.0

Weekly downloads
-
License
-
Repository
-
Last release
1 month ago

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 中的相关配置
            tableOption: {
              ...elTableColumnConfig, // 标准 el-table-column 配置
              toFixed: 0, // 保留小数点后几位
              visible: true // 默认 true (false 表示不在表单中显示)
            },
            // 字段 search-bar 中的相关配置
            searchOption: {
              ...elTableColumnConfig, // 标准 el-table-column 配置
              comType: '', // 配置组件类型 input/select
              default: '', // 默认值

              // comType = select 时,可配置
              enumList: [], // 下拉框可选项

              // comType = dynamicSelect 时,可配置
              api: '',
            },
            // 字段在不同动态 component 中的相关配置,前缀对应 componentConfig 中键值
            // 如:componentConfig.createForm,这里对应 createFormOption
            createFormOption: {
              ...eleComponentConfing, // 标准 el-component 配置
              comType: '', // 控件类型 input/select/input-number
              required: false, // 表单项是否必填,默认 false
              visible: true, // 是否展示 (true/false), 默认为 true
              disabled: false, // 是否禁用 (true/false), 默认为 false
              default: '', // 默认值

              // comType === 'select' 时生效
              enumList: [] // 枚举列表
            },
            // 字段在 editForm 表单中的相关配置
            editFormOption: {
              ...eleComponentConfing, // 标准 el-component 配置
              comType: '', // 控件类型 input/select/input-number
              visible: true, // 是否展示 (true/false), 默认为 true
              disabled: false, // 是否禁用 (true/false), 默认为 false
              default: '', // 默认值

              // comType === 'select' 时生效
              enumList: [] // 枚举列表
            },
            detailPanelOption: {
              ...eleComponentConfing, // 标准 el-component 配置
            }
          },
        },
        required: [] // 标记哪些字段是必填的
      },
      // table 相关配置
      tableConfig: {
        headerButtons: [{
          label: '', // 按钮中文名
          eventKey: '', // 按钮事件名
          eventOption: {
            // 当 eventKey === 'showComponent'
            comName: '' // 组件名称
          }, // 按钮事件具体配置
          ...elButtionConfig // 标准 el-button 配置
        }],
        rowButtons: [{
          label: '', // 按钮中文名
          eventKey: '', // 按钮事件名
          eventOption: {
            // 当 eventKey === 'showComponent'
            comName: '', // 组件名称

            // // 当 eventKey === 'remove'
            params: {
              // paramsKey = 参数的键值
              // rowValueKey = 参数值 (当格式为 schema::tableKey 的时候,到 table 中找响应的字段)
              paramsKey: rowValueKey
            }
          }, // 按钮事件具体配置
          ...elButtionConfig // 标准 el-button 配置
        }]
      },
      searchConfig: {}, // search-bar 相关配置

      // 动态组件 相关配置
      componentsConfig: {
        // createForm: 表单相关配置
        createForm: {
          title: '', // 表单标题
          saveBtnText: '', // 保存按钮文案
        },
        editForm: {
          mainKey: '', // 表单主键,用于唯一标识要修改的数据对象
          title: '', // 表单标题
          saveBtnText: '', // 保存按钮文案
        },
        // detail-panel 相关配置
        detailPanel: {
          mainKey: '', // 表单主键,用于唯一标识要修改的数据对象
          title: '', // 表单标题
        }
      }
    }
  }]
}

服务端启动

const {
  serverStart
} = require('@skystill/elips')

// 启动服务 elips
const app = serverStart({});

自定义服务端

  • router-schema
  • router
  • controller
  • service
  • extend
  • config

前端构建

const { frontendBuild } = require('@skystill/elips');

// 编译构建前端工程
frontendBuild(process.env._ENV);

自定义页面扩展

  • app/pages/ 目录下写入口 entry.xxx.js

dashboard / custom-view 自定义页面扩展

  • app/pages/dashboard/xxx 下添加页面

dashboard / schema-view / components 动态组件扩展

  1. app/pages/dashboard/complex-view/schema-view/components 下添加组件
  2. 配置到 app/pages/dashboard/complex-view/schema-view/components/component-config.js

schema-form 控件扩展

  1. app/widgets/schema-form/complex-view 下添加控件
  2. 配置到 app/widgets/schema-form/form-item-config.js

schema-search-bar 控件扩展

  1. app/widgets/schema-search-bar/complex-view 下添加控件
  2. 配置到 app/widgets/schema-search-bar/search-item-config.js