全局配置

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

应用配置

名称	说明	类型	默认值	web端是否支持	移动端是否支持
theme	应用主题类型，用于控制整体 UI 风格	`light \| dark \| blue`	light	✅	✅
mdctrldefaultsort	多数据部件默认排序规则，格式：字段名,排序方向（示例：id,asc）	`string`	-	✅	✅
mdctrlrefreshmode	多数据部件刷新模式：是否使用缓存数据	`nocache \| cache`	cache	✅	❌
pickerdefaultsort	下拉选择类组件默认排序方向（如：asc / desc）	`string`	-	✅	❌
tooltiprendermode	提示框内容渲染模式（无 / Markdown / HTML）	`none \| md \| html`	md	✅	❌
codeEditorTheme	代码编辑器主题	`light \| dark`	-	✅	❌

全局视图配置(view)

名称	说明	类型	默认值	web端是否支持	移动端是否支持
enableDataInfoBar	是否启用信息栏，只有该参数为 true 后才会识别模型的 isShowDataInfoBar 来控制是否显示信息栏，为 false 则一律不显示信息栏。	`boolean`	true	✅	✅
expCacheMode	导航部件缓存控制配置；使用 : 分隔（如：TABEXPPANEL:GRIDEXPBAR:），需以 : 结尾	`string`	TABEXPPANEL:	✅	✅
disableHomeTabs	是否禁用首页分页导航栏	`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	✅	✅
loadingText	视图加载过程中的提示文本	`string`	-	✅	✅

全局表格配置(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 \| undefined`	-	✅	❌
chunkThresholdDefaultValue	召回阈值默认值	`number \| undefined`	-	✅	❌
chunkPageIndexDefaultValue	资料页面目录召回	`0 \| 1 \| undefined`	undefined	✅	❌
globalDownloadPrifix	是否启用全局下载文件前缀	`boolean`	false	✅	✅
autoCloseModalView	当路由跳转完成时，应用内部是否自动关闭打开的模态类视图	`boolean`	false	✅	❌
aiChatSummaryMaxTokens	AI聊天标题摘要最大字符数	`number`	30	✅	✅
enableAsyncActionNotice	是否启用异步操作通知	`boolean`	true	✅	✅
aiChunkView	知识切片视图，用于定义AI交谈打开知识切片视图	`string`	''	✅	❌
aiChunkEntity	知识切片实体，用于定义AI交谈打开知识切片数据主键key	`string`	''	✅	❌

全局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	字体大小（px）	`number`	14	✅	✅
fontFamily	字体族（遵循 CSS 规范）	`string`	Microsoft YaHei	✅	✅
fontWeight	字体粗细（如：400 / bold）	`string \| number`	400	✅	✅
fontStyle	字体样式（normal / italic / oblique）	`string`	normal	✅	✅
color	字体颜色（支持 CSS 格式）	`string`	rgba(0,0,0,0.5)	✅	✅
opacity	水印透明度（0~1）	`number`	0.15	✅	✅
rotate	旋转角度（单位：度，支持负值）	`number`	-30	✅	✅
gap	平铺间距（x / y）	`[number, number]`	[90, 90]	✅	✅
offset	偏移量（x / y）	`[number, number]`	[0, 0]	✅	✅
tileSize	单个水印块尺寸（0 表示自适应）	`{ width: number; height: number }`	`{ width: 0, height: 0 }`	✅	✅
zIndex	水印层级控制	`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)

使用

配置