React / 系统课时

创建基础表单

创建基础表单

本课用一个联系人表单说明如何选择语义化控件、绑定标签并组织字段。完成后,你将得到一个可在 Next.js App Router 页面中直接渲染的基础表单,并理解哪些属性会参与后续提交。

学习目标

  • 使用 form、label、input、textarea 和 button 组织表单
  • 理解 name、type、htmlFor 等关键属性的作用
  • 根据输入内容选择合适的原生表单控件

表单字段如何组织

表单不是若干输入框的简单堆叠。每个字段通常由标签、控件和必要的说明文本组成,相关元素应放在同一个逻辑区域内。label 的 htmlFor 要与控件的 id 一致,这样点击标签也能聚焦输入框,辅助技术也能识别字段名称。

name 决定字段提交时使用的键。后续服务端通过 formData.get('email') 读取值时,查找的就是控件的 name,而不是 id。id 主要负责页面内关联,二者职责不同。

主示例:联系人表单

将下面文件保存为 app/contacts/page.tsx。这是一个完整页面组件,不依赖客户端状态即可渲染。

tsx
export default function ContactPage() {
  return (
    <main>
      <h1>创建联系人</h1>

      <form>
        <div>
          <label htmlFor="name">姓名</label>
          <input
            id="name"
            name="name"
            type="text"
            autoComplete="name"
            required
          />
        </div>

        <div>
          <label htmlFor="email">邮箱</label>
          <input
            id="email"
            name="email"
            type="email"
            autoComplete="email"
            required
          />
        </div>

        <div>
          <label htmlFor="note">备注</label>
          <textarea id="note" name="note" rows={4} />
        </div>

        <button type="submit">保存联系人</button>
      </form>
    </main>
  )
}

预期结果

text
访问 /contacts 后,页面显示姓名、邮箱、备注三个字段和“保存联系人”按钮。
姓名与邮箱为空时,浏览器会阻止直接提交;邮箱字段会使用邮箱格式提示。

本课只负责建立表单结构,还没有绑定服务端处理函数。点击提交时,浏览器会采用原生表单行为;下一课会把 action 连接到服务端操作。

控件选择原则

单行普通文本使用 type="text",邮箱、网址、数字等数据优先使用对应的原生类型,以便浏览器提供键盘、自动填充和基础格式能力。多行内容使用 textarea,固定选项使用 select 或单选按钮,互不排斥的多项选择使用复选框。

不要仅用占位文本代替标签。占位文本会在输入后消失,也不能稳定承担字段名称。按钮应显式设置 type="submit",避免在复杂表单中因默认行为不清晰而产生误操作。

关键边界

HTML 的 required 和 type="email" 能改善交互,但不能代替服务端校验。用户可以绕过浏览器约束直接构造请求,因此服务端仍需重新检查必填项、格式和业务规则。

表单字段较多时,可以按业务含义使用 fieldset 与 legend 分组,但不要为了排版滥用。样式应通过 CSS 控制,字段语义仍由原生元素和属性表达。

官方表单指南可参考 Next.js Forms。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建基础表单

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

登录哪都通