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。这是一个完整页面组件,不依赖客户端状态即可渲染。
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>
)
}预期结果
访问 /contacts 后,页面显示姓名、邮箱、备注三个字段和“保存联系人”按钮。
姓名与邮箱为空时,浏览器会阻止直接提交;邮箱字段会使用邮箱格式提示。本课只负责建立表单结构,还没有绑定服务端处理函数。点击提交时,浏览器会采用原生表单行为;下一课会把 action 连接到服务端操作。
控件选择原则
单行普通文本使用 type="text",邮箱、网址、数字等数据优先使用对应的原生类型,以便浏览器提供键盘、自动填充和基础格式能力。多行内容使用 textarea,固定选项使用 select 或单选按钮,互不排斥的多项选择使用复选框。
不要仅用占位文本代替标签。占位文本会在输入后消失,也不能稳定承担字段名称。按钮应显式设置 type="submit",避免在复杂表单中因默认行为不清晰而产生误操作。
关键边界
HTML 的 required 和 type="email" 能改善交互,但不能代替服务端校验。用户可以绕过浏览器约束直接构造请求,因此服务端仍需重新检查必填项、格式和业务规则。
表单字段较多时,可以按业务含义使用 fieldset 与 legend 分组,但不要为了排版滥用。样式应通过 CSS 控制,字段语义仍由原生元素和属性表达。
官方表单指南可参考 Next.js Forms。