litmoss-form 5.0.1 → 5.1.0

package/README.md

@@ -36,7 +36,7 @@ npm i litmoss-form
 | `classnames`         | `^2.5.1`   |
 | `cyndi`              | `^1.0.0`   |
 | `exception-boundary` | `^2.0.1`   |
-| `litmoss-hooks`      | `^1.1.0`   |
+| `litmoss-hooks`      | `^3.0.0`   |
 | `lodash`             | `^4.17.21` |
 
 ## 快速开始
@@ -133,6 +133,7 @@ function Demo() {
 | `setValueByPath(path, value)`   | 设置指定表单项的值                                |
 | `setHelpTextByPath(path, text)` | 设置指定表单项的提示信息                          |
 | `validate({ focusOnError? })`   | 校验表单，返回失败项的 `{ path, helpInfo }` 数组  |
+| `validateField(path)`           | 通过属性路径验证表单项的方法,并返回验证结果       |
 | `focusFieldByPath(path)`        | 聚焦指定表单项                                    |
 
 ### 常量

package/dist/components/form/form.types.d.ts

@@ -244,6 +244,12 @@ export interface FormRef {
     validate: (options?: {
         focusOnError?: boolean;
     }) => FormItemHelper[];
+    /**
+     * 通过属性路径验证表单项的方法
+     * @param path 表单项的值路径
+     * @returns 验证结果，包含帮助信息和路径
+     */
+    validateField: (path: string) => FormItemHelper;
     /**
      * 通过属性路径聚焦表单项对应控件的方法
      * @param path 表单项的值路径

package/dist/components/form/formUtil.d.ts

@@ -33,6 +33,16 @@ export declare function setValues(args: FormArgs, formRegister: FormRegister): F
  * @param formRegister 当前表单的注册器对象
  */
 export declare function setValueByPath(path: string, value: unknown, formRegister: FormRegister): FormHelperInfo;
+/**
+ * 通过属性路径验证表单项的方法
+ * @param path 表单项的唯一路径（valuePath）
+ * @param formRegister 当前表单的注册器对象
+ * @returns 验证结果，包含帮助信息和路径
+ */
+export declare function validateField(path: string, formRegister: FormRegister): {
+    helpInfo: FormHelperInfo;
+    path: string;
+} | undefined;
 /**
  * 聚焦指定表单项
  * @param path 表单项的唯一路径（valuePath）

package/dist/index.js

@@ -140,12 +140,23 @@ function M(e, t, n) {
 	} else x(S(e));
 }
 function N(e, t) {
+	let n = t[e];
+	if (n !== void 0) {
+		let { validate: t, get: r } = n, i = r?.();
+		return {
+			helpInfo: t?.(i),
+			path: e
+		};
+	}
+	x(S(e));
+}
+function P(e, t) {
 	let n = t[e];
 	n ? n.fieldRef?.current?.focus ? n.fieldRef.current.focus() : x(E(e)) : x(S(e));
 }
 //#endregion
 //#region src/components/form/form.tsx
-var P = t(({ children: e, prefixCls: t, validationMode: n = f.all, ...r }, a) => {
+var F = t(({ children: e, prefixCls: t, validationMode: n = f.all, ...r }, a) => {
 	let [c] = o({}), [l, u] = o(), [p] = o(() => v(c, u));
 	return i(a, () => ({
 		getValues: () => O(c),
@@ -159,12 +170,13 @@ var P = t(({ children: e, prefixCls: t, validationMode: n = f.all, ...r }, a) =>
 			let { focusOnError: t } = e || {}, r = g(c, n);
 			if (t !== !1 && r.length > 0) {
 				let e = r[0];
-				N(e.path, c);
+				P(e.path, c);
 			}
 			return r;
 		},
+		validateField: (e) => N(e, c),
 		focusFieldByPath: (e) => {
-			N(e, c);
+			P(e, c);
 		}
 	}), [c, n]), /* @__PURE__ */ d(s, {
 		errorMsg: l,
@@ -178,10 +190,10 @@ var P = t(({ children: e, prefixCls: t, validationMode: n = f.all, ...r }, a) =>
 		})
 	});
 });
-P.displayName = c.Form;
+F.displayName = c.Form;
 //#endregion
 //#region src/components/form/useForm.ts
-function F() {
+function I() {
 	let e = a(), [t, n] = o();
 	return r(() => (n(e.current), () => {
 		e.current = void 0;
@@ -189,7 +201,7 @@ function F() {
 }
 //#endregion
 //#region src/components/form/useFormItemValue.ts
-function I(e, t, i, a, s) {
+function L(e, t, i, a, s) {
 	let c = n(_), [l, u] = o(t);
 	return r(() => (c?.checkValuePath(e), () => {
 		c?.uninstall(e);
@@ -213,14 +225,14 @@ function I(e, t, i, a, s) {
 }
 //#endregion
 //#region src/components/inject.ts
-var L = {};
-function R(e) {
+var R = {};
+function z(e) {
 	let { commonValidationAssert: t, getDefaultHelperInfo: n, getInitialValue: r } = e;
-	L.commonValidationAssert = t, L.getDefaultHelperInfo = n, L.getInitialValue = r;
+	R.commonValidationAssert = t, R.getDefaultHelperInfo = n, R.getInitialValue = r;
 }
 //#endregion
 //#region src/components/form/useHelperInfo.ts
-function z(e) {
+function B(e) {
 	let [t, n] = o();
 	function r(t, r) {
 		let i, a = !1, o = e.length;
@@ -232,13 +244,13 @@ function z(e) {
 					x(D(r));
 					break;
 				}
-			} else if (L.commonValidationAssert) a = L.commonValidationAssert(t, s) === !1;
+			} else if (R.commonValidationAssert) a = R.commonValidationAssert(t, s) === !1;
 			else {
 				x(T());
 				break;
 			}
 			if (a) {
-				i = o ?? (L.getDefaultHelperInfo ? L.getDefaultHelperInfo(s) : void 0);
+				i = o ?? (R.getDefaultHelperInfo ? R.getDefaultHelperInfo(s) : void 0);
 				break;
 			}
 		}
@@ -252,8 +264,8 @@ function z(e) {
 }
 //#endregion
 //#region src/components/mounter/mounter.tsx
-var B = ({ onDidMount: e }) => (r(() => {
+var V = ({ onDidMount: e }) => (r(() => {
 	e?.();
 }, []), null);
 //#endregion
-export { p as BaseValidationType, P as Form, B as Mounter, f as ValidationMode, R as initLittenForm, F as useForm, I as useFormItemValue, z as useHelperInfo };
+export { p as BaseValidationType, F as Form, V as Mounter, f as ValidationMode, z as initLittenForm, I as useForm, L as useFormItemValue, B as useHelperInfo };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "litmoss-form",
   "private": false,
-  "version": "5.0.1",
+  "version": "5.1.0",
   "type": "module",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -98,4 +98,4 @@
     "type": "git",
     "url": "git+https://github.com/liuxian496/litmoss-form.git"
   }
-}
+}