使用Vue Composition API寫出清晰、可擴充套件的表單實現
表單是前端開發中最棘手的部分之一,您可能會在其中發現很多混亂的程式碼。
基於元件的框架,如 Vue.js,在提高前端程式碼的可擴充套件性方面做了很多工作,但是表單的問題仍然存在。
在本教程中,將向您展示新的 Vue Composition API(即將加入 Vue 3 中)如何使表單程式碼更清晰、更具可擴充套件性。
為什麼表單程式碼經常很爛
像 Vue 這種基於元件的框架的關鍵設計模式是元件組合。
這種模式將應用程式的特性抽象為獨立的、單一用途的元件,這些元件通訊使用 props 和事件的方式。
然而,在此模式下,不能很好地對錶單進行抽象,因為表單的功能和狀態顯然不屬於任何一個元件,因此將其分離通常會導致與解決的問題一樣多的問題。
在 Vue 中表單程式碼寫的爛的另一個重要原因是,直到 Vue2 之前, 還沒有提供強大的手段在元件之間重用程式碼。重用程式碼對錶單來說很重要,因為表單輸入通常有明顯的不同,但在功能上有許多相似之處。
Vue2 提供的程式碼重用的主要方法是 mixin,我認為這是一個明顯的反模式。
Mixins 被認為“有害”
早在2016年中期,丹·阿布拉莫夫(Dan Abramov)就寫了《mixin被認為是有害的》(mixin Considered Harmful),他在書中辯稱,將 mixin 用於在 React 元件中重用邏輯是一種反模式,主張遠離它們。
不幸的是,他提到的關於 React mixins 的缺點同樣適用於 Vue。在瞭解 Composition API 克服這些缺點之前,讓我們熟悉這些缺點。
命名衝突
使用 mixin 模式在執行時合併兩個物件,如果他們兩個都共享同名屬性,會發生什麼?
const mixin = { data: () => ({ myProp: null }) } export default { mixins: [mixin],data: () => ({ // 同名! myProp: null }) }
這就是合併策略發揮作用的地方。這是一組規則,用於確定當一個元件包含多個具有相同名稱的選項時會發生什麼。
Vue 元件的預設(可選配置)合併策略指示本地選項將覆蓋 mixin 選項。不過也有例外,例如,如果我們有多個相同型別的生命週期鉤子,這些鉤子將被新增到一個鉤子陣列中,並且所有的鉤子都將被依次呼叫。
儘管我們不應該遇到任何實際的錯誤,但是在跨多個元件和 mixin 處理命名屬性時,編寫程式碼變得越來越困難。一旦第三方 mixin 作為帶有自己命名屬性的 npm 包被新增進來,就會特別困難,因為它們可能會導致衝突。
隱式依賴
mixin 和使用它的元件之間沒有層次關係。
這意味著元件可以使用 mixin 中定義的資料屬性(例如mySharedDataProperty),但是 mixin 也可以使用元件中定義的資料屬性(例如myLocalDataProperty)。這種情況通常是在 mixin 被用於共享輸入驗證時出現的,mixin 可能會期望一個元件有一個輸入值,它將在自己的 validate 方法中使用。
不過,這可能會引起一些問題。如果我們以後想重構一個元件,改變了 mixin 需要的變數名稱,會發生什麼情況呢?我們在看這個元件時,不會發現有什麼問題。程式碼檢查也不會發現它,只會在執行時看到錯誤。
現在想象一個有很多 mixin 的元件。我們可以重構本地資料屬性嗎?或者它會破壞 mixin 嗎?我們得手動搜尋才能知道。
mixins 的缺點是 Composition API 背後的主要推動因素之一,來看看它如何克服 mixin 的問題,寫出清晰、可擴充套件的表單程式碼。
在 Vue2 專案新增 Vue Composition API
通過 Vue CLI 建立一個專案,將 Composition API 作為外掛新增到 Vue 2 專案中。
$ vue create composition-api-form $ cd composition-api-form $ npm i -S @vue/composition-api
接下來,在 main.js 中加入這個外掛
import Vue from "vue"; import App from "./App.vue"; import VueCompositionApi from "@vue/composition-api"; Vue.use(VueCompositionApi); new Vue({ render: h => h(App) }).$mount('#app');
建立輸入元件
為了使這個例子簡單,我們將建立一個僅包含輸入名字和電子郵件的獨立的元件。
$ touch src/components/InputName.vue $ touch src/components/InputEmail.vue
設定 InputName 元件模板,包括一個 HTML 輸入元素,並使用 v-model 指令建立雙向繫結。
src/components/InputName.vue
<template> <div> <label> Name <input type="text" v-model="input" name="name" /> </label> </div> </template> <script> export default { name: 'InputName' } </script>
設定表單
將新增 novalidate 屬性,讓瀏覽器知道我們將提供自定義驗證。還將監聽表單的 submit 事件,防止表單自動提交,並使用宣告的 onSubmit 方法處理該事件。
然後,新增 InputName 和 InputEmail 元件,並分別將本地狀態值 name 和 email 進行繫結。
src/App.vue
<template> <div id="app"> <form novalidate @submit.prevent="onSubmit"> <InputName v-model="name" /> <InputEmail v-model="email" /> <button type="submit">Submit</button> </form> </div> </template> <script> import InputName from "@/components/InputName"; import InputEmail from "@/components/InputEmail"; export default { name: 'App',components: { InputName,InputEmail } } </script>
接下來使用 Composition API 定義表單功能。在元件定義中新增 setup 方法,並使用 Composition API 提供的 ref 方法宣告兩個狀態變數 name 和 email。
然後宣告一個 onSubmit 函式來處理表單提交。
src/App.vue
// 其餘省略 ... import { ref } from "@vue/composition-api"; export default { name: "App",setup () { const name = ref(""); const email = ref(""); function onSubmit() { // 這裡可以寫提交後端的邏輯 console.log(name.value,email.value); } return { name,email,onSubmit } },... }
設定輸入元件
接下來,將定義 InputName 元件的功能。
在元件上使用了 v-model 指令,就和元件建立了雙向繫結,在元件內部的 props 上定義 value 來接收值,這隻做了一半的工作。
建立一個 setup 函式。props 和元件例項被傳遞到這個方法中,使我們能夠訪問元件例項上的方法。
用解構的方式在第二個引數中獲得 emit 方法。將需要它來完成 v-model 的雙向繫結的另一半工作,即觸發 input 事件,修改繫結的值。
在此之前,宣告一個狀態變數 input,將繫結到我們在模板中宣告的 HTML 元素上。
該變數的值是待定義的合成函式 useInputValidator 執行後返回的值。此函式將處理所有常見的驗證邏輯。
把 prop.value 傳遞給這個方法作為第一個引數,第二個引數是一個回撥函式,接收經過驗證後的輸入值,在這個回撥函式中觸發 input 事件,修改 v-model 繫結的值,實現和父元件雙向繫結的功能。
src/components/InputName.vue
<template> <div> <label> Name <input type="text" v-model="input" name="name" /> </label> </div> </template> <script> import useInputValidator from "@/features/useInputValidator"; export default { name: "InputName",props: { value: String },setup (props,{ emit }) { const { input } = useInputValidator( props.value,value => emit("input",value) ); // 繫結在元素上 return { input } } } </script>
輸入框驗證功能
開始建立 useInputValidator 組合函式,為此,首先建立一個 features 資料夾,然後為其建立一個模組檔案。
$ mkdir src/features $ touch src/features/useInputValidator.js
在模組檔案中,將匯出一個函式,它需要兩個引數: 從父表單接收到的值,用 startVal 接收;以及一個回撥函式,用 onValidate 接收。
函式需要返回一個 input 狀態變數,因此需要宣告它,通過呼叫 ref 並提供 startVal 的值進行初始化。
在從函式返回 input 之前,觀察該值的變化,並呼叫 onValidate回撥,傳入最新的 input 的值。
src/features/useInputValidator.js
import { ref,watch } from "@vue/composition-api"; export default function (startVal,onValidate) { let input = ref(startVal); watch(input,value => { onValidate(value); }); return { input } }
新增驗證器
下一步新增驗證器函式。對於 InputName 元件,只有一個驗證規則 minLength,確保輸入是三個字元或更多。尚未建立的 InputEmail 元件將需要電子郵件驗證規則。
將在 src 資料夾中建立模組 validators.js,並寫這些驗證器。在實際的專案中,您可能會使用第三方庫。
不會詳細介紹 validator 函式,但是有兩件重要的事情需要注意:
- 這些是返回函式的函式。這樣的結構允許我們通過傳遞成為閉包一部分的引數來定製驗證規則。
- 每個驗證器返回的函式總是返回一個字串(錯誤訊息),如果沒有錯誤,則返回 null。
src/validators.js
const minLength = min => { return input => input.length < min ? `Value must be at least ${min} characters` : null; }; const isEmail = () => { const re = /\S+@\S+\.\S+/; return input => re.test(input) ? null : "Must be a valid email address"; } export { minLength,isEmail };
回到上面的組合函式所在檔案 useInputValidator.js 中,我們希望使用需要的驗證,給函式新增另一個引數,它是一組驗證函式。
在 input 監視器內部,使用陣列的 map 方法呼叫驗證函式,將 input 的當前值傳遞給每個驗證器方法。
返回值將在一個新的狀態變數 errors 中捕獲,也將返回給所在元件使用。
src/features/useInputValidator.js
export default function (startVal,validators,onValidate) { const input = ref(startVal); const errors = ref([]); watch(input,value => { errors.value = validators.map(validator => validator(value)); onValidate(value); }); return { input,errors } }
最後回到 InputName 元件,現在將為 useInputValidator 方法提供必需的三個引數。
第二個引數現在是一個驗證器陣列,因此讓我們在適當的地方宣告一個數組,並傳入 minLength 方法。
minLength 是一個工廠函式,呼叫並傳遞指定的最小長度。
現在我們還從合成函式返回的物件獲取 input 和 errors,它們都將從 setup 方法返回,以便在元件中可用。
src/components/InputName.vue
// 省略其他程式碼 ... import { minLength } from "@/validators"; import useInputValidator from "@/features/useInputValidator"; export default { ... setup (props,{ emit }) { const { input,errors } = useInputValidator( props.value,[ minLength(3) ],value) ); return { input,errors } } }
這是我們將新增到該元件的最後一個功能。在我們繼續之前,花點時間對比一下這段程式碼比使用mixin可讀性強得多。
首先,可以清楚地看到狀態變數在哪裡宣告和修改,而不必切換到單獨的 mixin 模組檔案。另外,不需要擔心區域性變數和複合函式之間的名稱衝突。
顯示錯誤
進入 InputName 元件的模板,有潛在的錯誤陣列要顯示,將其委託給一個稱為 ErrorDisplay 的元件來顯示錯誤。
src/components/InputName.vue
<template> <div> <label> Name <input type="text" v-model="input" name="name" /> </label> <ErrorDisplay :errors="errors" /> </div> </template> <script> ... import ErrorDisplay from "@/components/ErrorDisplay"; export default: { ... components: { ErrorDisplay } } </script>
ErrorDisplay 元件根據業務需要,可以自己定製。
重用程式碼
這就是我們基於Composition API 寫的表單的基本功能。本教程的目標是建立清晰且可擴充套件的表單程式碼,通過定義 InputEmail 元件,來證明我們已經做到了這一點。
src/components/InputEmail
<template> <div> <label> Email <input type="email" v-model="input" name="email" /> </label> <ErrorDisplay v-if="input" :errors="errors" /> </div> </template> <script> import useInputValidator from "@/features/useInputValidator"; import { isEmail } from "@/validators"; import ErrorDisplay from "./ErrorDisplay"; export default { name: "InputEmail",[ isEmail() ],errors } },components: { ErrorDisplay } } </script>
原文:https://vuejsdevelopers.com/2020/03/31/vue-js-form-composition-api/
參考:https://css-tricks.com/how-the-vue-composition-api-replaces-vue-mixins/
到此這篇關於使用Vue Composition API寫出清晰、可擴充套件的表單實現的文章就介紹到這了,更多相關Vue Composition API清晰、可擴充套件的表單內容請搜尋我們以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援我們!