@tmagic/form 1.8.0-beta.27 → 1.8.0-beta.29

package/dist/tmagic-form-headless.umd.cjs

@@ -91,8 +91,10 @@
 			var unmasked = true;
 		} catch (e) {}
 		var result = nativeObjectToString$1.call(value);
-		if (unmasked) if (isOwn) value[symToStringTag$1] = tag;
-		else delete value[symToStringTag$1];
+		if (unmasked) {
+			if (isOwn) value[symToStringTag$1] = tag;
+			else delete value[symToStringTag$1];
+		}
 		return result;
 	}
 	//#endregion
@@ -2049,6 +2051,14 @@
 	var extraTypeMatchRules = /* @__PURE__ */ new Map();
 	var builtInTypeMatchRules = /* @__PURE__ */ new Map();
 	var isPromise = (value) => typeof value === "object" && value !== null && typeof value.then === "function";
+	/**
+	* 同步校验无法等待 Promise。调用方会丢掉返回值，这里挂上空 handler，避免变成未捕获 rejection。
+	*/
+	var ignorePromise = (value) => {
+		if (!isPromise(value)) return false;
+		value.then(() => {}, () => {});
+		return true;
+	};
 	/** 注册或覆盖某个字段 type 的 typeMatch 校验规则。`builtIn` 登记不受 `clearTypeMatchRules` / `deleteTypeMatchRule` 影响。 */
 	var registerTypeMatchRule = (type, validator, builtIn = false) => {
 		(builtIn ? builtInTypeMatchRules : extraTypeMatchRules).set((0, _tmagic_utils.toLine)(type), validator);
@@ -2066,16 +2076,20 @@
 	};
 	/** 本地解析配置函数，避免与 form.ts 循环依赖 */
 	var resolveConfig = (mForm, config, props) => {
-		if (typeof config === "function") return config(mForm, {
-			values: (0, vue.readonly)(mForm?.initValues || {}),
-			model: (0, vue.readonly)(props.model),
-			parent: (0, vue.readonly)(mForm?.parentValues || {}),
-			formValue: (0, vue.readonly)(mForm?.values || props.model),
-			prop: props.prop,
-			config: props.config,
-			index: props.index,
-			getFormValue: (prop) => (0, _tmagic_utils.getValueByKeyPath)(prop, mForm?.values || props.model)
-		});
+		if (typeof config === "function") {
+			const formValue = (0, vue.readonly)(mForm?.values || props.model);
+			return config(mForm, {
+				values: (0, vue.readonly)(mForm?.initValues || {}),
+				model: (0, vue.readonly)(props.model),
+				parent: (0, vue.readonly)(mForm?.parentValues || {}),
+				formValue,
+				formValues: formValue,
+				prop: props.prop,
+				config: props.config,
+				index: props.index,
+				getFormValue: (prop) => (0, _tmagic_utils.getValueByKeyPath)(prop, mForm?.values || props.model)
+			});
+		}
 		return config;
 	};
 	var SKIP_TYPES = /* @__PURE__ */ new Set([
@@ -2167,7 +2181,7 @@
 		const { defaultValue } = props.config || {};
 		if (typeof defaultValue === "undefined" || defaultValue === "undefined") return void 0;
 		const resolvedDefaultValue = resolveConfig(mForm, defaultValue, props);
-		if (isPromise(resolvedDefaultValue)) return;
+		if (ignorePromise(resolvedDefaultValue)) return;
 		return resolvedDefaultValue;
 	};
 	var isNumberValue = (value) => typeof value === "number" && !Number.isNaN(value);
@@ -2244,9 +2258,21 @@
 		});
 		return values;
 	};
