全局配置
全局配置参数，应用将依据这些参数进行调整和适配。
应用配置
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| theme | 应用默认主题 | light | dark | blue | 'light' |
| mdctrldefaultsort | 多数据部件默认排序配置,格式为“排序字段,排序顺序”，如："id,asc" | string | - |
| mdctrlrefreshmode | 多数据部件刷新模式 | nocache | cache | 'cache' |
| pickerdefaultsort | 下拉选择类编辑器默认排序配置，编辑器获取下拉数据时的排序方向，如："asc" | string | - |
| tooltiprendermode | 提示框信息绘制模式 | none | md | html | 'md' |
| codeEditorTheme | 代码编辑器主题 | light | dark | - |
全局视图配置(view)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| enableDataInfoBar | 是否启用信息栏，只有该参数为 true 后才会识别模型的 isShowDataInfoBar 来控制是否显示信息栏，为 false 则一律不显示信息栏。 | boolean | true |
| expCacheMode | 用于控制全局哪些导航部件启用缓存，全大写。TABEXPPANEL:GRIDEXPBAR: - :分隔每个导航部件的缓存开关，必须用:结尾，如：TABEXPPANEL:开启表格导航部件缓存，GRIDEXPBAR:开启分页导航部件缓存。 | string | TABEXPPANEL: |
| disableHomeTabs | 是否禁用分页导航栏，该参数为true时首页不显示分页导航栏 | boolean | false |
| mobShowPresetBack | 移动端是否展示返回按键 | boolean | true |
| mobShowViewHeader | 移动端是否显示视图头 | boolean | true |
| timeoutDuration | 用户操作超时周期（单位：毫秒），超出该时间将刷新用户访问状态，用于协同编辑场景 | number | 300000 |
| onlyShowDataInfo | 是否只显示信息栏，为true时，存在主数据信息则只显示信息栏，无主数据信息时显示标题 | boolean | false |
全局表格配置(grid)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| editShowMode | 表格行编辑呈现模式，cell 每次只呈现悬浮点击之后的一个单元格的编辑态；row 每次呈现编辑中的那一行所有单元格的编辑态；all 呈现所有编辑项的编辑态 | cell | row | all | row |
| editSaveMode | 表格行编辑保存模式，cell-blur 单元格失焦时保存整行数据；auto 自动保存，将每隔 3 秒保存一次值变更后的行数据；manual 手动保存，由界面行为调用表格整体保存或行保存 | cell-blur | auto | manual | cell-blur |
| saveErrorHandleMode | 表格保存错误处理模式，default：表格保存失败，界面弹出错误信息，编辑错误项切换为错误状态（红色边框、hover显示错误信息）；reset：表格保存失败，界面弹出错误信息，编辑错误项还原为保存之前的值 | default | reset | default |
| overflowMode | 单元格超出呈现模式,wrap 换行，高度自动增高；ellipsis 省略，出...，悬浮出tooltip | wrap | ellipsis | wrap |
| emptyHiddenUnit | 表格列格式化值时控制无值状态下单位的显示逻辑，当表格属性列配置了值格式化且绑定属性存在值时，此参数生效。若属性值格式化后无值，该参数为 true 则隐藏单位，为 false 则显示单位 | boolean | true |
全局菜单配置(appMenu)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| enableEcho | 菜单是否根据路由回显激活项，true：回显/false：不回显 | boolean | true |
| echoMode | 菜单回显激活模式，'VIEW'：根据视图标识计算 | 'MENUITEM'：根据菜单项计算 | VIEW | MENUITEM |
| defaultCollapse | 菜单默认收缩 | boolean | - |
全局代码表配置(codeList)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| timeout | 默认代码表超时时间(单位：毫秒)，为避免动态代码表重复加载，当代码表没有配置缓存超时时长时，使用该参数设置代码表超时时间。 | number | 3600000 |
全局表单配置(form)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| mdCtrlConfirmBeforeRemove | 多数据部件删除前是否需要确认 | boolean | true |
| mobShowUnderLine | 移动端是否展示表单项下方下划线 | boolean | true |
| mobFormItemAlignMode | 移动端文本在输入框中的位置 | right | left | '' | '' |
| mobShowEditorBorder | 移动端是否显示表单项边框 | boolean | false |
| emptyHiddenUnit | 隐藏无值的单位 | boolean | true |
| showTipsIcon | 显示属性提示图标 | boolean | true |
| validateMode | 校验模式(default:默认模式,错误信息显示在表单项下方；notification:通知模式，错误信息显示在页面右上角弹框中) | default | notification | 'default' |
| srfCachePos | 是否启用缓存(目前仅表单分页部件支持) | boolean | false |
| srfCacheKeyTempl | 缓存标识(目前仅表单分页部件支持) | string | '' |
全局看板配置(kanban)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| enableFullScreen | 启用全屏 | boolean | true |
| enableGroupHidden | 启用分组隐藏 | boolean | false |
全局选择类编辑器配置(pickerEditor)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| overflowMode | 宽度模式,auto 宽度自动延长；ellipsis 内容超出时出省略号，鼠标悬浮出现tooltip提示 | auto | ellipsis | auto |
全局上传类编辑器配置(uploadEditor)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| infoMap | 上传文件信息的映射规则字符串，用于将上传成功后返回的文件数据转换为保存数据所需格式。格式为'源键:目标键;源键2:目标键2'。示例：映射规则（'filesize:size;fileext:ext'），源对象（{filesize:'10000', fileext:'.gif'}），转换结果（{size:'10000', ext:'.gif'}） | string | - |
搜索表单全局配置(searchform)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| enableStoredFilters | 是否启用存储过滤条件，为true时可以将过滤条件进行保存 | boolean | true |
| convertParamMode | 搜索过滤参数转换模式(default：默认模式，过滤参数保持键值对格式（如 {"n_name_like":"名称"}）；searchconds：搜索条件模式，将对象格式的查询参数转换为结构化的搜索条件数组，并将其作为新的过滤参数（如 {"searchconds": [{"condop": "AND","condtype": "GROUP","searchconds": [{"condtype": "DEFIELD","fieldname": "name","value": "名称","condop": "LIKE"}]}]}) | default | searchconds | 'default' |
全局树配置(tree)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| contextMenuRightClickInvoke | 右键单击树节点时，是否显示上下文菜单 | boolean | true |
全局通用配置(common)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| emptyText | 无值显示文本,当值为空时显示此文本 | string | '-' |
| emptyShowMode | 无值显示模式，值为 'PLACEHOLDER' 时显示占位文本内容，值为 'DEFAULT' 或占位文本无值时显示emptyText参数所设置的值 | DEFAULT | PLACEHOLDER | 'DEFAULT' |
| modalOption | 模态参数，打开模态弹框时默认配置，pc端为element-plus 的dialog配置,移动端为vant的dialog配置 | string | - |
| drawerOption | 抽屉参数，打开抽屉时默认配置，pc端为element-plus 的drawer配置，移动端为vant的popup配置 | string | - |
| searchPhSeparator | 快速搜索框占位文本分隔符，用于分割实体属性中启用了支持快速搜索的属性名称 | string | '、' |
| enableDownloadTicket | 是否启用传入下载凭证 | boolean | false |
| batchToolbarMode | 批操作工具栏显示模式，值为 'default' 时表示存在选择数据就显示批操作工具栏，值为 'multiple' 时表示选择至少2条数据才显示批操作工具栏。该参数仅PC端（卡片、列表、表格、树表格）使用 | default | multiple | 'default' |
| mergeAppMenu | 是否合并子应用菜单模型，值为 'default' 时表示应用默认合并子应用菜单模型，值为 'disable' 时表示不合并子应用菜单模型 | default | disable | 'default' |
全局drtab分页流布局配置(drtab)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| enableNavbar | 是否启用导航栏 | boolean | false |
| navbarPos | 导航栏位置 | | MIDDLELEFT | MIDDLERIGHT | TOPLEFT | TOPRIGHT | BOTTOMLEFT | BOTTOMRIGHT | MIDDLERIGHT |
| navbarWidth | 导航栏宽度 | number | - |
应用水印配置参数(watermark)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| enable | 是否启用 | boolean | false |
| text | 水印内容：字符串表示单行文本，数组表示多行文本 | string | string[] | '' |
| fontSize | 字体大小（单位：CSS 像素） | number | 14 |
| fontFamily | 字体族（遵循 CSS 字体族语法） | string | 'Microsoft YaHei' |
| fontWeight | 字体粗细（遵循 CSS 字体粗细语法，如 'bold'、400） | string | number | 400 |
| fontStyle | 字体样式，仅支持 'normal'（正常）、'italic'（斜体）、'oblique'（倾斜） | string | 'normal' |
| color | 字体颜色（支持 CSS 颜色格式，如 '#fff'、'rgba(0,0,0,0.5)'） | string | 'rgba(0,0,0,0.5)' |
| opacity | 水印整体透明度（范围：0 - 1，0 完全透明，1 完全不透明） | number | 0.15 |
| rotate | 水印顺时针旋转角度,负数即为逆时针（单位：度数） | number | -30 |
| gap | 水印平铺时 x、y 方向的间距（单位：CSS 像素），数组第一项为 x 方向，第二项为 y 方向 | [number, number] | [90, 90] |
| offset | 水印背景的偏移量（单位：CSS 像素），数组第一项为 x 方向偏移，第二项为 y 方向偏移 | [number, number] | [0, 0] |
| tileSize | 水印图块大小（单位：CSS 像素）：未设置时根据文本自适应；设置时按指定宽高固定图块尺寸,（0 表示自适应） | { width: number; height: number } | { width: 0, height: 0 } |
| zIndex | 水印层的 z-index 值（控制层级显示顺序） | number | 9999 |
| useShadowDom | 是否使用 Shadow DOM 隔离水印样式：开启后可避免页面样式污染水印，增强样式稳定性 | boolean | true |
| protect | 是否启用防篡改保护：开启后通过 MutationObserver 监听，自动恢复被修改的水印节点和关键样式 | boolean | true |
| allowSelect | 是否允许文本选择穿透水印层 | boolean | false |
| strictProtect | 是否开启严格保护：开启后除 MutationObserver 监听外，将通过定时器（每 2000ms）做额外检查，进一步防止水印被篡改 | boolean | false |
| ensureRelative | 当容器不是 body 时，是否自动将容器设置为 relative 定位（避免水印因容器定位缺失导致错位） | boolean | true |
全局移动端配置(mob)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| mobShowAppTitle | 移动端是否显示应用标题，为false时设置浏览器标题时只设置视图标题，不添加应用标题 | boolean | true |
| mobHomeRouteMode | 移动端home视图路由替换模式，为replace时将会使用router.replace进行路由跳转，为default时使用router.push进行路由跳转 | default | replace | default |
| mobGetSignUrl | 获取微信授权签名请求路径 | string | '' |
| mobGetSignMethod | 获取微信授权签名请求方式 | string | post |
| mobWeChatDebug | 是否开启微信调试模式 | boolean | false |
| showUploadLoading | 是否显示文件上传loading | boolean | - |
图片压缩配置(imgCompressConfig)
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| limit | 图片压缩范围（超过该范围进行压缩，单位kb） | number | 1024 |
| quality | 图片压缩质量（范围0-1，为0时不压缩） | number | 0 |
| maxWidth | 压缩图片最大宽度，单位px | number | 1280 |
使用
iBizHUB将全局配置挂载到ibiz.config中，可通过如下方式查看或使用
ibiz.config配置
通过可视化配置工具ModelingIDE配置应用自定义参数，需在参数前添加globalConfig前缀
// 默认黑色主题
globalConfig.theme=dark
// 禁止树节点右键上下文菜单
globalConfig.tree.contextMenuRightClickInvoke=false
// 表格行编辑模式为单元格模式
globalConfig.grid.editShowMode=cell