clickgo 7.7.4 → 7.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,49 @@
1
+ import * as lControl from '../control';
2
+ import { AbstractCommon } from './base';
3
+ import { AbstractForm } from './abstract-form';
4
+ /** --- Form/Panel 内使用的应用局部组件抽象类 --- */
5
+ export declare abstract class AbstractComponent extends AbstractCommon {
6
+ /** --- 当前组件内继续局部注册的应用组件 --- */
7
+ readonly components: Record<string, new () => AbstractComponent>;
8
+ /** --- 当前组件所在窗体的创建序号 --- */
9
+ get findex(): number;
10
+ /** --- 当前组件所在窗体的窗体对象 --- */
11
+ private _rootForm;
12
+ get rootForm(): AbstractForm & Record<string, any>;
13
+ /** --- 当前组件是否跟随宿主窗体获得焦点 --- */
14
+ get formFocus(): boolean;
15
+ /** --- 获取宿主 Form/Panel 的语言内容 --- */
16
+ get l(): (key: string, data?: string[]) => string;
17
+ /** --- 获取宿主窗体语言内容 --- */
18
+ get fl(): (key: string, data?: string[]) => string;
19
+ /** --- 应用组件动态 class 的隔离前缀 --- */
20
+ get classPrepend(): (cla: any) => string;
21
+ /** --- 组件内部文件,由系统重写 --- */
22
+ readonly packageFiles: Record<string, Blob | string>;
23
+ /** --- 组件参数,由用户定义重写 --- */
24
+ readonly props: {};
25
+ /** --- 组件事件,由用户定义重写 --- */
26
+ readonly emits: Record<string, null | ((payload: any) => boolean)>;
27
+ /** --- 组件的子插槽 --- */
28
+ readonly slots: Record<string, () => any[]>;
29
+ /** --- 获取某插槽所有子项 --- */
30
+ get slotsAll(): (name: string) => any[];
31
+ /** --- 获取 props 中的 boolean 类型值 --- */
32
+ get propBoolean(): (name: keyof this['props']) => boolean;
33
+ /** --- 获取 props 中的 number 类型值 --- */
34
+ get propNumber(): (name: keyof this['props']) => number;
35
+ /** --- 获取 props 中的 int 类型值 --- */
36
+ get propInt(): (name: keyof this['props']) => number;
37
+ /** --- 获取 props 中的 array 类型值 --- */
38
+ get propArray(): (name: keyof this['props']) => any[];
39
+ /** --- 向上触发组件事件 --- */
40
+ emit(name: string, ...v: any[]): void;
41
+ /** --- 获取上层控件或组件 --- */
42
+ get parent(): lControl.AbstractControl & AbstractComponent & AbstractForm & Record<string, any>;
43
+ /** --- 根据 controlName 查询上层对象 --- */
44
+ get parentByName(): (controlName: string) => Record<string, any> | null;
45
+ /** --- 根据 access 查询上层对象 --- */
46
+ get parentByAccess(): (name: string, val: string) => Record<string, any> | null;
47
+ /** --- 组件挂载好后触发 --- */
48
+ onMounted(): void | Promise<void>;
49
+ }
@@ -0,0 +1,195 @@
1
+ import * as lCore from '../core';
2
+ import * as lCommand from '../command';
3
+ import * as lControl from '../control';
4
+ import type * as lNativeEvents from '../native/events';
5
+ import { AbstractCommon } from './base';
6
+ /** --- 窗体的抽象类 --- */
7
+ export declare abstract class AbstractForm extends AbstractCommon {
8
+ /**
9
+ * --- Native 普通启动及再次启动事件;网页不触发,App/Form 要求 root ---
10
+ * @param event 业务参数、原生工作目录、来源及请求 ID
11
+ * @returns 无;各层级独立收到通知,同一业务动作由应用选择一处执行
12
+ */
13
+ onNativeLaunch(event: lNativeEvents.INativeLaunchEvent): void | Promise<void>;
14
+ /**
15
+ * --- Native 文件打开全局事件,要求宿主启用 openFiles;App/Form 要求 root ---
16
+ * @param paths 不含 /storage/ 的 ClickGo 绝对文件路径
17
+ * @param info startup、second-instance、association 或 drop 来源及请求 ID
18
+ * @returns 无;各层级独立通知,业务自行确认、保存和打开
19
+ */
20
+ onNativeOpenFiles(paths: string[], info: lNativeEvents.INativeOpenFilesInfo): void | Promise<void>;
21
+ /** --- 当前是否完全创建完毕 --- */
22
+ isReady: boolean;
23
+ /** --- 是否是 native 下无边框的第一个窗体 --- */
24
+ isNativeNoFrameFirst: boolean;
25
+ /** --- 当前的窗体创建的位数 --- */
26
+ get findex(): number;
27
+ /** --- 获取 form 的 hash 值,不是浏览器的 hash --- */
28
+ get formHash(): string;
29
+ set formHash(v: string);
30
+ /** --- 获取 form 的 formhash with data 值 --- */
31
+ get formHashData(): Record<string, any>;
32
+ set formHashData(v: Record<string, any>);
33
+ /** --- 是否是置顶 --- */
34
+ get topMost(): boolean;
35
+ set topMost(v: boolean);
36
+ /** --- 是否是置底 --- */
37
+ get bottomMost(): boolean;
38
+ set bottomMost(v: boolean);
39
+ /**
40
+ * --- 是否在本窗体上显示遮罩层 ---
41
+ */
42
+ get isMask(): boolean;
43
+ /** --- 当前窗体是否是焦点 --- */
44
+ get formFocus(): boolean;
45
+ /** --- 当前窗体是否显示在任务栏 --- */
46
+ get showInSystemTask(): boolean;
47
+ set showInSystemTask(v: boolean);
48
+ /** --- 将在 form 完全装载完后执行,如果已经装载完则立即执行 --- */
49
+ ready(cb: () => void | Promise<void>): void;
50
+ /** --- form hash 回退 --- */
51
+ formHashBack(): Promise<void>;
52
+ /** --- 发送一段数据到 panel 控件,本质上也是调用的 panel 控件的 send 方法 --- */
53
+ sendToPanel(panel: lControl.AbstractControl & Record<string, any>, data: Record<string, any>): void;
54
+ /** --- 覆盖整个窗体的 loading(实际值) --- */
55
+ private _loading;
56
+ /** --- 覆盖整个窗体的 loading --- */
57
+ get loading(): boolean;
58
+ set loading(val: boolean);
59
+ /** --- 是否阻止任何人修改 loading --- */
60
+ lockLoading: boolean;
61
+ private _inStep;
62
+ /** --- 当前是否在 step 环节中 --- */
63
+ get inStep(): boolean;
64
+ /** --- 序列化后的 step value 值 --- */
65
+ private readonly _stepValues;
66
+ /** --- 进入 form hash 为源的步进条 --- */
67
+ enterStep(list: Array<{
68
+ /** --- 步骤 hash,第一个必须为当前 hash --- */
69
+ 'value': string;
70
+ 'label'?: string;
71
+ 'icon'?: string;
72
+ 'desc'?: string;
73
+ }>): Promise<boolean>;
74
+ /** --- 更新步进条,用于动态改变某个项的 hash 值时使用 --- */
75
+ updateStep(index: number, value: string): boolean;
76
+ /** --- 完成当前步骤条 --- */
77
+ doneStep(): Promise<void>;
78
+ /** --- 当前是不是初次显示 --- */
79
+ private _firstShow;
80
+ /**
81
+ * --- 显示窗体 ---
82
+ */
83
+ show(): Promise<void>;
84
+ /**
85
+ * --- 显示独占的窗体 ---
86
+ */
87
+ showDialog(): Promise<string>;
88
+ /**
89
+ * --- 让窗体隐藏 ---
90
+ */
91
+ hide(): void;
92
+ /**
93
+ * --- 关闭当前窗体 ---
94
+ */
95
+ close(): void;
96
+ /**
97
+ * --- dialog mask 窗体返回值,在 close 之后会进行传导 ---
98
+ */
99
+ dialogResult: string;
100
+ onMounted(data: Record<string, any>): void | Promise<void>;
101
+ /** --- 接收 send 传递过来的 data 数据 --- */
102
+ onReceive(data: Record<string, any>): void | Promise<void>;
103
+ /**
104
+ * --- 宿主活跃状态改变时广播;初始化不通知,内部切换 Form 不触发 ---
105
+ * @param active 页面可见且拥有焦点时为 true;切换页签、窗口或焦点移出页面时为 false
106
+ * @returns 无
107
+ */
108
+ onActiveChanged(active: boolean): void | Promise<void>;
109
+ /** --- 屏幕大小改变事件 --- */
110
+ onScreenResize(): void | Promise<void>;
111
+ /** --- 系统配置变更事件 --- */
112
+ onConfigChanged<T extends keyof lCore.IConfig>(n: keyof lCore.IConfig, v: lCore.IConfig[T]): void;
113
+ /** --- 窗体创建事件 --- */
114
+ onFormCreated(taskId: string, formId: string, title: string, icon: string, showInSystemTask: boolean): void | Promise<void>;
115
+ /** --- 窗体销毁事件 --- */
116
+ onFormRemoved(taskId: string, formId: string, title: string, icon: string): void | Promise<void>;
117
+ /** --- 窗体标题改变事件 --- */
118
+ onFormTitleChanged(taskId: string, formId: string, title: string): void | Promise<void>;
119
+ /** --- 窗体图标改变事件 --- */
120
+ onFormIconChanged(taskId: string, formId: string, icon: string): void | Promise<void>;
121
+ /** --- 窗体最小化状态改变事件 --- */
122
+ onFormStateMinChanged(taskId: string, formId: string, state: boolean): void | Promise<void>;
123
+ /** --- 窗体最大化状态改变事件 --- */
124
+ onFormStateMaxChanged(taskId: string, formId: string, state: boolean): void | Promise<void>;
125
+ /** --- 窗体显示状态改变事件 --- */
126
+ onFormShowChanged(taskId: string, formId: string, state: boolean): void | Promise<void>;
127
+ /** --- 窗体获得焦点事件 --- */
128
+ onFormFocused(taskId: string, formId: string): void | Promise<void>;
129
+ /** --- 窗体丢失焦点事件 --- */
130
+ onFormBlurred(taskId: string, formId: string): void | Promise<void>;
131
+ /** --- 窗体闪烁事件 --- */
132
+ onFormFlash(taskId: string, formId: string): void | Promise<void>;
133
+ /** --- 窗体是否显示在任务栏属性改变事件 --- */
134
+ onFormShowInSystemTaskChange(taskId: string, formId: string, value: boolean): void | Promise<void>;
135
+ /** --- 窗体的 formHash 改变事件 --- */
136
+ onFormHashChange(taskId: string, formId: string, value: string, data: Record<string, any>): void | Promise<void>;
137
+ /**
138
+ * --- 托盘注册通知;通过 task.getTrayList(this) 读取快照 ---
139
+ * @param taskId 所属任务
140
+ * @param trayId 托盘 ID
141
+ * @returns 无返回值
142
+ */
143
+ onTrayCreated(taskId: string, trayId: string): void | Promise<void>;
144
+ /**
145
+ * --- 托盘数据变更通知 ---
146
+ * @param taskId 所属任务
147
+ * @param trayId 托盘 ID
148
+ * @returns 无返回值
149
+ */
150
+ onTrayChanged(taskId: string, trayId: string): void | Promise<void>;
151
+ /**
152
+ * --- 托盘删除通知 ---
153
+ * @param taskId 所属任务
154
+ * @param trayId 托盘 ID
155
+ * @returns 无返回值
156
+ */
157
+ onTrayRemoved(taskId: string, trayId: string): void | Promise<void>;
158
+ /**
159
+ * --- 自己的托盘左键点击,只投递到所属任务 ---
160
+ * @param trayId 托盘 ID
161
+ * @returns 无返回值
162
+ */
163
+ onTrayClick(trayId: string): void | Promise<void>;
164
+ /**
165
+ * --- 自己的托盘菜单命令,只投递到所属任务 ---
166
+ * @param trayId 托盘 ID
167
+ * @param menuId 菜单命令
168
+ * @returns 无返回值
169
+ */
170
+ onTrayMenuClick(trayId: string, menuId: string): void | Promise<void>;
171
+ /** --- 任务开始事件 --- */
172
+ onTaskStarted(taskId: string): void | Promise<void>;
173
+ /** --- 任务结束事件 --- */
174
+ onTaskEnded(taskId: string): void | Promise<void>;
175
+ /**
176
+ * --- 页面级 WebMCP 接入状态变化,所有 Form 共用同一状态 ---
177
+ * @param status 浏览器接入状态,与 command.getAgentInfo 的 webMcp.status 一致
178
+ * @returns 无返回值
179
+ */
180
+ onWebMcpStatusChanged(status: lCommand.TWebMcpStatus): void | Promise<void>;
181
+ /**
182
+ * --- Launcher 显示状态改变事件 ---
183
+ * @param state 是否显示
184
+ * @returns 无返回值
185
+ */
186
+ onLauncherShowChanged(state: boolean): void | Promise<void>;
187
+ /** --- launcher 文件夹名称修改事件 --- */
188
+ onLauncherFolderNameChanged(id: string, name: string): void | Promise<void>;
189
+ /** --- location hash 改变事件 --- */
190
+ onHashChanged(hash: string): void | Promise<void>;
191
+ /** --- 键盘按下事件 --- */
192
+ onKeydown(e: KeyboardEvent): void | Promise<void>;
193
+ /** --- 键盘弹起事件 --- */
194
+ onKeyup(e: KeyboardEvent): void | Promise<void>;
195
+ }
@@ -0,0 +1,50 @@
1
+ import * as lControl from '../control';
2
+ import type { IAbstractPanelShowEvent, IAbstractPanelQsChangeShowEvent } from './types';
3
+ import { AbstractCommon } from './base';
4
+ import { AbstractForm } from './abstract-form';
5
+ /** --- Panel 控件抽象类 --- */
6
+ export declare abstract class AbstractPanel extends AbstractCommon {
7
+ /** --- 当前的 panel ID --- */
8
+ get panelId(): string;
9
+ /** --- 当前 panel 所在窗体的窗体对象,系统会在创建时重写本函数 --- */
10
+ get rootForm(): AbstractForm & Record<string, any>;
11
+ /** --- 当前 panel 所在的 panel control 对象,系统会在创建时重写本函数 --- */
12
+ get rootPanel(): lControl.AbstractControl & Record<string, any>;
13
+ /** --- 获取母窗体的 formHash --- */
14
+ get formHash(): string;
15
+ /** --- 设置母窗体的 formHash --- */
16
+ set formHash(fh: string);
17
+ /** --- 获取 form 的 formhash with data 值 --- */
18
+ get formHashData(): Record<string, any>;
19
+ set formHashData(v: Record<string, any>);
20
+ /** --- 将母窗体的 form hash 回退 --- */
21
+ formHashBack(): Promise<void>;
22
+ /** --- 发送一段数据到自己这个 panel 控件,本质上也是调用的 panel 控件的 send 方法,主要用来实现发送给跳转后的 panel --- */
23
+ sendToRootPanel(data: Record<string, any>): void;
24
+ /** --- 母窗体进入 form hash 为源的步进条 --- */
25
+ enterStep(list: Array<{
26
+ /** --- 步骤 hash,第一个必须为当前 hash --- */
27
+ 'value': string;
28
+ 'label'?: string;
29
+ 'icon'?: string;
30
+ 'desc'?: string;
31
+ }>): Promise<boolean>;
32
+ /** --- 目窗体完成当前步骤 --- */
33
+ doneStep(): Promise<void>;
34
+ /** --- 当前的 nav(若有)传递过来的 qs --- */
35
+ qs: Record<string, string>;
36
+ /** --- 确定不再使用 qs 时可调用此方法清空,这样再次通过相同 qs 进入本 panel 依然会响应 qschange 事件 --- */
37
+ clearQs(): void;
38
+ /** --- 当前窗体是否是焦点 --- */
39
+ get formFocus(): boolean;
40
+ onShow(e: IAbstractPanelShowEvent): void | Promise<void>;
41
+ onShowed(): void | Promise<void>;
42
+ onHide(): void | Promise<void>;
43
+ onMounted(): void | Promise<void>;
44
+ /** --- 接收 send 传递过来的 data 数据(是 panel 控件的 send,不是 form 的 send) --- */
45
+ onReceive(data: Record<string, any>): void | Promise<void>;
46
+ /** --- qs 变动时调用,如果只是用来做 qs 数据处理,建议用此方法 --- */
47
+ onQsChange(): void | Promise<void>;
48
+ /** --- 无论是 show 还是 qschange 都会触发,优先触发 show 或 qschange 事件本身,之后触发这个 --- */
49
+ onQsChangeShow(e: IAbstractPanelQsChangeShowEvent): void | Promise<void>;
50
+ }
@@ -0,0 +1,79 @@
1
+ import * as lCore from '../core';
2
+ import * as lControl from '../control';
3
+ import { AbstractComponent } from './abstract-component';
4
+ /** --- Panel 与 Form 共用的抽象类 --- */
5
+ export declare abstract class AbstractCommon {
6
+ /** --- 当前视图内局部注册的应用组件 --- */
7
+ readonly components: Record<string, new () => AbstractComponent>;
8
+ /** --- 当前文件在包内的路径 --- */
9
+ get filename(): string;
10
+ /** --- 当前控件的名字 --- */
11
+ get controlName(): string;
12
+ set controlName(v: string);
13
+ /** --- 当前的任务 ID --- */
14
+ get taskId(): string;
15
+ /** --- 当前的窗体 ID --- */
16
+ get formId(): string;
17
+ set formFocus(b: boolean);
18
+ /** --- 当前文件的包内路径不以 / 结尾 --- */
19
+ get path(): string;
20
+ /** --- 样式独占前缀 --- */
21
+ get prep(): string;
22
+ /** --- 当前的语言 --- */
23
+ get locale(): string;
24
+ /** --- 当前语言的标准 HTML lang 标签 --- */
25
+ get localeTag(): string;
26
+ /** --- 当前语言的书写方向 --- */
27
+ get localeDirection(): 'ltr' | 'rtl';
28
+ /**
29
+ * --- 获取语言内容 ---
30
+ */
31
+ get l(): (key: string, data?: string[], origin?: boolean) => string;
32
+ /** --- layout 中 :class 的转义 --- */
33
+ get classPrepend(): (cla: any) => string;
34
+ /**
35
+ * --- 监视变动 ---
36
+ * @param name 监视的属性
37
+ * @param cb 回调
38
+ * @param opt 参数
39
+ */
40
+ watch<T extends this, TK extends keyof T, TR>(name: TK | (() => TR), cb: (val: T[TK] & TR, old: T[TK] & TR) => void | Promise<void>, opt?: {
41
+ 'immediate'?: boolean;
42
+ 'deep'?: boolean;
43
+ }): () => void;
44
+ /**
45
+ * --- 获取 refs 情况 ---
46
+ */
47
+ get refs(): Record<string, HTMLElement & lControl.AbstractControl & Record<string, any>>;
48
+ /** --- 获取当前的 HTML DOM --- */
49
+ get element(): HTMLElement;
50
+ /**
51
+ * --- 等待渲染 ---
52
+ */
53
+ get nextTick(): () => Promise<void>;
54
+ /**
55
+ * --- 判断当前事件可否执行 ---
56
+ * @param e 鼠标、触摸、键盘事件
57
+ */
58
+ allowEvent(e: PointerEvent | KeyboardEvent): boolean;
59
+ /**
60
+ * --- 触发系统方法 ---
61
+ * @param name 方法名
62
+ * @param param1 参数1
63
+ * @param param2 参数2
64
+ */
65
+ trigger(name: lCore.TGlobalEvent, param1?: boolean | Error | string, param2?: string): Promise<void>;
66
+ /**
67
+ * --- 给一个窗体发送一个对象,不会知道成功与失败状态 ---
68
+ * @param fid formId 要接收对象的 form id
69
+ * @param obj 要发送的对象
70
+ */
71
+ send(fid: string, obj: Record<string, any>): void;
72
+ onBeforeCreate(): void | Promise<void>;
73
+ onCreated(): void | Promise<void>;
74
+ onBeforeMount(): void | Promise<void>;
75
+ onBeforeUpdate(): void | Promise<void>;
76
+ onUpdated(): void | Promise<void>;
77
+ onBeforeUnmount(): void | Promise<void>;
78
+ onUnmounted(): void | Promise<void>;
79
+ }
@@ -0,0 +1,35 @@
1
+ import * as lCore from '../core';
2
+ import * as lControl from '../control';
3
+ import { AbstractForm } from './abstract-form';
4
+ import { AbstractPanel } from './abstract-panel';
5
+ /**
6
+ * --- 创建 panel 对象,一般情况下无需使用 ---
7
+ * @param rootPanel 根 panel 控件
8
+ * @param cls 路径字符串或 AbstractPanel 类
9
+ * @param opt 选项
10
+ */
11
+ export declare function createPanel<T extends AbstractPanel>(rootPanel: lControl.AbstractControl, cls: string | (new () => T), opt?: {
12
+ /** --- 布局内容 --- */
13
+ 'layout'?: string;
14
+ /** --- 样式内容 --- */
15
+ 'style'?: string;
16
+ /** --- cls 为 string 时,path 参数才有效,为基准路径,如果不以 / 结尾则以最后一个 / 字符为准 --- */
17
+ 'path'?: string;
18
+ }): Promise<{
19
+ 'id': string;
20
+ 'vapp': lCore.IVApp;
21
+ 'vroot': T;
22
+ }>;
23
+ /**
24
+ * --- 创建一个窗体 ---
25
+ * @param current 当前任务 ID
26
+ * @param cls 路径字符串或 AbstractForm 类
27
+ * @param data 要传递的对象
28
+ * @param opt 其他替换选项
29
+ */
30
+ export declare function create<T extends AbstractForm>(current: lCore.TCurrent, cls: string | (new () => T), data?: Record<string, any>, opt?: {
31
+ 'layout'?: string;
32
+ 'style'?: string;
33
+ /** --- cls 为 string 时,path 参数才有效,为基准路径,如果不以 / 结尾则以最后一个 / 字符为准 --- */
34
+ 'path'?: string;
35
+ }): Promise<T>;
@@ -0,0 +1,28 @@
1
+ import * as lCore from '../core';
2
+ import * as lControl from '../control';
3
+ import type { IFormDialogOptions, IFormConfirmOptions, IFormCaptchaOptions, IFormPromptOptions } from './types';
4
+ /**
5
+ * --- 显示一个 dialog ---
6
+ * @param current 当前任务
7
+ * @param opt 选项或者一段文字
8
+ */
9
+ export declare function dialog(current: lCore.TCurrent, opt: string | IFormDialogOptions): Promise<string>;
10
+ /**
11
+ * --- 显示一个验证码窗口 ---
12
+ * @param current 当前任务
13
+ * @param opt 选项
14
+ * @returns 验证是否通过
15
+ */
16
+ export declare function captcha(current: lCore.TCurrent, opt: IFormCaptchaOptions): Promise<false | lControl.ICaptchaResultEvent>;
17
+ /**
18
+ * --- 显示一个 confirm ---
19
+ * @param current 当前任务 id
20
+ * @param opt 选项或者一段文字
21
+ */
22
+ export declare function confirm(current: lCore.TCurrent, opt: string | IFormConfirmOptions): Promise<boolean | number>;
23
+ /**
24
+ * --- 显示一个输入框 dialog ---
25
+ * @param current 当前任务 id
26
+ * @param opt 选项或者提示文字
27
+ */
28
+ export declare function prompt(current: lCore.TCurrent, opt: string | IFormPromptOptions): Promise<string>;
@@ -0,0 +1,45 @@
1
+ import * as lCore from '../core';
2
+ import type * as lDom from '../dom';
3
+ import { elements } from './system';
4
+ /** --- 拖动提示动画使用的宿主元素与当前可用区域 --- */
5
+ export interface IEffectsDependencies {
6
+ /** --- 调用时获取元素,避免在模块加载阶段读取尚未初始化的宿主 --- */
7
+ 'getElements': () => Pick<typeof elements, 'circular' | 'rectangle'>;
8
+ /** --- 获取当前避开任务栏的布局区域 --- */
9
+ 'getAvailArea': () => lCore.IAvailArea;
10
+ }
11
+ /**
12
+ * --- 根据 border 方向 获取理论窗体大小 ---
13
+ * @param border 显示的位置代号
14
+ * @param area 布局区域,默认避开任务栏
15
+ * @returns 对应区域内的窗体矩形
16
+ */
17
+ export declare function getRectByBorder(border: lDom.TDomBorderCustom, area?: lCore.IAvailArea): {
18
+ 'width': number;
19
+ 'height': number;
20
+ 'left': number;
21
+ 'top': number;
22
+ };
23
+ /**
24
+ * --- 显示从小到大的圆圈动画特效对象 ---
25
+ * @param x X 坐标
26
+ * @param y Y 坐标
27
+ */
28
+ export declare function showCircular(x: number, y: number): void;
29
+ /**
30
+ * --- 移动矩形到新位置 ---
31
+ * @param border 显示的位置代号
32
+ * @returns 无返回值
33
+ */
34
+ export declare function moveRectangle(border: lDom.TDomBorderCustom): void;
35
+ /**
36
+ * --- 显示从小到大的矩形动画特效对象 ---
37
+ * @param x 起始位置
38
+ * @param y 起始位置
39
+ * @param border 最大时位置代号
40
+ */
41
+ export declare function showRectangle(x: number, y: number, border: lDom.TDomBorderCustom): void;
42
+ /**
43
+ * --- 结束时请隐藏矩形 ---
44
+ */
45
+ export declare function hideRectangle(): void;
@@ -0,0 +1,51 @@
1
+ import * as lCore from '../core';
2
+ import * as lTool from '../tool';
3
+ import type { INotifyOptions, INotifyContentOptions } from './types';
4
+ import { elements } from './system';
5
+ /** --- 通知机制所需的宿主能力 --- */
6
+ export interface INotificationDependencies {
7
+ /** --- 延迟获取系统元素,避免初始化时的循环依赖 --- */
8
+ getElements: () => typeof elements;
9
+ /** --- 当前语言和可用区域 --- */
10
+ lCore: Pick<typeof lCore, 'config' | 'getAvailArea'>;
11
+ /** --- 文字转义和语言方向 --- */
12
+ lTool: Pick<typeof lTool, 'lang' | 'escapeHTML'>;
13
+ }
14
+ /**
15
+ * --- 从下方弹出 alert ---
16
+ * @param content 内容
17
+ * @param type 样式,可留空
18
+ * @returns alert id
19
+ */
20
+ export declare function alert(content: string, type?: 'default' | 'primary' | 'info' | 'warning' | 'danger' | 'cg'): number;
21
+ /**
22
+ * --- 按当前可用区域和实际高度重新排列通知 ---
23
+ * @returns 无返回值
24
+ */
25
+ export declare function refreshNotifyPosition(): void;
26
+ /**
27
+ * --- 弹出右下角信息框 ---
28
+ * @param opt timeout 默认 5 秒,最大 10 分钟
29
+ * @returns notify id,一定大于 0
30
+ */
31
+ export declare function notify(opt: INotifyOptions): number;
32
+ /**
33
+ * --- 修改 notify 的进度条进度 ---
34
+ * @param notifyId notify id
35
+ * @param per 进度,0 - 100 或 0% - 100% (0 - 1)
36
+ * @returns 无返回值
37
+ */
38
+ export declare function notifyProgress(notifyId: number, per: number): void;
39
+ /**
40
+ * --- 修改 notify 的提示信息 ---
41
+ * @param notifyId notify id
42
+ * @param opt 参数,timeout 只能缩短通知存续时间
43
+ * @returns 无返回值
44
+ */
45
+ export declare function notifyContent(notifyId: number, opt: INotifyContentOptions): void;
46
+ /**
47
+ * --- 隐藏 notify ---
48
+ * @param notifyId 要隐藏的 notify id
49
+ * @returns 无返回值
50
+ */
51
+ export declare function hideNotify(notifyId: number): void;
@@ -0,0 +1,78 @@
1
+ import * as lDom from '../dom';
2
+ import * as lTool from '../tool';
3
+ import type * as lCore from '../core';
4
+ import { elements } from './system';
5
+ /** --- 浮层机制所需的宿主能力 --- */
6
+ export interface IPopupDependencies {
7
+ /** --- 延迟获取系统元素,避免初始化时的循环依赖 --- */
8
+ getElements: () => typeof elements;
9
+ /** --- 获取当前系统级 ID --- */
10
+ getSysId: () => string;
11
+ /** --- DOM 定位和监听能力 --- */
12
+ lDom: Pick<typeof lDom, 'findParentByData' | 'watchSize' | 'unwatchSize' | 'watchPosition' | 'unwatchPosition'>;
13
+ /** --- 延迟执行能力 --- */
14
+ lTool: Pick<typeof lTool, 'sleep'>;
15
+ /** --- 切换窗体焦点 --- */
16
+ changeFocus: (formId?: string) => Promise<void>;
17
+ }
18
+ /**
19
+ * --- 将标签追加到 pop 层 ---
20
+ * @param el 要追加的标签
21
+ * @returns 无返回值
22
+ */
23
+ export declare function appendToPop(el: HTMLElement): void;
24
+ /**
25
+ * --- 将标签从 pop 层移除 ---
26
+ * @param el 要移除的标签
27
+ * @returns 无返回值
28
+ */
29
+ export declare function removeFromPop(el: HTMLElement): void;
30
+ /**
31
+ * --- 获取 pop 显示出来的坐标并报系统全局记录 ---
32
+ * @param el 响应的元素
33
+ * @param pop 要显示 pop 元素
34
+ * @param direction 要显示方向(以 $el 为准的 h 水平 v 垂直 t 垂直水平居中)或坐标
35
+ * @param opt size 自定义宽高;null 为 true 时为空也显示;autoPosition 随内容尺寸更新位置;autoScroll 随原元素位置更新;flow 默认加入 pop 流,不加入则不会自动隐藏;overflow 控制内容溢出;way 为托管方式
36
+ * @returns 无返回值
37
+ */
38
+ export declare function showPop(el: HTMLElement | lCore.IVue, pop: HTMLElement | lCore.IVue | undefined, direction: 'h' | 'v' | 't' | PointerEvent | {
39
+ x: number;
40
+ y: number;
41
+ }, opt?: {
42
+ 'size'?: {
43
+ width?: number;
44
+ height?: number;
45
+ };
46
+ 'null'?: boolean;
47
+ 'autoPosition'?: boolean;
48
+ 'autoScroll'?: boolean;
49
+ 'flow'?: boolean;
50
+ /** --- 滚动内容默认 auto;带外部箭头的提示框使用 visible --- */
51
+ 'overflow'?: 'auto' | 'visible';
52
+ /** --- 展示托管方式 --- */
53
+ 'way'?: 'normal' | 'click' | 'hover';
54
+ }): void;
55
+ /**
56
+ * --- 隐藏正在显示中的所有 pop,或指定 pop/el ---
57
+ * @param pop 要隐藏的浮层或触发元素;省略时隐藏全部
58
+ * @returns 无返回值
59
+ */
60
+ export declare function hidePop(pop?: HTMLElement | lCore.IVue): void;
61
+ /**
62
+ * --- 检测 pop 是不是刚刚显示的 ---
63
+ * @param el 触发元素或浮层层级
64
+ * @returns 是否在 100 毫秒内显示
65
+ */
66
+ export declare function isJustPop(el: HTMLElement | number): boolean;
67
+ /**
68
+ * --- 点下 pointerdown 屏幕任意一位置时根据点击处处理隐藏 pop 和焦点丢失事件,鼠标和 touch 只会响应一个 ---
69
+ * @param e 事件对象
70
+ * @returns 处理完成
71
+ */
72
+ export declare function doFocusAndPopEvent(e: PointerEvent): Promise<void>;
73
+ /**
74
+ * --- 在移除 DOM 前清除其中的浮层及监听 ---
75
+ * @param root 将要移除的元素
76
+ * @returns 无返回值
77
+ */
78
+ export declare function cleanupPop(root: HTMLElement): void;
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Copyright 2007-2025 MAIYUN.NET
3
+ *
4
+ * Licensed under the Apache License, Version 2.0 (the "License");
5
+ * you may not use this file except in compliance with the License.
6
+ * You may obtain a copy of the License at
7
+ *
8
+ * https://www.apache.org/licenses/LICENSE-2.0
9
+ *
10
+ * Unless required by applicable law or agreed to in writing, software
11
+ * distributed under the License is distributed on an "AS IS" BASIS,
12
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ * See the License for the specific language governing permissions and
14
+ * limitations under the License.
15
+ */
16
+ import * as lCore from '../core';
17
+ /**
18
+ * --- 移除一个 form(关闭窗口) ---
19
+ * @param formId 要移除的 form id
20
+ */
21
+ export declare function remove(formId: string): boolean;
22
+ /**
23
+ * --- 移除 panel 挂载,通常发生在 panel 控件的 onBeforeUnmount 中 ---
24
+ * @param id panel id
25
+ * @param vapp panel 的 vapp 对象 ---
26
+ * @param el panel 控件
27
+ */
28
+ export declare function removePanel(id: string, vapp: lCore.IVApp, el: HTMLElement): boolean;
@@ -0,0 +1,29 @@
1
+ /** --- 窗体系统共享的身份、创建顺序和焦点状态 --- */
2
+ export declare const state: {
3
+ 'sysId': string;
4
+ 'index': number;
5
+ 'focusId': string | null;
6
+ };
7
+ /** --- form 相关信息 --- */
8
+ export declare const info: {
9
+ /** --- 最后一个置底窗体层级,1000(一千)开始 --- */
10
+ 'bottomLastZIndex': number;
11
+ /** --- 最后一个窗体层级,1000000(百万)开始 --- */
12
+ 'lastZIndex': number;
13
+ /** --- 最后一个置顶窗体层级,100000000(一亿)开始 --- */
14
+ 'topLastZIndex': number;
15
+ /** --- 用到的语言包 --- */
16
+ 'locale': Record<string, {
17
+ 'ok': string;
18
+ 'yes': string;
19
+ 'no': string;
20
+ 'cancel': string;
21
+ 'search': string;
22
+ 'confirmExitStep': string;
23
+ }>;
24
+ };
25
+ /**
26
+ * --- 初始化系统级 ID,仅能设置一次 ---
27
+ * @param id 系统级 ID
28
+ */
29
+ export declare function initSysId(id: string): void;