uview-pro 0.6.18 → 0.6.19

package/components/u-form/types.ts

@@ -1,39 +1,39 @@
-import type { ExtractPropTypes, PropType } from 'vue';
-import type { FormRules, InputAlign, FormErrorType, InputLabelPosition, SizeType } from '../../types/global';
-
-/**
- * u-form 组件 Props 类型定义
- * @description 表单组件属性
- */
-export const FormProps = {
-    /** 自定义根节点样式 */
-    customStyle: {
-        type: [String, Object] as PropType<string | Record<string, any>>,
-        default: () => ({})
-    },
-    /** 自定义根节点样式类 */
-    customClass: {
-        type: String as unknown as PropType<string>,
-        default: ''
-    },
-    /** 当前form的需要验证字段的集合 */
-    model: { type: Object as PropType<Record<string, any>>, default: () => ({}) },
-    /** 表单验证规则 */
-    rules: { type: Object as PropType<FormRules>, default: () => ({}) },
-    /** 有错误时的提示方式，message-提示信息，border-如果input设置了边框，变成呈红色，border-bottom-下边框呈现红色，none-无提示 */
-    errorType: { type: Array as PropType<FormErrorType[]>, default: () => ['message', 'toast'] },
-    /** 是否显示表单域的下划线边框 */
-    borderBottom: { type: Boolean, default: true },
-    /** label的位置，left-左边，top-上边 */
-    labelPosition: { type: String as PropType<InputLabelPosition>, default: 'left' },
-    /** label的宽度，单位rpx */
-    labelWidth: { type: [String, Number] as PropType<string | number>, default: 90 },
-    /** label字体的对齐方式 */
-    labelAlign: { type: String as PropType<InputAlign>, default: 'left' },
-    /** label的样式，对象形式 */
-    labelStyle: { type: Object as PropType<Record<string, any>>, default: () => ({}) },
-    /** 表单内组件的大小，仅支持预设值 default/small/large（默认 default） */
-    size: { type: String as PropType<SizeType>, default: 'default' }
-};
-
-export type FormProps = ExtractPropTypes<typeof FormProps>;
+import type { ExtractPropTypes, PropType } from 'vue';
+import type { FormRules, InputAlign, FormErrorType, InputLabelPosition, SizeType } from '../../types/global';
+
+/**
+ * u-form 组件 Props 类型定义
+ * @description 表单组件属性
+ */
+export const FormProps = {
+    /** 自定义根节点样式 */
+    customStyle: {
+        type: [String, Object] as PropType<string | Record<string, any>>,
+        default: () => ({})
+    },
+    /** 自定义根节点样式类 */
+    customClass: {
+        type: String as unknown as PropType<string>,
+        default: ''
+    },
+    /** 当前form的需要验证字段的集合 */
+    model: { type: Object as PropType<Record<string, any>>, default: () => ({}) },
+    /** 表单验证规则 */
+    rules: { type: Object as PropType<FormRules>, default: () => ({}) },
+    /** 有错误时的提示方式，message-提示信息，border-如果input设置了边框，变成呈红色，border-bottom-下边框呈现红色，none-无提示 */
+    errorType: { type: Array as PropType<FormErrorType[]>, default: () => ['message', 'toast'] },
+    /** 是否显示表单域的下划线边框 */
+    borderBottom: { type: Boolean, default: true },
+    /** label的位置，left-左边，top-上边 */
+    labelPosition: { type: String as PropType<InputLabelPosition>, default: 'left' },
+    /** label的宽度，单位rpx */
+    labelWidth: { type: [String, Number] as PropType<string | number>, default: 90 },
+    /** label字体的对齐方式 */
+    labelAlign: { type: String as PropType<InputAlign>, default: 'left' },
+    /** label的样式，对象形式 */
+    labelStyle: { type: Object as PropType<Record<string, any>>, default: () => ({}) },
+    /** 表单内组件的大小，仅支持预设值 default/small/large（默认 default） */
+    size: { type: String as PropType<SizeType>, default: 'default' }
+};
+
+export type FormProps = ExtractPropTypes<typeof FormProps>;

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

