uview-pro 0.6.19-rc.0 → 0.6.19

package/changelog.md

@@ -1,3 +1,13 @@
+## 0.6.19（2026-09-07）
+
+### ✨ Features | 新功能
+
+- **u-form:** 新增validateField表单校验方法，支持单个或多个字段校验（#180） ([9e77c3a](https://github.com/anyup/uView-Pro/commit/9e77c3a0dd099f831b8dccbc9e203dd433ecfda2))
+
+### 👥 Contributors
+
+<a href="https://github.com/anyup"><img src="https://github.com/anyup.png?size=40" width="40" height="40" alt="anyup" title="anyup"/></a> 
+
 ## 0.6.18（2026-09-03）
 
 ### 🐛 Bug Fixes | Bug 修复

package/components/u-form/u-form.vue

@@ -113,10 +113,50 @@ function validate(callback?: (valid: boolean, errorArr: ErrorItem[]) => void): P
     });
 }
 
+/**
+ * 校验指定字段（支持单个字段名或字段名数组）
+ * @param prop 字段名（对应 u-form-item 的 prop），可传字符串或数组
+ * @param callback 校验回调，参数为 (valid: boolean, errorArr: ErrorItem[])
+ * @returns Promise<boolean>
+ */
+function validateField(
+    prop: string | string[],
+    callback?: (valid: boolean, errorArr: ErrorItem[]) => void
+): Promise<boolean> {
+    const props = Array.isArray(prop) ? prop : [prop];
+    // 从 fields 中精确匹配指定 prop
+    const targetFields = fields.value.filter((field: any) => props.indexOf(field.prop) !== -1);
+
+    return new Promise(resolve => {
+        let valid = true;
+        let count = 0;
+        let errorArr: ErrorItem[] = [];
+        if (targetFields.length === 0) {
+            resolve(true);
+            if (typeof callback === 'function') callback(true, []);
+            return;
+        }
+        targetFields.forEach((field: any) => {
+            // 复用 u-form-item 的 validation，确保其自身错误状态被更新/清除
+            field.validation('', (error: any) => {
+                if (error) {
+                    valid = false;
+                    errorArr.push({ prop: field.prop, message: error });
+                }
+                if (++count === targetFields.length) {
+                    resolve(valid);
+                    if (typeof callback === 'function') callback(valid, errorArr);
+                }
+            });
+        });
+    });
+}
+
 defineExpose({
     setRules,
     resetFields,
     validate,
+    validateField,
     addField(field: any) {
         if (!fields.value.includes(field)) fields.value.push(field);
     },

package/package.json

@@ -2,7 +2,7 @@
     "id": "uview-pro",
     "name": "uview-pro",
     "displayName": "【支持鸿蒙】uView Pro｜基于Vue3+TS的高质量UI组件库，支持多主题、暗黑模式、多语言",
-    "version": "0.6.19-rc.0",
+    "version": "0.6.19",
     "description": "uView Pro是基于Vue3+TS的多平台UI框架，提供80+高质量组件、便捷工具和常用模板，支持多主题、暗黑模式、多语言，支持H5/APP/鸿蒙/小程序多端开发。已在鸿蒙应用商店上架，欢迎体验！",
     "main": "index.ts",
     "module": "index.ts",