窗口配置说明

WindowOptions 属性

下列 默认值 来自管理端内建的 defaultOptions；未列「默认值」的项表示合并前无固定默认，完全由你传入或保持未定义（合并后才有结果）。

属性名	类型	必填	默认值	说明
width	number	见说明	800	TypeScript 的 cloudWindowConfig 将 width/height 标为必填；运行时仅校验 name/url，未传宽高时与默认合并为 800 × 600
height	number	见说明	600	同上
belowGroup	string | null	否	''	从属父窗口的 name；子窗口随父窗口模态/关闭策略联动。createSubWin 中显式传 null 表示不按从属子窗处理（详见 cloudWindow）
group	string	否	—	平级资源组 key，用于 maxCount、sendEventToGroup、groupOpened/groupClosed 等
maxCount	number	否	—	同 group 下最大窗口数；超出时对组内最早窗口做 active 替换而非新建
groupCount	number	否	0	子窗口计数等内部逻辑使用，一般无需手动传
index	number	否	1	窗口层级索引（置顶、getMaxTop 等会用到）
relativeApp	boolean	否	—	是否相对应用（依业务扩展）
callback	Function	否	—	窗口打开相关回调（若业务侧有约定）
anim	boolean	否	true	最小化/还原/最大化/尺寸变化等过渡动画
shadow	boolean | string	否	true	true 默认阴影；也可传自定义阴影 CSS 字符串
hideTitle	boolean	否	false	隐藏标题区域
skipTaskbar	boolean	否	false	为 true 时不参与任务栏聚合（barUpdate）
data	any	否	—	打开/激活时下发给子窗口的数据；桌面 active 时也会触发
x	number	否	—	初始 x；与 center、同组偏移等共同决定最终位置（支持负数等规则见 calcPosition）
y	number	否	—	初始 y
minWidth	number	否	0	最小宽度，0 常表示不限制
minHeight	number	否	0	最小高度
maxWidth	number	否	—	最大宽度；最大化时也会参考
maxHeight	number	否	—	最大高度
headConfig	HeadConfig	否	{ height: 40 }	标题栏区域高度与 Mac/Win 控制条位置
sandbox	boolean | string[]	否	false	iframe sandbox
allow	boolean | string[]	否	true	iframe allow
title	string	否	'cloudWindow'	窗口标题
titleBarStyle	string	否	—	标题栏样式（依环境支持，如 hiddenInset）
icon	LazyIcon	否	''	图标；字符串 URL 或带 src/loading/error 的对象
showIcon	boolean	否	true	是否显示图标
frame	boolean	否	true	是否使用内置标题栏框架；自定义 registerHeader 时会关掉 frame
modal	boolean	否	false	模态：阻塞其它区域；无 belowGroup 时挂全局遮罩，有则从属父窗口遮罩链
parent	any	否	false	父窗口引用/标记（类型在源码中为 any，依业务约定）
minimizable	boolean	否	true	是否可最小化
maximizable	boolean	否	true	是否可最大化
resizable	boolean	否	true	是否可拖拽改尺寸
alwaysOnTop	boolean	否	false	是否置顶
color	string	否	—	标题与按钮等主色
blurColor	string	否	—	失焦态颜色
background	string	否	'#fff'	窗口背景色
transparent	boolean	否	false	是否透明背景
help	string	否	undefined	帮助链接；undefined 可不展示帮助入口
controlArea	boolean	否	true	顶部可拖拽条；false 时需自行实现拖拽（如 registerHeader）
center	boolean	否	true	初次布局是否按可用区域居中（仍会与防重叠逻辑叠加）
closable	boolean	否	true	是否可关闭
hideOnClose	boolean	否	—	假关闭（隐藏/保活）；若设置 cacheTime > 0 会被强制为 true
movable	boolean	否	true	是否允许拖动窗口
fullscreenable	boolean	否	true	是否允许全屏（依壳层能力）
cacheTime	number	否	0	缓存秒数；>0 时关闭不销毁 iframe，超时后再回收，并强制 hideOnClose
radius	number	否	12	圆角像素
show	boolean	否	true	创建后是否可见；false 时需再通过 cloudWindowMgr.show() / 配置激活等显示

类型定义

LazyIcon

type LazyIcon =
  | string
  | {
      src: string
      loading?: string
      error?: string
    }

HeadConfig

窗口头部布局（与内置 frame 标题栏配合）。

interface HeadConfig {
  height: number    // 头部高度，默认 40
  macX?: number     // Mac 操作区域（红绿灯）的 x
  macY?: number     // Mac 操作区域（红绿灯）的 y
  winY?: number     // Windows 操作区域的 y（不支持单独配置 x）
}