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、原生属性是否透传,以及父组件能否正常接收变化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

封装可复用表单控件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通