React 使用Hooks簡化受控組件的狀態(tài)綁定
開始之前
閱讀本文需要對以下幾項有一定了解
ECMAScript 6
文章中大量用到了 ES6 語法,比如解構(gòu)賦值和函數(shù)參數(shù)默認值、剩余參數(shù)、展開語法、箭頭函數(shù)等。
React 在 16.8 版本中推出了 Hooks,它允許你在“函數(shù)組件”中使用“類組件”的一些特性。
React 本身提供了一些 Hooks,比如 useState、useReducer 等。通過在一個以“use”作為命名起始的函數(shù)中調(diào)用這些 Hooks,就得到了一個 custom Hook(自定義 Hook)。
Custom Hooks 允許我們把任何邏輯封裝到其中,以便于復(fù)用足夠小的組件邏輯。
當我們把像 <input> <textarea> 和 <select> 這樣的 HTML 元素本身的狀態(tài)交給 React state 去管理,我們就得到了一個“受控組件”。
styled-components
一個與 React 契合良好的 CSS in JS 庫。它允許你使用 JS 編寫樣式,并編譯成純 CSS 文件。
下面代碼中所有的樣式都是使用它編寫的。如果對代碼中樣式的實現(xiàn)不是很感興趣的話, 這個可以跳過。
代碼實現(xiàn)
Input 組件
首先我們需要實現(xiàn)一個 Input 組件,我們將在該組件的基礎(chǔ)上進行輸入、校驗并提示。
Input.js
import React from 'react';
import PropTypes from 'prop-types';
import styled from 'styled-components';
const Wrap = styled.div({
display: 'flex',
flexDirection: 'column',
label: { display: 'flex', alignItems: 'center' },
input: {
marginLeft: 8,
},
p: {
color: 'red',
},
});
function Input({ label, type, helperText, error, ...otherProps }) {
return (
<Wrap>
<label>
{label}:
<input {...otherProps} type={type} />
</label>
{error && <p>{helperText}</p>}
</Wrap>
);
}
Input.propTypes = {
label: PropTypes.string,
type: PropTypes.string,
helperText: PropTypes.string,
error: PropTypes.bool,
};
export default Input;
該組件主要接收以下幾個 props:
- label label 標簽的文本
- type 賦值給原生 input 標簽的 type 屬性
- error 數(shù)據(jù)類型為 Boolean,如果為 true 則表示當前表單域有錯誤,即驗證不通過
- helperText 當前表單域驗證不通過時,顯示在表單域下方的提示文字
- otherProps props 中除了上述四個以外的其他屬性,全部賦值給原生 input 標簽
Custom Hook
有了 UI 組件之后,就可以開始實現(xiàn)我們的自定義 Hook 了。
useInput.js
import { useState } from 'react';
export default function useInput({
initValue = '',
helperText = '',
validator = () => true,
validateTriggers = ['onChange'],
} = {}) {
// 保存用戶輸入的值,使用 initValue 作為初始值
const [value, setValue] = useState(initValue);
// Boolean 類型,表示當前表單項的驗證狀態(tài)
const [error, setError] = useState(false);
function onChange(e) {
const { value } = e.target;
setValue(value);
// 根據(jù) validateTriggers 的選項,決定是否要在 onChange 里進行校驗
if (validateTriggers.includes('onChange')) {
setError(!validator(value));
}
}
/**
* 根據(jù) validateTriggers 生成相應(yīng)的事件處理器
*/
function createEventHandlers() {
const eventHandlers = {};
validateTriggers.forEach(item => {
// 生成相應(yīng)的事件處理器,并在其中做輸入校驗。
eventHandlers[item] = e => {
const { value } = e.target;
setError(!validator(value));
};
});
return eventHandlers;
}
const eventHandlers = createEventHandlers();
return {
value,
helperText,
error,
...eventHandlers,
onChange,
};
}
useInput 接收一個 options 對象作為參數(shù),考慮到擴展性,使用一個配置對象作為參數(shù)比較好。
options 對象擁有以下幾個屬性:
- initValue 輸入框的初始值
- helperText 當表單驗證不通過時顯示的字符串
- validator 用于進行表單驗證的函數(shù),接收 value 作為參數(shù),并返回一個 Boolean 值,表示表單驗證是否通過
- validateTriggers 字符串數(shù)組,表明在哪個或哪幾個事件中調(diào)用 validator 進行輸入校驗。
在函數(shù)體中,我們調(diào)用兩次 useState 來初始化 value 和 error 的值,分別保存用戶輸入的值和當前表單域的校驗結(jié)果。
然后,聲明一個 onChange 方法用來綁定 input 元素的 change 事件,在該方法中,我們把用戶輸入的值賦值給 value,同時根據(jù) validateTriggers 的值,決定是否要在該方法中進行輸入校驗。該方法隨后會被返回出去,再作為 props 傳遞給相應(yīng)的組件,完成受控組件的狀態(tài)綁定。
我們還需要聲明一個 createEventHandlers 方法,該方法通過遍歷 validateTriggers,生成相應(yīng)的事件處理器,并在這些事件處理器中進行輸入校驗。
最后我們調(diào)用 createEventHandlers 方法,并把生成的 eventHandlers(事件處理器) 通過擴展運算符,插入到最終返回的對象中。
注意:這里我們需要把 onChange 放在最后,以免帶有狀態(tài)綁定的 onChange 方法被 eventHandlers 中的 onChange 覆蓋掉。
具體使用
現(xiàn)在讓我們來看看實際該如何使用:
import React from 'react';
import Input from './Input';
import useInput from './useInput';
// 用于驗證郵箱的正則表達式
const EMAIL_REG = /\S+@\S+\.\S+/;
export default function Form() {
const email = useInput({
initValue: '',
helperText: '請輸入有效的郵箱!',
validator: value => EMAIL_REG.test(value),
validateTriggers: ['onBlur'],
});
const password = useInput({
initValue: '',
helperText: '密碼長度需要在 6-20 之間!',
validator: value => value.length >= 6 && value.length <= 20,
validateTriggers: ['onChange', 'onBlur'],
});
/**
* 判斷是否禁用按鈕
*/
function isButtonDisabled() {
// 當郵箱或密碼未填寫時,或者郵箱或密碼輸入校驗未通過時,禁用按鈕
return !email.value || !password.value || email.error || password.error;
}
/**
* 處理表單提交
*/
function handleButtonClick() {
console.log('郵箱:', email.value);
console.log('密碼:', password.value);
}
return (
<div>
<Input {...email} label="郵箱" type="email" />
<Input {...password} label="密碼" type="password" />
<button disabled={isButtonDisabled()} onClick={handleButtonClick}>
登錄
</button>
</div>
);
}
這里調(diào)用了兩次 useInput,初始化 email 和 password 表單域數(shù)據(jù)。
然后使用擴展運算符,把值全部賦給 Input 組件。只用了幾行代碼就完成了定義初始值和受控組件的綁定,是不是很方便?
當我們輸入郵箱的時候,并不會出現(xiàn)校驗提示,但是一旦從郵箱輸入框失去焦點以后,輸入的值就會被校驗,并根據(jù)校驗結(jié)果顯示相應(yīng)的提示。而密碼輸入框,則會在輸入的過程中和失焦后都進行校驗。
總結(jié)
上面這個例子已經(jīng)可以處理基本的表單驗證,至于格式化用戶輸入的數(shù)據(jù)以及自定義收集表單域的值的時機等其他需求,我就不再演示了,大家可以自行設(shè)計。這也是 Hooks 的特殊之處,它讓我們可以更容易的復(fù)用邏輯代碼,可以根據(jù)需要自行編寫 custom Hooks。
文章中關(guān)于 useInput 的 API 設(shè)計只是眾多方案中的一種,只是為大家提供一些參考。你也可以把整個表單的狀態(tài)封裝到一個 useForm 方法中,統(tǒng)一管理所有表單域的狀態(tài)。
希望本文能為大家?guī)硪恍╆P(guān)于如何使用 Hooks 的靈感,即使從來沒有使用過 Hooks,也強烈建議大家嘗試一下。我已經(jīng)在項目中大量使用 Hooks 了,并且它也為我?guī)砹撕芎玫男Ч?/p>
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
React之如何在Suspense中優(yōu)雅地請求數(shù)據(jù)
Suspense 是 React 中的一個組件,直譯過來有懸掛的意思,能夠?qū)⑵浒漠惒浇M件掛起,直到組件加載完成后再渲染,本文詳細介紹了如何在Suspense中請求數(shù)據(jù),感興趣的小伙伴可以參考閱讀本文2023-04-04
React + webpack 環(huán)境配置的方法步驟
本篇文章主要介紹了React + webpack 環(huán)境配置的方法步驟,詳解的介紹了開發(fā)環(huán)境的配置搭建,有興趣的可以了解一下2017-09-09
詳解react內(nèi)聯(lián)樣式使用webpack將px轉(zhuǎn)rem
這篇文章主要介紹了詳解react內(nèi)聯(lián)樣式使用webpack將px轉(zhuǎn)rem,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2018-09-09
React?Native?中限制導(dǎo)入某些組件和模塊的方法
這篇文章主要介紹了React?Native?中限制導(dǎo)入某些組件和模塊的方法,本文通過實例代碼給大家介紹的非常詳細,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2022-08-08
如何解決React官方腳手架不支持Less的問題(小結(jié))
這篇文章主要介紹了如何解決React官方腳手架不支持Less的問題(小結(jié)),小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2018-09-09