-	var resolveOptions = (props) => {
-		const { options } = props.config || {};
-		return Array.isArray(options) ? options : [];
+	/**
+	* 解析字段 options：静态数组原样返回；函数型与 `display` / `type` 一样当场求值。
+	*
+	* 函数返回 Promise、非数组或抛错时当作「还没有可选项」，交由调用方按空 options 跳过枚举。
+	* `remote` / `allowCreate` 仍由 `validateSelectValue` 单独放行，不在这里区分。
+	*/
+	var resolveOptions = (mForm, props) => {
+		let resolved;
+		try {
+			resolved = resolveConfig(mForm, props.config?.options, props);
+		} catch {
+			return [];
+		}
+		if (ignorePromise(resolved) || !Array.isArray(resolved)) return [];
+		return resolved;
 	};
 	var includesOptionValue = (optionValues, value) => optionValues.some((item) => Object.is(item, value));
 	var collectCascaderLeafValues = (options, result = []) => {
@@ -2308,19 +2334,18 @@
 			if (typeof value === "object") return defaultMessage(message, `${value} 类型不合法`, optionExampleSuggestion(optionValues, "\"文本内容\" 或 123", false));
 			return;
 		}
-		const isStaticOptions = Array.isArray(config.options);
 		if (config.multiple) {
 			if (!Array.isArray(value)) return defaultMessage(message, `${value} 类型应为数组`, optionExampleSuggestion(optionValues, "[\"选项1\", \"选项2\"]", true));
-			if (isStaticOptions && value.some((item) => !includesOptionValue(optionValues, item))) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
+			if (value.some((item) => !includesOptionValue(optionValues, item))) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
 			return;
 		}
-		if (isStaticOptions && !includesOptionValue(optionValues, value)) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
+		if (!includesOptionValue(optionValues, value)) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
 	};
 	var validateCascaderValue = (value, config, props, mForm, message) => {
-		const options = resolveOptions(props);
+		const options = resolveOptions(mForm, props);
 		if (!options.length) return;
 		const valueSeparator = resolveConfig(mForm, config.valueSeparator, props);
-		if (isPromise(valueSeparator)) return;
+		if (ignorePromise(valueSeparator)) return;
 		const emitPath = config.emitPath !== false;
 		const multiple = Boolean(config.multiple);
 		const cascaderExample = (fallbackExample) => cascaderExampleSuggestion(options, config, valueSeparator, fallbackExample);
@@ -2377,15 +2402,15 @@
 			if (!Object.is(value, activeValue) && !Object.is(value, inactiveValue)) return defaultMessage(message, `${value} 不在合法开关值中`, toggleSuggestion(activeValue, inactiveValue));
 			return;
 		}
