文章中大量用到了 ES6 语法,比如、、、等。
React 在 16.8 版本中推出了 Hooks,它允许你在“函数组件”中使用“类组件”的一些特性。
React 本身提供了一些 Hooks,比如 useState、useReducer 等。通过在一个以“use”作为命名起始的函数中调用这些 Hooks,就得到了一个 custom Hook(自定义 Hook)。
Custom Hooks 允许我们把任何逻辑封装到其中,以便于复用足够小的组件逻辑。
当我们把像 <input> <textarea> 和 <select> 这样的 HTML 元素本身的状态交给 React state 去管理,我们就得到了一个“受控组件”。
styled-components
一个与 React 契合良好的 CSS in JS 库。它允许你使用 JS 编写样式,并编译成纯 CSS 文件。
下面代码中所有的样式都是使用它编写的。如果对代码中样式的实现不是很感兴趣的话, 这个可以跳过。
代码实现
Input 组件
首先我们需要实现一个 Input 组件,我们将在该组件的基础上进行输入、校验并提示。
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 数据类型为 Boolean,如果为 true 则表示当前表单域有错误,即验证不通过
helperText 当前表单域验证不通过时,显示在表单域下方的提示文字
otherProps props 中除了上述四个以外的其他属性,全部赋值给原生 input 标签
Custom Hook
有了 UI 组件之后,就可以开始实现我们的自定义 Hook 了。
useInput.js
import { useState } from 'react'; export default function useInput({ initValue = '', helperText = '', validator = () => true, validateTriggers = ['onChange'], } = {}) { // 保存用户输入的值,使用 initValue 作为初始值 const [value, setValue] = useState(initValue); // Boolean 类型,表示当前表单项的验证状态 const [error, setError] = useState(false); function onChange(e) { const { value } = e.target; setValue(value); // 根据 validateTriggers 的选项,决定是否要在 onChange 里进行校验 if (validateTriggers.includes('onChange')) { setError(!validator(value)); } } /** * 根据 validateTriggers 生成相应的事件处理器 */ function createEventHandlers() { const eventHandlers = {}; validateTriggers.forEach(item => { // 生成相应的事件处理器,并在其中做输入校验。 eventHandlers[item] = e => { const { value } = e.target; setError(!validator(value)); }; }); return eventHandlers; } const eventHandlers = createEventHandlers(); return { value, helperText, error, ...eventHandlers, onChange, }; }
useInput 接收一个 options 对象作为参数,考虑到扩展性,使用一个配置对象作为参数比较好。
options 对象拥有以下几个属性:
initValue 输入框的初始值
helperText 当表单验证不通过时显示的字符串
validator 用于进行表单验证的函数,接收 value 作为参数,并返回一个 Boolean 值,表示表单验证是否通过
validateTriggers 字符串数组,表明在哪个或哪几个事件中调用 validator 进行输入校验。
在函数体中,我们调用两次 useState 来初始化 value 和 error 的值,分别保存用户输入的值和当前表单域的校验结果。
然后,声明一个 onChange 方法用来绑定 input 元素的 change 事件,在该方法中,我们把用户输入的值赋值给 value,同时根据 validateTriggers 的值,决定是否要在该方法中进行输入校验。该方法随后会被返回出去,再作为 props 传递给相应的组件,完成受控组件的状态绑定。
我们还需要声明一个 createEventHandlers 方法,该方法通过遍历 validateTriggers,生成相应的事件处理器,并在这些事件处理器中进行输入校验。
最后我们调用 createEventHandlers 方法,并把生成的 eventHandlers(事件处理器) 通过扩展运算符,插入到最终返回的对象中。
注意:这里我们需要把 onChange 放在最后,以免带有状态绑定的 onChange 方法被 eventHandlers 中的 onChange 覆盖掉。
具体使用
现在让我们来看看实际该如何使用: