全局配置

全局配置参数，应用将依据这些参数进行调整和适配。

应用配置

名称	说明	类型	默认值	web端是否支持	移动端是否支持
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)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
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	✅	✅
viewAccUserMode	全局视图访问权限定义，1：未登录用户、 2：登录用户、 3：未登录用户及登录用户、 4：登录用户且拥有指定资源能力	`1 \| 2 \| 3 \| 4`	3	✅	✅

全局表格配置(grid)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
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)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
enableEcho	菜单是否根据路由回显激活项，true：回显/false：不回显	`boolean`	true	✅	✅
echoMode	菜单回显激活模式，'VIEW'：根据视图标识计算 \| 'MENUITEM'：根据菜单项计算	`VIEW \| MENUITEM`	VIEW	✅	❌
defaultCollapse	菜单默认收缩	`boolean`	-	✅	❌

全局代码表配置(codeList)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
timeout	默认代码表超时时间(单位：毫秒)，为避免动态代码表重复加载，当代码表没有配置缓存超时时长时，使用该参数设置代码表超时时间。	`number`	3600000	✅	✅

全局表单配置(form)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
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`	-	✅	❌
enableDynaFormJsonSchema	是否启用表单jsonschema。参数为true时，会请求服务获取jsonschema对象，并根据该对象的enumOptions属性值计算生成表单项编辑器的代码表数据集合	`boolean`	false	✅	✅

全局看板配置(kanban)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
enableFullScreen	启用全屏	`boolean`	true	✅	❌
enableGroupHidden	启用分组隐藏	`boolean`	false	✅	❌

全局选择类编辑器配置(pickerEditor)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
overflowMode	宽度模式,auto 宽度自动延长；ellipsis 内容超出时出省略号，鼠标悬浮出现tooltip提示	`auto \| ellipsis`	auto	✅	❌

全局上传类编辑器配置(uploadEditor)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
infoMap	上传文件信息的映射规则字符串，用于将上传成功后返回的文件数据转换为保存数据所需格式。格式为'源键:目标键;源键2:目标键2'。示例：映射规则（'filesize:size;fileext:ext'），源对象（{filesize:'10000', fileext:'.gif'}），转换结果（{size:'10000', ext:'.gif'}）	`string`	-	✅	❌

名称	说明	类型	默认值	web端是否支持	移动端是否支持
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)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
contextMenuRightClickInvoke	右键单击树节点时，是否显示上下文菜单	`boolean`	true	✅	❌
enableClickNav	是否启用点击导航（点击节点时直接打开导航视图）,仅移动端生效	`boolean`	false	❌	✅

全局通用配置(common)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
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	✅	✅
enableAIMinimize	是否启用AI聊天最小化	`boolean`	true	✅	❌
aiChatTopicCaptionMode	AI聊天话题标题模式，default:默认值，由外部传入标题决定;snippet：片段,新建或重置会话时默认显示新会话，如果获取到的history内容中包含user信息，则取最后一条user信息截取用作标题,若未能取到标题时等待用户输入第一个user消息后截取作为标题;summary：摘要，需调用ai接口生成摘要作为标题	`default \| snippet \| summary`	default	✅	❌
aiResourceMode	AI资源模式，LOCAL:默认值，会话基于config存储、消息内容均存储客户端; REMOTE：远程，会话基于config和远程session存储、消息内容基于远程消息存储	`LOCAL \| REMOTE \| undefined`	undefined	✅	❌
enableAIAgentChange	是否启用AI智能助助切换	`boolean`	true	✅	❌
enableKnowledgeBaseSelect	是否启用AI知识库选择	`boolean`	true	✅	❌
enableRecallConfigSetting	是否启用AI召回配置设置	`boolean`	true	✅	❌
reRankDefaultValue	召回重排默认值(禁用	启用	自动)	`0 \| 1 \| 2`	2
maxChunksDefaultValue	最大召回数量默认值	`number`	10	✅	❌
chunkThresholdDefaultValue	召回阈值默认值	`number`	0.4	✅	❌
globalDownloadPrifix	是否启用全局下载文件前缀	`boolean`	false	✅	✅
autoCloseModalView	当路由跳转完成时，应用内部是否自动关闭打开的模态类视图	`boolean`	false	✅	❌
aiChatSummaryMaxTokens	AI聊天标题摘要最大字符数	`number`	30	✅	✅

全局drtab分页流布局配置(drtab)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
enableNavbar	是否启用导航栏	`boolean`	false	✅	❌
navbarPos	导航栏位置	`\| MIDDLELEFT \| MIDDLERIGHT \| TOPLEFT \| TOPRIGHT \| BOTTOMLEFT \| BOTTOMRIGHT`	MIDDLERIGHT	✅	❌
navbarWidth	导航栏宽度	`number`	-	✅	❌

应用水印配置参数(watermark)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
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)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
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`	-	❌	✅
mobShowBackTop	是否显示移动端返回顶部按钮	`boolean`	false	❌	✅
mobEnableStoredQuery	是否启用移动端搜索栏搜索历史记录功能	`boolean`	false	❌	✅
toolbarShowMode	移动端工具栏的显示模式，可选值包含IMMEDIATE（即时渲染模式）、COLLAPSIBLE（可折叠模式）	`IMMEDIATE \| COLLAPSIBLE`	IMMEDIATE	❌	✅
toolbarGroupShowMode	移动端工具栏分组与行为组的展示模式，可选值包含DEFAULT（气泡模式，组内容以悬浮气泡形式展示）、ACTIONSHEET（行为列表模式，组内容以下拉抽屉形式展示）	`DEFAULT \| ACTIONSHEET`	ACTIONSHEET	❌	✅

图片压缩配置(imgCompressConfig)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
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

全局配置 ​

应用配置 ​

全局视图配置(view) ​

全局表格配置(grid) ​

全局菜单配置(appMenu) ​

全局代码表配置(codeList) ​

全局表单配置(form) ​

全局看板配置(kanban) ​

全局选择类编辑器配置(pickerEditor) ​

全局上传类编辑器配置(uploadEditor) ​

搜索表单全局配置(searchform) ​

全局树配置(tree) ​

全局通用配置(common) ​

全局drtab分页流布局配置(drtab) ​

应用水印配置参数(watermark) ​

全局移动端配置(mob) ​

图片压缩配置(imgCompressConfig) ​

使用 ​

配置 ​

全局配置

应用配置

全局视图配置(view)

全局表格配置(grid)

全局菜单配置(appMenu)

全局代码表配置(codeList)

全局表单配置(form)

全局看板配置(kanban)

全局选择类编辑器配置(pickerEditor)

全局上传类编辑器配置(uploadEditor)

搜索表单全局配置(searchform)

全局树配置(tree)

全局通用配置(common)

全局drtab分页流布局配置(drtab)

应用水印配置参数(watermark)

全局移动端配置(mob)

图片压缩配置(imgCompressConfig)

使用

配置