-		if (fieldType === "select") return validateSelectValue(value, config, flattenSelectOptions(resolveOptions(props)), message);
+		if (fieldType === "select") return validateSelectValue(value, config, flattenSelectOptions(resolveOptions(mForm, props)), message);
 		if (fieldType === "radio-group") {
-			const optionValues = flattenSelectOptions(resolveOptions(props));
+			const optionValues = flattenSelectOptions(resolveOptions(mForm, props));
 			if (optionValues.length === 0) return;
 			if (!includesOptionValue(optionValues, value)) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
 			return;
 		}
 		if (fieldType === "checkbox-group") {
-			const optionValues = flattenSelectOptions(resolveOptions(props));
+			const optionValues = flattenSelectOptions(resolveOptions(mForm, props));
 			if (optionValues.length === 0) return;
 			if (!Array.isArray(value)) return defaultMessage(message, `${value} 类型应为数组`, optionExampleSuggestion(optionValues, "[\"选项1\", \"选项2\"]", true));
 			if (value.some((item) => !includesOptionValue(optionValues, item))) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
@@ -2412,8 +2437,14 @@
 		if (isEmptyValue(value) || isEmptyArray(value)) return;
 		if (!props.config?.name) return;
 		const rawFieldType = "type" in (props.config || {}) ? props.config.type : "";
-		if (typeof rawFieldType !== "string" || !rawFieldType) return;
-		const fieldType = (0, _tmagic_utils.toLine)(rawFieldType);
+		let resolvedType;
+		try {
+			resolvedType = resolveConfig(mForm, rawFieldType, props);
+		} catch {
+			return;
+		}
+		if (ignorePromise(resolvedType) || typeof resolvedType !== "string" || !resolvedType) return;
+		const fieldType = (0, _tmagic_utils.toLine)(resolvedType);
 		const customValidator = getTypeMatchRule(fieldType);
 		if (customValidator) return customValidator(value, {
 			fieldType,
@@ -2820,16 +2851,20 @@
 		return type?.replace(/([A-Z])/g, "-$1").toLowerCase() || (config?.items ? "" : "text");
 	};
 	var filterFunction = (mForm, config, props) => {
-		if (typeof config === "function") return config(mForm, {
-			values: (0, vue.readonly)(mForm?.initValues || {}),
-			model: (0, vue.readonly)(props.model),
-			parent: (0, vue.readonly)(mForm?.parentValues || {}),
-			formValue: (0, vue.readonly)(mForm?.values || props.model),
-			prop: props.prop,
-			config: props.config,
-			index: props.index,
-			getFormValue: (prop) => (0, _tmagic_utils.getValueByKeyPath)(prop, mForm?.values || props.model)
-		});
+		if (typeof config === "function") {
+			const formValue = (0, vue.readonly)(mForm?.values || props.model);
+			return config(mForm, {
+				values: (0, vue.readonly)(mForm?.initValues || {}),
+				model: (0, vue.readonly)(props.model),
+				parent: (0, vue.readonly)(mForm?.parentValues || {}),
+				formValue,
+				formValues: formValue,
+				prop: props.prop,
+				config: props.config,
+				index: props.index,
+				getFormValue: (prop) => (0, _tmagic_utils.getValueByKeyPath)(prop, mForm?.values || props.model)
+			});
+		}
 		return config;
 	};
 	var display = function(mForm, config, props) {

package/dist/tmagic-form.umd.cjs

@@ -97,8 +97,10 @@
 			var unmasked = true;
 		} catch (e) {}
 		var result = nativeObjectToString$1.call(value);
-		if (unmasked) if (isOwn) value[symToStringTag$1] = tag;
-		else delete value[symToStringTag$1];
+		if (unmasked) {
+			if (isOwn) value[symToStringTag$1] = tag;
+			else delete value[symToStringTag$1];
+		}
 		return result;
 	}
 	//#endregion
@@ -2903,6 +2905,14 @@
 	var extraTypeMatchRules = /* @__PURE__ */ new Map();
 	var builtInTypeMatchRules = /* @__PURE__ */ new Map();
 	var isPromise = (value) => typeof value === "object" && value !== null && typeof value.then === "function";
+	/**
+	* 同步校验无法等待 Promise。调用方会丢掉返回值，这里挂上空 handler，避免变成未捕获 rejection。
+	*/
+	var ignorePromise = (value) => {
+		if (!isPromise(value)) return false;
+		value.then(() => {}, () => {});
+		return true;
+	};
 	/** 注册或覆盖某个字段 type 的 typeMatch 校验规则。`builtIn` 登记不受 `clearTypeMatchRules` / `deleteTypeMatchRule` 影响。 */
 	var registerTypeMatchRule = (type, validator, builtIn = false) => {
 		(builtIn ? builtInTypeMatchRules : extraTypeMatchRules).set((0, _tmagic_utils.toLine)(type), validator);
@@ -2920,16 +2930,20 @@
 	};
 	/** 本地解析配置函数，避免与 form.ts 循环依赖 */
 	var resolveConfig = (mForm, config, props) => {
-		if (typeof config === "function") return config(mForm, {
-			values: (0, vue.readonly)(mForm?.initValues || {}),
-			model: (0, vue.readonly)(props.model),
-			parent: (0, vue.readonly)(mForm?.parentValues || {}),
-			formValue: (0, vue.readonly)(mForm?.values || props.model),
-			prop: props.prop,
-			config: props.config,
-			index: props.index,
-			getFormValue: (prop) => (0, _tmagic_utils.getValueByKeyPath)(prop, mForm?.values || props.model)
-		});
+		if (typeof config === "function") {
+			const formValue = (0, vue.readonly)(mForm?.values || props.model);
+			return config(mForm, {
+				values: (0, vue.readonly)(mForm?.initValues || {}),
+				model: (0, vue.readonly)(props.model),
+				parent: (0, vue.readonly)(mForm?.parentValues || {}),
+				formValue,
+				formValues: formValue,
+				prop: props.prop,
+				config: props.config,
+				index: props.index,
+				getFormValue: (prop) => (0, _tmagic_utils.getValueByKeyPath)(prop, mForm?.values || props.model)
+			});
+		}
 		return config;
 	};
 	var SKIP_TYPES = /* @__PURE__ */ new Set([
@@ -3021,7 +3035,7 @@
 		const { defaultValue } = props.config || {};
 		if (typeof defaultValue === "undefined" || defaultValue === "undefined") return void 0;
 		const resolvedDefaultValue = resolveConfig(mForm, defaultValue, props);
-		if (isPromise(resolvedDefaultValue)) return;
+		if (ignorePromise(resolvedDefaultValue)) return;
 		return resolvedDefaultValue;
 	};
 	var isNumberValue = (value) => typeof value === "number" && !Number.isNaN(value);
@@ -3098,9 +3112,21 @@
 		});
 		return values;
 	};