@@ -1,135 +1,175 @@
-<template>
-    <view class="u-form" :class="customClass" :style="$u.toStyle(customStyle)">
-        <slot />
-    </view>
-</template>
-
-<script lang="ts">
-export default {
-    name: 'u-form',
-    options: {
-        addGlobalClass: true,
-        // #ifndef MP-TOUTIAO
-        virtualHost: true,
-        // #endif
-        styleIsolation: 'shared'
-    }
-};
-</script>
-
-<script setup lang="ts">
-import { FormProps } from './types';
-import { computed, ref } from 'vue';
-import { $u, useParent } from '../..';
-
-/**
- * form 表单
- * @description 此组件一般用于表单场景，可以配置Input输入框，Select弹出框，进行表单验证等。
- * @tutorial https://uviewpro.cn/zh/components/form.html
- * @property {Object} model 表单数据对象
- * @property {Boolean} border-bottom 是否显示表单域的下划线边框
- * @property {String} label-position 表单域提示文字的位置，left-左侧，top-上方
- * @property {String Number} label-width 提示文字的宽度，单位rpx（默认90）
- * @property {Object} label-style label的样式，对象形式
- * @property {String} label-align label的对齐方式
- * @property {Object} rules 通过ref设置，见官网说明
- * @property {Array} error-type 错误的提示方式，数组形式，见上方说明(默认['message'])
- * @example <u-form :model="form" ref="uForm"></u-form>
- */
-
-const props = defineProps(FormProps);
-
-useParent('u-form');
-
-interface ErrorItem {
-    prop: string;
-    message: string;
-}
-
-// 存储当前form下的所有u-form-item的实例
-const fields = ref<any[]>([]);
-
-// 校验规则
-const rules = ref<Record<string, any>>(props.rules);
-
-/**
- * 设置校验规则
- * @param newRules 校验规则对象
- */
-function setRules(newRules: Record<string, any>) {
-    rules.value = newRules;
-}
-
-/**
- * 清空所有u-form-item组件的内容，本质上是调用了u-form-item组件中的resetField()方法
- */
-function resetFields() {
-    fields.value.forEach((field: any) => {
-        field.resetField && field.resetField();
-    });
-}
-
-/**
- * 校验全部数据
- * @param callback 校验回调
- * @returns Promise<boolean>
- */
-function validate(callback?: (valid: boolean, errorArr: ErrorItem[]) => void): Promise<boolean> {
-    return new Promise(resolve => {
-        // 对所有的u-form-item进行校验
-        let valid = true; // 默认通过
-        let count = 0; // 用于标记是否检查完毕
-        let errorArr: ErrorItem[] = []; // 存放错误信息
-        if (fields.value.length === 0) {
-            resolve(true);
-            if (typeof callback === 'function') callback(true, []);
-            return;
-        }
-        // 调用每一个u-form-item实例的validation的校验方法
-        fields.value.forEach((field: any) => {
-            // 如果任意一个u-form-item校验不通过，就意味着整个表单不通过
-            field.validation &&
-                field.validation('', (error: any) => {
-                    if (error) {
-                        valid = false;
-                        errorArr.push({ prop: field.prop, message: error });
-                    }
-                    // 当历遍了所有的u-form-item时，调用promise的then方法
-                    if (++count === fields.value.length) {
-                        resolve(valid); // 进入promise的then方法
-                        // 判断是否设置了toast的提示方式，只提示最前面的表单域的第一个错误信息
-                        if (
-                            props.errorType.indexOf('none') === -1 &&
-                            props.errorType.indexOf('toast') >= 0 &&
-                            errorArr.length > 0
-                        ) {
-                            errorArr[0].message && $u.toast(errorArr[0].message);
-                        }
-                        // 调用回调方法
-                        if (typeof callback === 'function') callback(valid, errorArr);
-                    }
-                });
-        });
-    });
-}
-
-defineExpose({
-    setRules,
-    resetFields,
-    validate,
-    addField(field: any) {
-        if (!fields.value.includes(field)) fields.value.push(field);
-    },
-    removeField(field: any) {
-        fields.value = fields.value.filter(f => f.prop !== field.prop);
-    },
-    fields,
-    rules,
-    props,
-    model: computed(() => props.model)
-});
-</script>
-
-<style scoped lang="scss">
-@import '../../libs/css/style.components.scss';
-</style>
+<template>
+    <view class="u-form" :class="customClass" :style="$u.toStyle(customStyle)">
+        <slot />
+    </view>
+</template>
+
+<script lang="ts">
+export default {
+    name: 'u-form',
+    options: {
+        addGlobalClass: true,
+        // #ifndef MP-TOUTIAO
+        virtualHost: true,
+        // #endif
+        styleIsolation: 'shared'
+    }
+};
+</script>
+
+<script setup lang="ts">
+import { FormProps } from './types';
+import { computed, ref } from 'vue';
+import { $u, useParent } from '../..';
+
+/**
+ * form 表单
+ * @description 此组件一般用于表单场景，可以配置Input输入框，Select弹出框，进行表单验证等。
+ * @tutorial https://uviewpro.cn/zh/components/form.html
+ * @property {Object} model 表单数据对象
+ * @property {Boolean} border-bottom 是否显示表单域的下划线边框
+ * @property {String} label-position 表单域提示文字的位置，left-左侧，top-上方
+ * @property {String Number} label-width 提示文字的宽度，单位rpx（默认90）
+ * @property {Object} label-style label的样式，对象形式
+ * @property {String} label-align label的对齐方式
+ * @property {Object} rules 通过ref设置，见官网说明
+ * @property {Array} error-type 错误的提示方式，数组形式，见上方说明(默认['message'])
+ * @example <u-form :model="form" ref="uForm"></u-form>
+ */
+
+const props = defineProps(FormProps);
+
+useParent('u-form');
+
+interface ErrorItem {
+    prop: string;
+    message: string;
+}
+
+// 存储当前form下的所有u-form-item的实例
+const fields = ref<any[]>([]);
+
+// 校验规则
+const rules = ref<Record<string, any>>(props.rules);
+
+/**
+ * 设置校验规则
+ * @param newRules 校验规则对象
+ */
+function setRules(newRules: Record<string, any>) {
+    rules.value = newRules;
+}
+
+/**
+ * 清空所有u-form-item组件的内容，本质上是调用了u-form-item组件中的resetField()方法
+ */
+function resetFields() {
+    fields.value.forEach((field: any) => {
+        field.resetField && field.resetField();
+    });
+}
+
+/**
+ * 校验全部数据
+ * @param callback 校验回调
+ * @returns Promise<boolean>
+ */
+function validate(callback?: (valid: boolean, errorArr: ErrorItem[]) => void): Promise<boolean> {
+    return new Promise(resolve => {
+        // 对所有的u-form-item进行校验
+        let valid = true; // 默认通过
+        let count = 0; // 用于标记是否检查完毕
+        let errorArr: ErrorItem[] = []; // 存放错误信息
+        if (fields.value.length === 0) {
+            resolve(true);
+            if (typeof callback === 'function') callback(true, []);
+            return;
+        }
+        // 调用每一个u-form-item实例的validation的校验方法
+        fields.value.forEach((field: any) => {
+            // 如果任意一个u-form-item校验不通过，就意味着整个表单不通过
+            field.validation &&
+                field.validation('', (error: any) => {
+                    if (error) {
+                        valid = false;
+                        errorArr.push({ prop: field.prop, message: error });
+                    }
+                    // 当历遍了所有的u-form-item时，调用promise的then方法
+                    if (++count === fields.value.length) {
+                        resolve(valid); // 进入promise的then方法
+                        // 判断是否设置了toast的提示方式，只提示最前面的表单域的第一个错误信息
+                        if (
+                            props.errorType.indexOf('none') === -1 &&
+                            props.errorType.indexOf('toast') >= 0 &&
+                            errorArr.length > 0
+                        ) {
+                            errorArr[0].message && $u.toast(errorArr[0].message);
+                        }
+                        // 调用回调方法
+                        if (typeof callback === 'function') callback(valid, errorArr);
+                    }
+                });
+        });
+    });
+}
+
+/**
+ * 校验指定字段（支持单个字段名或字段名数组）
+ * @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);
+    },
+    removeField(field: any) {
+        fields.value = fields.value.filter(f => f.prop !== field.prop);
+    },
+    fields,
+    rules,
+    props,
+    model: computed(() => props.model)
+});
+</script>
+
+<style scoped lang="scss">
+@import '../../libs/css/style.components.scss';
+</style>

package/components/u-form-item/types.ts

@@ -1,95 +1,95 @@
-import type { PropType, ExtractPropTypes } from 'vue';
-import type { InputAlign, InputLabelPosition, SizeType } from '../../types/global';
-
-/**
- * form-item 表单item Props
- */
-export const FormItemProps = {
-    /** 自定义根节点样式 */
-    customStyle: {
-        type: [String, Object] as PropType<string | Record<string, any>>,
-        default: () => ({})
-    },
-    /** 自定义根节点样式类 */
-    customClass: {
-        type: String as unknown as PropType<string>,
-        default: ''
-    },
-    /** input的label提示语 */
-    label: {
-        type: String,
-        default: ''
-    },
-    /** 绑定的值 */
-    prop: {
-        type: String,
-        default: ''
-    },
-    /** 是否显示表单域的下划线边框 */
-    borderBottom: {
-        type: [String, Boolean] as PropType<string | boolean>,
-        default: ''
-    },
-    /** label的位置，left-左边，top-上边 */
-    labelPosition: {
-        type: String as PropType<InputLabelPosition>,
-        default: ''
-    },
-    /** label的宽度，单位rpx */
-    labelWidth: {
-        type: [String, Number] as PropType<string | number>,
-        default: ''
-    },
-    /** label的样式，对象形式 */
-    labelStyle: {
-        type: Object as PropType<Record<string, any>>,
-        default: () => ({})
-    },
-    /** label字体的对齐方式 */
-    labelAlign: {
-        type: String as PropType<InputAlign>,
-        default: ''
-    },
-    /** 右侧图标 */
-    rightIcon: {
-        type: String,
-        default: ''
-    },
-    /** 左侧图标 */
-    leftIcon: {
-        type: String,
-        default: ''
-    },
-    /** 左侧图标的自定义前缀 */
-    leftIconPrefix: {
-        type: String,
-        default: 'uicon'
-    },
-    /** 右侧图标的自定义前缀 */
-    rightIconPrefix: {
-        type: String,
-        default: 'uicon'
-    },
-    /** 左侧图标的样式 */
-    leftIconStyle: {
-        type: Object as PropType<Record<string, any>>,
-        default: () => ({})
-    },
-    /** 右侧图标的样式 */
-    rightIconStyle: {
-        type: Object as PropType<Record<string, any>>,
-        default: () => ({})
-    },
-    /** 是否显示左边的必填星号，只作显示用，具体校验必填的逻辑，请在rules中配置 */
-    required: {
-        type: Boolean,
-        default: false
-    },
-    /** 表单内组件的大小，仅支持预设值 default/small/large */
-    size: {
-        type: String as PropType<SizeType | string>,
-        default: ''
-    }
-};
-
-export type FormItemProps = ExtractPropTypes<typeof FormItemProps>;
+import type { PropType, ExtractPropTypes } from 'vue';
+import type { InputAlign, InputLabelPosition, SizeType } from '../../types/global';
+
+/**
+ * form-item 表单item Props
+ */
+export const FormItemProps = {
+    /** 自定义根节点样式 */
+    customStyle: {
+        type: [String, Object] as PropType<string | Record<string, any>>,
+        default: () => ({})
+    },
+    /** 自定义根节点样式类 */
+    customClass: {
+        type: String as unknown as PropType<string>,
+        default: ''
+    },
+    /** input的label提示语 */
+    label: {
+        type: String,
+        default: ''
+    },
+    /** 绑定的值 */
+    prop: {
+        type: String,
+        default: ''
+    },
+    /** 是否显示表单域的下划线边框 */
+    borderBottom: {
+        type: [String, Boolean] as PropType<string | boolean>,
+        default: ''
+    },
+    /** label的位置，left-左边，top-上边 */
+    labelPosition: {
+        type: String as PropType<InputLabelPosition>,
+        default: ''
+    },
+    /** label的宽度，单位rpx */
+    labelWidth: {
+        type: [String, Number] as PropType<string | number>,
+        default: ''
+    },
+    /** label的样式，对象形式 */
+    labelStyle: {
+        type: Object as PropType<Record<string, any>>,
+        default: () => ({})
+    },
+    /** label字体的对齐方式 */
+    labelAlign: {
+        type: String as PropType<InputAlign>,
+        default: ''
+    },
+    /** 右侧图标 */
+    rightIcon: {
+        type: String,
+        default: ''
+    },
+    /** 左侧图标 */
+    leftIcon: {
+        type: String,
+        default: ''
+    },
+    /** 左侧图标的自定义前缀 */
+    leftIconPrefix: {
+        type: String,
+        default: 'uicon'
+    },
+    /** 右侧图标的自定义前缀 */
+    rightIconPrefix: {
+        type: String,
+        default: 'uicon'
+    },
+    /** 左侧图标的样式 */
+    leftIconStyle: {
+        type: Object as PropType<Record<string, any>>,
+        default: () => ({})
+    },
+    /** 右侧图标的样式 */
+    rightIconStyle: {
+        type: Object as PropType<Record<string, any>>,
+        default: () => ({})
+    },
+    /** 是否显示左边的必填星号，只作显示用，具体校验必填的逻辑，请在rules中配置 */
+    required: {
+        type: Boolean,
+        default: false
+    },
+    /** 表单内组件的大小，仅支持预设值 default/small/large */
+    size: {
+        type: String as PropType<SizeType | string>,
+        default: ''
+    }
+};
+
+export type FormItemProps = ExtractPropTypes<typeof FormItemProps>;