vue3簡單封裝input組件和統一表單數據詳解

Posted on by

前言

vue3 支持用 jsx 實現組件，擺脫瞭 vue 文件式的組件，不再需要額外的指令，寫法非常接近 React，減少記憶負擔。

本文簡單的練習，用 vue3 組件封裝 input 組件和統一表單數據。

準備工作

用vue create example創建項目，參數大概如下：

用原生 input

原生的 input，主要是 value 和 change，數據在 change 的時候需要同步。

App.tsx如下：

import { ref } from 'vue';

export default {
  setup() {
    // username就是數據
    const username = ref('張三');
    // 輸入框變化的時候，同步數據
    const onInput = ;
    return () => (
      <div>
        <input type="text"
            value={username.value}
            onInput={(e: any) => { username.value = e.target.value; }} />
        <div>input的值：{username.value}</div>
      </div>
    );
  },
};

封裝 Input

封裝 input 的好處，直接傳值，減少邏輯，不再需要額外的e.target，為後面的繼續封裝做準備。

// Input.tsx
import { defineComponent, ref } from 'vue';

// defineComponent定義組件，有props
const Input = defineComponent({
  props: {
    value: {
      required: true,
      type: String,
    },
    onChange: {
      required: true,
      type: Function,
    },
  },
  // 渲染用到props，需要在這裡傳參
  setup(props) {
    // 值變化 的時候  調用傳過來的onChange從而同步父組件的 數據
    const onInput = (e: any) => {
      props.onChange && props.onChange(e.target.value);
    };
    return () => <input type="text" value={props.value} onInput={onInput} />;
  },
});

使用Input組件

import { ref } from 'vue';
import Input from './components/Input';
export default {
  setup() {
    // 數據
    const username: any = ref('張三');
    return () => (
      <div>
        {/* 使用組件，傳value和onChange */}
        <Input
          value={username.value}
          onChange={(value: string) => (username.value = value)} // 直接在這同步數據
        />
        <div>input的值：{username.value}</div>
      </div>
    );
  },
};

封裝表單數據

表單數據，經常需要賦值、獲取值，這邊可以用類統一處理，在後面的組件賦值屬性的時候極其方便。

useForm的精華，在於proxy，訪問屬性的時候，返回field數據，這在表單組件裡可以簡潔使用。

/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
/* eslint-disable @typescript-eslint/no-explicit-any */
import { ref, Ref } from "vue";
export class FormData<T> {
  private data: Ref<any>;
  constructor(data: T) {
    this.data = ref(data || null);
  }

  // 設置某個字段的值
  setValue(name: string, val: any): void {
    const next = { ...this.data.value, [name]: val };
    this.data.value = next;
  }

  // 獲取某個字段的值
  getValue(name: string): any {
    return this.data.value[name];
  }

  // 獲取整個值
  getValues() {
    return this.data.value;
  }

  // 設置整個值
  setValues(values: T) {
    this.data.value = values;
  }

  // 獲取field，字段和字段的修改事件
  getField(name: string) {
    return {
      value: this.data.value[name],
      onChange: (v: any) => {
        this.setValue(name, v);
      },
    };
  }
}

type FormDataProxy<T> = {
  [P in keyof T]: T[P];
};

export function useForm<T extends Record<string, any>>(data: T) {
  const form = new FormData(data);
  const ver = ref(0);

  const proxy = new Proxy(form, {
    // 寫proxy的目的是：form.username的時候，直接返回 form.getField(username)
    get(target, name) {
      switch (name) {
        case "getValues":
          return form.getValues.bind(form);
        case "setValues":
          return form.setValues.bind(form);
        default:
          return form.getField(name as string);
      }
    },
    // 寫form.username = xx  直接返回 form.setValue('username',xx)
    set(target, name, value) {
      switch (name) {
        case "getValues":
        case "setValues":
          break;
        default:
          form.setValue(name as string, value);
      }
      return true;
    },
  }) as any as FormDataProxy<T> & {
    setValues: (val: T) => void;
    getValues: () => Ref<T>;
  };
  return { form: proxy, ver };
}

使用表單數據

Input組件配合表單，使用效果奇佳。

import Input from './components/Input';
import { useForm } from './hooks/useForm';

// 使用組件
export default {
  setup() {
    // 數據
    const { form, ver } = useForm({ username: '張三', age: 33 });
    console.log(123, form, ver);
    return () => (
      <div>
        {/* 這裡的form.username，實際是proxy返回的{value:xxx,onChange:fn} */}
        {/*  多表單組件的時候 這樣就非常方便瞭 */}
        <Input {...form.username} />
        <Input {...form.age} />

        <button
          onClick={() => {
            console.log(form.getValues());
          }}
        >
          提交
        </button>
      </div>
    );
  },
};

總結

到此這篇關於vue3簡單封裝input組件和統一表單數據的文章就介紹到這瞭,更多相關vue3封裝input組件內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：