-	var resolveOptions = (props) => {
-		const { options } = props.config || {};
-		return Array.isArray(options) ? options : [];
+	/**
+	* 解析字段 options：静态数组原样返回；函数型与 `display` / `type` 一样当场求值。
+	*
+	* 函数返回 Promise、非数组或抛错时当作「还没有可选项」，交由调用方按空 options 跳过枚举。
+	* `remote` / `allowCreate` 仍由 `validateSelectValue` 单独放行，不在这里区分。
+	*/
+	var resolveOptions = (mForm, props) => {
+		let resolved;
+		try {
+			resolved = resolveConfig(mForm, props.config?.options, props);
+		} catch {
+			return [];
+		}
+		if (ignorePromise(resolved) || !Array.isArray(resolved)) return [];
+		return resolved;
 	};
 	var includesOptionValue = (optionValues, value) => optionValues.some((item) => Object.is(item, value));
 	var collectCascaderLeafValues = (options, result = []) => {
@@ -3162,19 +3188,18 @@
 			if (typeof value === "object") return defaultMessage(message, `${value} 类型不合法`, optionExampleSuggestion(optionValues, "\"文本内容\" 或 123", false));
 			return;
 		}
-		const isStaticOptions = Array.isArray(config.options);
 		if (config.multiple) {
 			if (!Array.isArray(value)) return defaultMessage(message, `${value} 类型应为数组`, optionExampleSuggestion(optionValues, "[\"选项1\", \"选项2\"]", true));
-			if (isStaticOptions && value.some((item) => !includesOptionValue(optionValues, item))) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
+			if (value.some((item) => !includesOptionValue(optionValues, item))) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
 			return;
 		}
-		if (isStaticOptions && !includesOptionValue(optionValues, value)) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
+		if (!includesOptionValue(optionValues, value)) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
 	};
 	var validateCascaderValue = (value, config, props, mForm, message) => {
-		const options = resolveOptions(props);
+		const options = resolveOptions(mForm, props);
 		if (!options.length) return;
 		const valueSeparator = resolveConfig(mForm, config.valueSeparator, props);
-		if (isPromise(valueSeparator)) return;
+		if (ignorePromise(valueSeparator)) return;
 		const emitPath = config.emitPath !== false;
 		const multiple = Boolean(config.multiple);
 		const cascaderExample = (fallbackExample) => cascaderExampleSuggestion(options, config, valueSeparator, fallbackExample);
@@ -3231,15 +3256,15 @@
 			if (!Object.is(value, activeValue) && !Object.is(value, inactiveValue)) return defaultMessage(message, `${value} 不在合法开关值中`, toggleSuggestion(activeValue, inactiveValue));
 			return;
 		}
