React / 系统课时
封装可复用表单控件
封装可复用表单控件
重复编写标签、输入框、错误文本和可访问性属性容易产生不一致。本课封装一个 TextField,让父组件继续掌握表单状态,同时由控件统一负责结构、标识和错误展示。
学习目标
- 设计受控表单控件的 props
- 统一标签、错误和可访问性属性
- 保留原生输入属性的扩展能力
组件只封装稳定规则
可复用控件应负责各页面都相同的结构,不应暗中保存业务值。父组件仍传入 value 和 onChange,因此数据流清楚,校验和提交逻辑也能留在表单层。
使用 useId 可生成适合关联标签和错误文本的标识。其作用是建立可访问性关系,不应拿来生成列表的 key。
完整组件示例
jsx
import { useId, useState } from 'react';
function TextField({
label,
error = '',
id: providedId,
...inputProps
}) {
const generatedId = useId();
const inputId = providedId ?? generatedId;
const errorId = `${inputId}-error`;
return (
<div>
<label htmlFor={inputId}>{label}</label>
<input
{...inputProps}
id={inputId}
aria-invalid={Boolean(error)}
aria-describedby={error ? errorId : undefined}
/>
{error && <p id={errorId}>{error}</p>}
</div>
);
}
export default function App() {
const [email, setEmail] = useState('');
const error =
email && !email.includes('@') ? '邮箱必须包含 @' : '';
return (
<main>
<TextField
label="联系邮箱"
type="email"
value={email}
onChange={(event) => setEmail(event.target.value)}
error={error}
placeholder="name@example.com"
autoComplete="email"
/>
<p>当前值:{email || '未填写'}</p>
</main>
);
}预期结果:
text
页面显示带标签的邮箱输入框。
输入不包含 @ 的非空内容时,输入框下方显示错误。
placeholder、type 和 autoComplete 等原生属性会传递给 input。设计 props 的原则
label 和 error 是组件新增的语义属性,其余原生输入属性通过剩余参数透传。这样既保持统一结构,又不必为 disabled、required、maxLength 等属性逐个声明转发。
展开顺序很重要。示例先展开 inputProps,再写 id 和无障碍属性,确保组件维护的关键关系不会被调用者意外覆盖。对于是否允许覆盖,应在团队组件规范中明确。
不要在通用控件里硬编码“邮箱格式”“用户名必填”等业务规则。控件负责展示错误,表单负责产生错误;同一个控件才能用于不同业务。
扩展到组件库
后续可以增加帮助文本、前后缀、尺寸和状态样式,但每个新增 prop 都应解决稳定需求。若文本框、选择框和文本域结构差异较大,分别封装通常比一个包含大量条件分支的万能组件更易维护。
测试应覆盖标签能否关联输入、错误出现时是否设置 aria-invalid、原生属性是否透传,以及父组件能否正常接收变化。
按自己的节奏,确认真正理解。