feat(Form): add getValues method (#10511)

packages/vant/src/form/Form.tsx

@@ -151,10 +151,10 @@ export default defineComponent({
     };
 
     const getValues = () =>
-      children.reduce((form, field) => {
+      children.reduce<Record<string, unknown>>((form, field) => {
         form[field.name] = field.formValue.value;
         return form;
-      }, {} as Record<string, unknown>);
+      }, {});
 
     const submit = () => {
       const values = getValues();
@@ -179,6 +179,7 @@ export default defineComponent({
     useExpose<FormExpose>({
       submit,
       validate,
+      getValues,
       scrollToField,
       resetValidation,
     });

packages/vant/src/form/README.md

@@ -541,6 +541,7 @@ Use [ref](https://v3.vuejs.org/guide/component-template-refs.html) to get Form i
 | --- | --- | --- | --- |
 | submit | Submit form | - | - |
 | validate | Validate form | _name?: string \| string[]_ | _Promise_ |
+| getValues `v3.4.8` | Get current form values | - | _Record<string, unknown>_ |
 | resetValidation | Reset validation | _name?: string \| string[]_ | - |
 | scrollToField | Scroll to field | _name: string, alignToTop: boolean_ | - |
 

packages/vant/src/form/README.zh-CN.md

@@ -579,6 +579,7 @@ export default {
 | --- | --- | --- | --- |
 | submit | 提交表单，与点击提交按钮的效果等价 | - | - |
 | validate | 验证表单，支持传入 `name` 来验证单个或部分表单项 | _name?: string \| string[]_ | _Promise_ |
+| getValues `v3.4.8` | 获取所有表单项当前的值 | - | _Record<string, unknown>_ |
 | resetValidation | 重置表单项的验证提示，支持传入 `name` 来重置单个或部分表单项 | _name?: string \| string[]_ | - |
 | scrollToField | 滚动到对应表单项的位置，默认滚动到顶部，第二个参数传 false 可滚动至底部 | _name: string, alignToTop: boolean_ | - |
 

packages/vant/src/form/test/methods.spec.tsx

@@ -137,3 +137,19 @@ test('scrollToField method', () => {
   formRef.value?.scrollToField('A');
   expect(fn).toHaveBeenCalledTimes(1);
 });
+
+test('getValues method should return all current values', () => {
+  const formRef = ref<FormInstance>();
+  mount({
+    render() {
+      return (
+        <Form ref={formRef}>
+          <Field name="A" modelValue="123" />
+          <Field name="B" modelValue="456" />
+        </Form>
+      );
+    },
+  });
+
+  expect(formRef.value?.getValues()).toEqual({ A: '123', B: '456' });
+});

packages/vant/src/form/types.ts

@@ -4,6 +4,7 @@ import type { FormProps } from './Form';
 export type FormExpose = {
   submit: () => void;
   validate: (name?: string | string[] | undefined) => Promise<void>;
+  getValues: () => Record<string, unknown>;
   scrollToField: (
     name: string,
     options?: boolean | ScrollIntoViewOptions | undefined