-		if (fieldType === "select") return validateSelectValue(value, config, flattenSelectOptions(resolveOptions(props)), message);
+		if (fieldType === "select") return validateSelectValue(value, config, flattenSelectOptions(resolveOptions(mForm, props)), message);
 		if (fieldType === "radio-group") {
-			const optionValues = flattenSelectOptions(resolveOptions(props));
+			const optionValues = flattenSelectOptions(resolveOptions(mForm, props));
 			if (optionValues.length === 0) return;
 			if (!includesOptionValue(optionValues, value)) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
 			return;
 		}
 		if (fieldType === "checkbox-group") {
-			const optionValues = flattenSelectOptions(resolveOptions(props));
+			const optionValues = flattenSelectOptions(resolveOptions(mForm, props));
 			if (optionValues.length === 0) return;
 			if (!Array.isArray(value)) return defaultMessage(message, `${value} 类型应为数组`, optionExampleSuggestion(optionValues, "[\"选项1\", \"选项2\"]", true));
 			if (value.some((item) => !includesOptionValue(optionValues, item))) return defaultMessage(message, `${value} 不在可选项中`, optionSuggestion(optionValues));
@@ -3266,8 +3291,14 @@
 		if (isEmptyValue(value) || isEmptyArray(value)) return;
 		if (!props.config?.name) return;
 		const rawFieldType = "type" in (props.config || {}) ? props.config.type : "";
-		if (typeof rawFieldType !== "string" || !rawFieldType) return;
-		const fieldType = (0, _tmagic_utils.toLine)(rawFieldType);
+		let resolvedType;
+		try {
+			resolvedType = resolveConfig(mForm, rawFieldType, props);
+		} catch {
+			return;
+		}
+		if (ignorePromise(resolvedType) || typeof resolvedType !== "string" || !resolvedType) return;
+		const fieldType = (0, _tmagic_utils.toLine)(resolvedType);
 		const customValidator = getTypeMatchRule(fieldType);
 		if (customValidator) return customValidator(value, {
 			fieldType,
@@ -3674,16 +3705,20 @@
 		return type?.replace(/([A-Z])/g, "-$1").toLowerCase() || (config?.items ? "" : "text");
 	};
 	var filterFunction = (mForm, config, props) => {
-		if (typeof config === "function") return config(mForm, {
-			values: (0, vue.readonly)(mForm?.initValues || {}),
-			model: (0, vue.readonly)(props.model),
-			parent: (0, vue.readonly)(mForm?.parentValues || {}),
-			formValue: (0, vue.readonly)(mForm?.values || props.model),
-			prop: props.prop,
-			config: props.config,
-			index: props.index,
-			getFormValue: (prop) => (0, _tmagic_utils.getValueByKeyPath)(prop, mForm?.values || props.model)
-		});
+		if (typeof config === "function") {
+			const formValue = (0, vue.readonly)(mForm?.values || props.model);
+			return config(mForm, {
+				values: (0, vue.readonly)(mForm?.initValues || {}),
+				model: (0, vue.readonly)(props.model),
+				parent: (0, vue.readonly)(mForm?.parentValues || {}),
+				formValue,
+				formValues: formValue,
+				prop: props.prop,
+				config: props.config,
+				index: props.index,
+				getFormValue: (prop) => (0, _tmagic_utils.getValueByKeyPath)(prop, mForm?.values || props.model)
+			});
+		}
 		return config;
 	};
 	var display = function(mForm, config, props) {
@@ -3795,6 +3830,24 @@
 	*/
 	/** group-list 形态的 type（兼容驼峰与中划线两种写法） */
 	var isGroupListType = (type) => type === "groupList" || type === "group-list";
+	/**
+	* 归一成带单位的 CSS 长度。
+	*
+	* 配置常常来自 JSON 或表单输入，`'48'` 这类无单位数字串很常见；直接写进 CSS 变量会让
+	* 嵌套层的 `calc()` 整体失效、吸顶静默失灵，所以纯数字一律补 `px`。
+	*/
+	var toCssLength = (height) => {
+		const value = `${height ?? ""}`.trim();
+		if (!value) return void 0;
+		if ((0, _tmagic_utils.isNumber)(value)) return `${value}px`;
+		return typeof height === "number" ? void 0 : value;
+	};
+	/** header.sticky 开启时把 height 写成 CSS 变量，给嵌套吸顶偏移用 */
+	var getGroupListHeaderVars = (header) => {
+		if (!header?.sticky) return void 0;
+		const height = toCssLength(header.height);
+		return height ? { "--m-group-list-header-height": height } : void 0;
+	};
 	/** 按 label 文案长度估算 label 宽度（中文按 20px、其他按 8px，最小 80px） */
 	var calcLabelWidth = (label) => {
 		if (!label) return "0px";
@@ -4725,7 +4778,7 @@
 	};
 	var _hoisted_3$7 = ["innerHTML"];
 	var _hoisted_4$6 = ["innerHTML"];
-	var _hoisted_5$5 = ["innerHTML"];
+	var _hoisted_5$4 = ["innerHTML"];
 	var _hoisted_6$3 = ["innerHTML"];
 	var _hoisted_7$2 = ["innerHTML"];
 	var _hoisted_8$2 = ["innerHTML"];
@@ -5080,7 +5133,7 @@
 							key: 0,
 							placement: tooltip.value.placement
 						}, {
-							content: (0, vue.withCtx)(() => [(0, vue.createElementVNode)("div", { innerHTML: tooltip.value.text }, null, 8, _hoisted_5$5)]),
+							content: (0, vue.withCtx)(() => [(0, vue.createElementVNode)("div", { innerHTML: tooltip.value.text }, null, 8, _hoisted_5$4)]),
 							default: (0, vue.withCtx)(() => [((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.resolveDynamicComponent)(tagName.value), (0, vue.mergeProps)(fieldsProps.value, {
 								model: __props.model,
 								"last-values": __props.lastValues,
@@ -6478,7 +6531,7 @@
 	var _hoisted_2$7 = ["innerHTML"];
 	var _hoisted_3$6 = { key: 1 };
 	var _hoisted_4$5 = ["innerHTML"];
-	var _hoisted_5$4 = ["innerHTML"];
+	var _hoisted_5$3 = ["innerHTML"];
 	var _hoisted_6$2 = {
 		key: 2,
 		style: { "display": "flex" }
@@ -6569,7 +6622,7 @@
 					key: 0,
 					innerHTML: __props.config.extra,
 					class: "m-form-tip"
-				}, null, 8, _hoisted_5$4)) : (0, vue.createCommentVNode)("v-if", true)])), __props.config.schematic && show.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_6$2, [(0, vue.createElementVNode)("div", _hoisted_7$1, [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(__props.config.items, (item, index) => {
+				}, null, 8, _hoisted_5$3)) : (0, vue.createCommentVNode)("v-if", true)])), __props.config.schematic && show.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_6$2, [(0, vue.createElementVNode)("div", _hoisted_7$1, [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(__props.config.items, (item, index) => {
 					return (0, vue.openBlock)(), (0, vue.createBlock)(Container_default, {
 						key: key(item, index),
 						model: name.value ? __props.model[name.value] : __props.model,
@@ -6707,7 +6760,7 @@
 		style: { "display": "flex" }
 	};
 	var _hoisted_4$4 = { style: { "flex": "1" } };
-	var _hoisted_5$3 = ["src"];
+	var _hoisted_5$2 = ["src"];
 	//#endregion
 	//#region packages/form/src/containers/Panel.vue
 	var Panel_default = /* @__PURE__ */ (0, vue.defineComponent)({
@@ -6800,7 +6853,7 @@
 					}), 128))]), (0, vue.createElementVNode)("img", {
 						class: "m-form-schematic",
 						src: __props.config.schematic
-					}, null, 8, _hoisted_5$3)])) : ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, { key: 1 }, (0, vue.renderList)(items.value, (item, index) => {
+					}, null, 8, _hoisted_5$2)])) : ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, { key: 1 }, (0, vue.renderList)(items.value, (item, index) => {
 						return (0, vue.openBlock)(), (0, vue.createBlock)(Container_default, {
 							key: item[(0, vue.unref)(mForm)?.keyProp || "__key"] ?? index,
 							config: item,
@@ -7158,7 +7211,7 @@
 	var _hoisted_2$5 = { class: "m-fields-group-list-item-title" };
 	var _hoisted_3$4 = ["innerHTML"];
 	var _hoisted_4$3 = { class: "m-fields-group-list-item-actions" };
-	var _hoisted_5$2 = { style: {
+	var _hoisted_5$1 = { style: {
 		"text-align": "right",
 		"margin-top": "20px"
 	} };
@@ -7323,7 +7376,7 @@
 										disabled: __props.disabled
 									}, null, 8, ["modelValue", "disabled"]),
 									_cache[11] || (_cache[11] = (0, vue.createTextVNode)("行 ", -1))
-								]), (0, vue.createElementVNode)("div", _hoisted_5$2, [(0, vue.createVNode)((0, vue.unref)(_tmagic_design.TMagicButton), {
+								]), (0, vue.createElementVNode)("div", _hoisted_5$1, [(0, vue.createVNode)((0, vue.unref)(_tmagic_design.TMagicButton), {
 									size: "small",
 									text: "",
 									onClick: _cache[4] || (_cache[4] = ($event) => moveSpecifyLocationVisible.value = false)
@@ -7393,14 +7446,13 @@
 	});
 	//#endregion
 	//#region packages/form/src/containers/GroupList.vue?vue&type=script&setup=true&lang.ts
-	var _hoisted_1$8 = { class: "m-fields-group-list" };
-	var _hoisted_2$4 = ["innerHTML"];
-	var _hoisted_3$3 = {
+	var _hoisted_1$8 = ["innerHTML"];
+	var _hoisted_2$4 = {
 		key: 1,
 		class: "el-table__empty-block"
 	};
-	var _hoisted_4$2 = { class: "el-table__empty-text t-table__empty" };
-	var _hoisted_5$1 = { style: {
+	var _hoisted_3$3 = { class: "el-table__empty-text t-table__empty" };
+	var _hoisted_4$2 = { style: {
 		"display": "flex",
 		"justify-content": "flex-end",
 		"flex": "1"
@@ -7447,6 +7499,14 @@
 			};
 			const onAddDiffCount = () => emit("addDiffCount");
 			const asList = (value) => Array.isArray(value) ? value : [];
+			const headerVars = (0, vue.computed)(() => getGroupListHeaderVars(props.config.header));
+			/**
+			* 取 `$slots` 而不是 `useSlots()`：宿主切换 `addable` 时插槽会增删，
+			* computed 缓存不随插槽变化失效，只有在渲染期读才拿得到最新的。
+			*/
+			const hasFooter = (slots) => !props.isCompare && Boolean(slots["toggle-button"] || slots["add-button"]);
+			/** 只有真的渲染出吸底 footer，内层列表才需要为它让位 */
+			const isFooterSticky = (slots) => hasFooter(slots) && Boolean(props.config.addButtonConfig?.sticky);
 			const currentList = (0, vue.computed)(() => asList(props.model[props.name]));
 			/** 对比时按当前/历史较长一侧对齐，已删除的项也能渲染出来 */
 			const displayItems = (0, vue.computed)(() => {
@@ -7464,13 +7524,19 @@
 				}));
 			});
 			return (_ctx, _cache) => {
-				return (0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_1$8, [
+				return (0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
+					class: (0, vue.normalizeClass)(["m-fields-group-list", {
+						"is-header-sticky": Boolean(__props.config.header?.sticky),
+						"is-footer-sticky": isFooterSticky(_ctx.$slots)
+					}]),
+					style: (0, vue.normalizeStyle)(headerVars.value)
+				}, [
 					__props.config.extra ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
 						key: 0,
 						innerHTML: __props.config.extra,
 						style: { "color": "rgba(0, 0, 0, 0.45)" }
-					}, null, 8, _hoisted_2$4)) : (0, vue.createCommentVNode)("v-if", true),
-					!displayItems.value.length ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_3$3, [(0, vue.createElementVNode)("span", _hoisted_4$2, "暂无" + (0, vue.toDisplayString)(__props.config.titlePrefix || "") + "数据", 1)])) : ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, { key: 2 }, (0, vue.renderList)(displayItems.value, (entry) => {
+					}, null, 8, _hoisted_1$8)) : (0, vue.createCommentVNode)("v-if", true),
+					!displayItems.value.length ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_2$4, [(0, vue.createElementVNode)("span", _hoisted_3$3, "暂无" + (0, vue.toDisplayString)(__props.config.titlePrefix || "") + "数据", 1)])) : ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, { key: 2 }, (0, vue.renderList)(displayItems.value, (entry) => {
 						return (0, vue.openBlock)(), (0, vue.createBlock)(GroupListItem_default, {
 							key: entry.index,
 							model: entry.item,
@@ -7507,11 +7573,11 @@
 							"group-model"
 						]);
 					}), 128)),
-					!__props.isCompare && (_ctx.$slots["toggle-button"] || _ctx.$slots["add-button"]) ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
+					hasFooter(_ctx.$slots) ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
 						key: 3,
 						class: (0, vue.normalizeClass)(["m-fields-group-list-footer", { "is-sticky-full": Boolean(__props.config.addButtonConfig?.sticky) }])
-					}, [(0, vue.renderSlot)(_ctx.$slots, "toggle-button"), (0, vue.createElementVNode)("div", _hoisted_5$1, [(0, vue.renderSlot)(_ctx.$slots, "add-button")])], 2)) : (0, vue.createCommentVNode)("v-if", true)
-				]);
+					}, [(0, vue.renderSlot)(_ctx.$slots, "toggle-button"), (0, vue.createElementVNode)("div", _hoisted_4$2, [(0, vue.renderSlot)(_ctx.$slots, "add-button")])], 2)) : (0, vue.createCommentVNode)("v-if", true)
+				], 6);
 			};
 		}
 	});
@@ -8590,14 +8656,17 @@
 				const ctrl = navigator.platform.match("Mac") ? $event.metaKey : $event.ctrlKey;
 				const shift = $event.shiftKey;
 				const alt = $event.altKey;
-				if (arrowUp) if (ctrl) num += 100;
-				else if (alt) num = (num * 1e4 + 1e3) / 1e4;
-				else if (shift) num = num + 10;
-				else num += 1;
-				else if (arrowDown) if (ctrl) num -= 100;
-				else if (alt) num = (num * 1e4 - 1e3) / 1e4;
-				else if (shift) num -= 10;
-				else num -= 1;
+				if (arrowUp) {
+					if (ctrl) num += 100;
+					else if (alt) num = (num * 1e4 + 1e3) / 1e4;
+					else if (shift) num = num + 10;
+					else num += 1;
+				} else if (arrowDown) {
+					if (ctrl) num -= 100;
+					else if (alt) num = (num * 1e4 - 1e3) / 1e4;
+					else if (shift) num -= 10;
+					else num -= 1;
+				}
 				props.model[props.name] = `${num}${unit || ""}`;
 				emit("change", props.model[props.name]);
 			};

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.8.0-beta.27",
+  "version": "1.8.0-beta.29",
   "name": "@tmagic/form",
   "type": "module",
   "sideEffects": [
@@ -46,21 +46,21 @@
     "@element-plus/icons-vue": "^2.3.2",
     "@popperjs/core": "^2.11.8",
     "async-validator": "^4.2.5",
-    "dayjs": "^1.11.21",
+    "dayjs": "^1.11.23",
     "lodash-es": "^4.18.1",
     "sortablejs": "^1.15.7"
   },
   "devDependencies": {
     "@types/lodash-es": "^4.17.12",
     "@types/sortablejs": "^1.15.9",
-    "@vue/test-utils": "^2.4.11"
+    "@vue/test-utils": "^2.5.1"
   },
   "peerDependencies": {
     "typescript": "^6.0.3",
-    "vue": "^3.5.41",
-    "@tmagic/design": "1.8.0-beta.27",
-    "@tmagic/form-schema": "1.8.0-beta.27",
-    "@tmagic/utils": "1.8.0-beta.27"
+    "vue": "^3.5.43",
+    "@tmagic/design": "1.8.0-beta.29",
+    "@tmagic/utils": "1.8.0-beta.29",
+    "@tmagic/form-schema": "1.8.0-beta.29"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/src/containers/GroupList.vue

@@ -1,5 +1,12 @@
 <template>
-  <div class="m-fields-group-list">
+  <div
+    class="m-fields-group-list"
+    :class="{
+      'is-header-sticky': Boolean(config.header?.sticky),
+      'is-footer-sticky': isFooterSticky($slots),
+    }"
+    :style="headerVars"
+  >
     <div v-if="config.extra" v-html="config.extra" style="color: rgba(0, 0, 0, 0.45)"></div>
     <div v-if="!displayItems.length" class="el-table__empty-block">
       <span class="el-table__empty-text t-table__empty">暂无{{ config.titlePrefix || '' }}数据</span>
@@ -34,7 +41,7 @@
     <div
       class="m-fields-group-list-footer"
       :class="{ 'is-sticky-full': Boolean(config.addButtonConfig?.sticky) }"
-      v-if="!isCompare && ($slots['toggle-button'] || $slots['add-button'])"
+      v-if="hasFooter($slots)"
     >
       <slot name="toggle-button"></slot>
       <div style="display: flex; justify-content: flex-end; flex: 1">
@@ -49,6 +56,7 @@ import { computed } from 'vue';
 import { cloneDeep } from 'lodash-es';
 
 import type { ContainerChangeEventData, GroupListConfig } from '../schema';
+import { getGroupListHeaderVars } from '../utils/tableGroupList';
 
 import MFieldsGroupListItem from './GroupListItem.vue';
 
@@ -104,6 +112,19 @@ const onAddDiffCount = () => emit('addDiffCount');
 
 const asList = (value: unknown): any[] => (Array.isArray(value) ? value : []);
 
+const headerVars = computed(() => getGroupListHeaderVars(props.config.header));
+
+/**
+ * 取 `$slots` 而不是 `useSlots()`：宿主切换 `addable` 时插槽会增删，
+ * computed 缓存不随插槽变化失效，只有在渲染期读才拿得到最新的。
+ */
+const hasFooter = (slots: Record<string, unknown>) =>
+  !props.isCompare && Boolean(slots['toggle-button'] || slots['add-button']);
+
+/** 只有真的渲染出吸底 footer，内层列表才需要为它让位 */
+const isFooterSticky = (slots: Record<string, unknown>) =>
+  hasFooter(slots) && Boolean(props.config.addButtonConfig?.sticky);
+
 const currentList = computed(() => asList(props.model[props.name]));
 
 /** 对比时按当前/历史较长一侧对齐，已删除的项也能渲染出来 */