对应源码仓库 commit 0692249。UmTableForm 的表单 vnode 改由 render() 创建 (删除 computed.formCom,新增 methods.buildForm),避免 Vue 3.5 在渲染外重算 computed 导致字符串 ref 失去 owner、$refs.formRef 为 null;并新增 getFormInstance() 兜底回捞 ElForm 实例。 消费方实测:旧产物点确定无反应,新产物弹窗正常关闭并提交成功。
115 lines
4.7 KiB
TypeScript
115 lines
4.7 KiB
TypeScript
import type { IFormRule, IFieldMetaValue } from "./types";
|
||
declare const _sfc_main: import("vue").DefineComponent<{}, {
|
||
formModel: import("vue").Ref<{
|
||
[x: string]: any;
|
||
}>;
|
||
setFormModel: (models: any) => void;
|
||
getFormInstance: () => any;
|
||
}, {
|
||
rules: Record<string, any>;
|
||
formItems: any[];
|
||
fieldOption: Map<string, any>;
|
||
/** label 默认宽度 */
|
||
maxLabelWidth: number;
|
||
/** 当前需要显示的字段 */
|
||
showList: string[];
|
||
/** 级联关系:改 A 字段要刷新它的 cascadeFiled 列表 */
|
||
cascadeMap: Map<string, string[]>;
|
||
/** 表单刷新按 100ms 合并,避免连续输入时反复重建整个表单 */
|
||
throttleRefreshForm: import("lodash").DebouncedFunc<(this: any, v: any, oldV: any, needFreshCascadeField: string[]) => Promise<void>>;
|
||
}, {}, {
|
||
refreshForm(v: any, oldV: any, needFreshCascadeField: string[]): Promise<void | undefined>;
|
||
onSubmit(): Promise<void>;
|
||
/** 把 `IFormRule` 翻译成 element-plus 的 FormItemRule */
|
||
getRule(rule: IFormRule): {
|
||
required: boolean;
|
||
message: string | undefined;
|
||
pattern?: undefined;
|
||
min?: undefined;
|
||
max?: undefined;
|
||
validator?: undefined;
|
||
} | {
|
||
pattern: RegExp;
|
||
message: string;
|
||
required?: undefined;
|
||
min?: undefined;
|
||
max?: undefined;
|
||
validator?: undefined;
|
||
} | {
|
||
min: number | undefined;
|
||
max: number | undefined;
|
||
message: string;
|
||
required?: undefined;
|
||
pattern?: undefined;
|
||
validator?: undefined;
|
||
} | {
|
||
max: number | undefined;
|
||
message: string;
|
||
required?: undefined;
|
||
pattern?: undefined;
|
||
min?: undefined;
|
||
validator?: undefined;
|
||
} | {
|
||
min: number | undefined;
|
||
message: string;
|
||
required?: undefined;
|
||
pattern?: undefined;
|
||
max?: undefined;
|
||
validator?: undefined;
|
||
} | {
|
||
validator: any;
|
||
required?: undefined;
|
||
message?: undefined;
|
||
pattern?: undefined;
|
||
min?: undefined;
|
||
max?: undefined;
|
||
} | {
|
||
required?: undefined;
|
||
message?: undefined;
|
||
pattern?: undefined;
|
||
min?: undefined;
|
||
max?: undefined;
|
||
validator?: undefined;
|
||
} | undefined;
|
||
/** 取回字段的候选数据(下拉 / 树),并在需要时重置级联字段的值 */
|
||
updateFieldOption(fieldName: string, metaData: IFieldMetaValue, isBeforeMount?: boolean): Promise<void>;
|
||
/**
|
||
* 初始化需要显示的字段。
|
||
* 隐藏的字段会把当前值暂存到 `$ref:<field>` 并置空,重新显示时还原。
|
||
*/
|
||
initShowFieldList(v: any, oldV?: any): Promise<void>;
|
||
/** 刷新级联字段的候选数据 */
|
||
initCascadeData(needFreshCascadeField: string[]): Promise<void>;
|
||
/** 首次进入时把所有字段的候选数据取回来 */
|
||
initData(): Promise<void>;
|
||
initFormItem(): void;
|
||
/** 根据字段元数据计算校验规则、初始化表单值、并算出最宽的 label */
|
||
initRule(isBeforeMount?: boolean): void;
|
||
init(): Promise<void>;
|
||
/** 单字段赋值:整体替换对象,触发父层的 formModel watch */
|
||
initForm(fieldName: string, value: any): void;
|
||
/**
|
||
* 造出 ElForm 的 vnode。
|
||
*
|
||
* ⚠️ 必须由 `render()` 直接调用,**不要**挪回 `computed` 里。
|
||
*
|
||
* Vue 3.5 起,调度器会在渲染之外重新求值 computed
|
||
* (`flushJobs` → `runIfDirty` → `refreshComputed`,实测在首次渲染后 2ms 就会来一次)。
|
||
* 那一刻 `currentRenderingInstance` 是 null,于是 `h(ElForm, { ref: "formRef" })`
|
||
* 造出来的 vnode 里 ref 的 owner 就是 null;Vue 的 `setRef` 会打印
|
||
* `Missing ref owner context. ref cannot be used on hoisted vnodes`
|
||
* 并**直接跳过赋值** —— `$refs.formRef` 永远是 null。
|
||
*
|
||
* 症状极具迷惑性:表单照常渲染、数据照常回填,只有「点确定」没反应
|
||
* (`onSubmit` 里 `refs.formRef?.validate?.()` 静默落空),
|
||
* 而且是否复现取决于「最后一次求值落在渲染内还是渲染外」。
|
||
* 在 render 里创建则每次都有正确的 owner。
|
||
*/
|
||
buildForm(): any;
|
||
}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("ok" | "cancel" | "formModelChange")[], "ok" | "cancel" | "formModelChange", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{}>> & {
|
||
onOk?: ((...args: any[]) => any) | undefined;
|
||
onCancel?: ((...args: any[]) => any) | undefined;
|
||
onFormModelChange?: ((...args: any[]) => any) | undefined;
|
||
}, {}>;
|
||
export default _sfc_main;
|