HTML / CSS / 系统课时

设计表单组件

设计表单组件

本课把标签、输入框、提示文字、错误信息和禁用状态整理为一套稳定的字段结构。完成后,你可以用统一的间距、颜色和可访问属性快速组合表单,而不是为每个页面重复拼接样式。

学习目标

  • 设计可复用的字段结构,明确标签、控件和反馈信息的职责。
  • 统一默认、聚焦、错误、只读和禁用状态的视觉规则。
  • 使用语义属性连接输入框与提示信息,提升键盘和读屏体验。

从字段结构开始

一个字段不只是输入框,而是由标签、控件和反馈区组成的完整单元。标签负责说明输入目的,控件负责接收数据,反馈区只显示提示或错误中的一种。先固定这三个区域,才能在不同表单中保持对齐、间距和状态行为一致。

表单字段结构与状态关系

建立统一的状态规则

默认状态应保持中性边框;键盘聚焦时使用清晰的 focus-visible:ring;错误状态同时改变边框、焦点环和反馈文字;只读状态允许复制但不允许修改;禁用状态降低对比度,并通过 disabled:cursor-not-allowed 明确不可操作。

状态样式不能只依赖颜色。错误字段应设置 aria-invalid="true",并通过 aria-describedby 关联错误信息;禁用控件使用原生 disabled;只读内容使用 readonly。这样视觉状态与真实交互状态才不会分离。

主示例:统一邮箱字段

下面是片段示例,需放入已经启用 Tailwind CSS 的页面中。示例同时包含错误字段和禁用字段,重点观察相同结构如何承载不同状态。

html
<form class="mx-auto max-w-md space-y-6 rounded-xl border border-slate-200 bg-white p-6 shadow-sm">
  <!-- 错误字段:输入框与错误文本通过 aria-describedby 关联 -->
  <div class="space-y-2">
    <label for="email" class="block text-sm font-medium text-slate-900">
      邮箱地址
    </label>
    <input
      id="email"
      name="email"
      type="email"
      value="demo@"
      aria-invalid="true"
      aria-describedby="email-error"
      class="block w-full rounded-lg border border-red-500 bg-white px-3 py-2 text-slate-900 outline-none transition placeholder:text-slate-400 focus-visible:border-red-500 focus-visible:ring-2 focus-visible:ring-red-200"
    >
    <p id="email-error" class="text-sm text-red-600">
      请输入有效的邮箱地址。
    </p>
  </div>

  <!-- 禁用字段仍保留标签,避免用户失去上下文 -->
  <div class="space-y-2">
    <label for="role" class="block text-sm font-medium text-slate-900">
      当前角色
    </label>
    <input
      id="role"
      name="role"
      type="text"
      value="课程学员"
      disabled
      class="block w-full rounded-lg border border-slate-200 bg-slate-100 px-3 py-2 text-slate-500 disabled:cursor-not-allowed disabled:opacity-75"
    >
    <p class="text-sm text-slate-500">
      角色由管理员分配,当前不可修改。
    </p>
  </div>
</form>

预期结果

text
页面显示一张两字段表单卡片。邮箱字段使用红色边框和错误提示,获得键盘焦点时出现红色焦点环;角色字段呈灰色禁用状态,无法输入,并显示原因说明。

组件化时保留稳定接口

封装到 Vue、React 或模板组件时,优先暴露 label、id、hint、error、disabled 和 readonly 等语义参数,不要让调用方直接传入一长串状态类。组件内部根据参数选择反馈文本和样式,调用方只描述字段当前是什么状态。

提示文字与错误信息应共用同一个反馈位置。存在错误时隐藏普通提示,并让 aria-describedby 指向当前实际显示的元素。否则页面会同时出现两条说明,读屏软件也可能朗读过期信息。

验收与常见错误

  • 使用 Tab 键进入字段时,焦点环清晰可见,且不会被 outline-none 单独移除。
  • 错误状态同时具备文字说明和语义属性,不只把边框变红。
  • 禁用字段不能提交或编辑;只读字段可以聚焦和复制,两者不要混用。
  • 标签的 for 必须与输入框 id 一致,页面中每个 id 保持唯一。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计表单组件

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

登录哪都通