Skip to main content

应用设置

1 页面设置

可以设置应用的在打开多个页面时,历史页面的导航风格:

  1. 无:不显示历史页面
  2. 面包屑:

  1. 标签导航:

2 执行逻辑

应用开启前关闭后需要执行逻辑,可在此配置

3 启动脚本

启动脚本里包含了五个钩子函数,分别是: onLoadonLeaveonPageChangeonLoginonLogouthttpRequestInterceptor,具体使用说明见启动脚本

4 事件通知接口

用户可以在此配置项中,配置一个 http 接口地址,接口规范如下,以此接口,可接收到平台发送的事件

名称父级类型必选中文名说明
eventTypeString事件类型dbModify:表数据变更
businessTypeString业务类型类型:
gg_user
gg_user_tenant
gg_user_role
gg_user_organize
gg_role
gg_organize
gg_organize_role
msgString消息
// 新增
{
<strong>"eventType"</strong>: <strong>"dbModify"</strong>,
<strong>"businessType"</strong>: <strong>"gg_user"</strong>,
<strong>"msg"</strong>: <strong>"{\"operate\":\"INSERT\",\"tableName\":\"tb_user\",\"dataIds\":[1234,2345]}"</strong>
}

// 修改
{
<strong>"eventType"</strong>: <strong>"dbModify"</strong>,
<strong>"businessType"</strong>: <strong>"gg_user"</strong>,
<strong>"msg"</strong>: <strong>"{\"operate\":\"UPDATE\",\"tableName\":\"tb_user\",\"dataIds\":[1234,2345]}"</strong>
}

// 删除
{
<strong>"eventType"</strong>: <strong>"dbModify"</strong>,
<strong>"businessType"</strong>: <strong>"gg_user_tenant"</strong>,
<strong>"msg"</strong>: <strong>"{\"operate\":\"DELETE\",\"tableName\":\"tb_user_tenant\",\"dataIds\":[1234,2345]}"</strong>
}

5 加载外部资源

支持给应用统一添加外部资源,在自定义 dom 以及自定义主题中使用

使用方法

新增资源

如下图所示,添加外部资源,填写名称、链接、类型信息,目前支持添加 CSS 和 UMD 类型的资源

自定义 dom 中使用

自定义 dom 中可以直接使用加载的外部资源进行调试:

  1. 例如平台应用引入的 vant 的外部依赖包,自定义 DOM 平台渲染模块可以直接使用

  1. 例如平台应用引入的 naive-ui 的外部依赖包,自定义 DOM 平台渲染模块可以直接使用

  1. 效果:

注意事项

  1. 平台暴露的组件资源版本如下所示,请注意版本信息
// 第三方开放库包含以下内容,和平台保持一致
'vue': Vue, // vue版本, 3.2.21版本
'ant-design-vue': AntdVue, // ant-design-vue版本,3.2.12
'lodash-es': LoadashES, // 4.17.21版本
'lodash': lodash, // 4.17.21版本
'dayjs': dayjs, // 1.11.10
'axios': axios, // axios@0.26.1
'@ant-design/icons-vue': Icons, // ant-design-vue对应的平台icon信息
'ant-design-vue/es/locale/en_US': enUS, // ant-design-vue对应的组件国际化资源(英文)
'ant-design-vue/es/locale/zh_CN': zhCN, // ant-design-vue对应的组件国际化资源(中文)
'echarts': echarts, // echarts@5.5.1
'GonggongUI':GonggongUI // 共工组件
  1. 外部资源里上传的 UI 框架,数据框架可以选用依赖上面的平台暴露的组件资源版本,例如 vue,需要使用依赖 vue3.2.21 版本的三方库;也可以选择不依赖于上述库的三方库。
  2. 外部资源可以配置 js 资源库,也可以配置 css 资源库;当应用访问的时候,会根据当前应用配置的外部资源,动态加载 js 库和 css 库到当前页面的 head 中,平台会将加载出来的资源透传给自定义 DOM,这样自定义 DOM 中使用到外部资源名称就可以调用到对应资源的能力。
  3. 如果当前配置的外部资源是外网资源,资源访问可能存在加载不出问题(可能需要 vpn 才能访问),导致自定义 dom 渲染失败等问题,这时会提示用户资源加载失败,需要用户刷新尝试。因此建议尽量选用国内网速访问较快的 cdn 资源,这样才能保障资源能够被正确加载。
  4. https://fastly.jsdelivr.net/ cdn 国内环境加载较慢
  5. cdn 资源可以访问国内速度快的 cdn 地址,例如:https://www.bootcdn.cn/