当前位置：首页 > news >正文

在 Next.js 应用中创建ContactForm表单提交

news 2026/2/9 10:49:39

在 Next.js 应用中创建表单提交涉及几个关键步骤，包括设置表单、处理表单提交以及管理服务器端或 API 逻辑。以下是使用 Next.js 开发一个简单表单提交的步骤。

1. 设置表单组件

首先，创建一个表单组件。在这个例子中，我们将创建一个 ContactForm 组件。

// components/ContactForm.js
import { useState } from 'react';const ContactForm = () => {const [formData, setFormData] = useState({name: '',email: '',message: '',});const handleChange = (e) => {const { name, value } = e.target;setFormData({ ...formData, [name]: value });};const handleSubmit = async (e) => {e.preventDefault();try {const response = await fetch('/api/contact', {method: 'POST',headers: {'Content-Type': 'application/json',},body: JSON.stringify(formData),});if (!response.ok) {throw new Error('Network response was not ok');}const result = await response.json();alert('消息发送成功！');} catch (error) {console.error('Fetch 操作出错:', error);}};return (<form onSubmit={handleSubmit}><div><label htmlFor="name">姓名</label><input type="text" id="name" name="name" value={formData.name} onChange={handleChange} required /></div><div><label htmlFor="email">邮箱</label><input type="email" id="email" name="email" value={formData.email} onChange={handleChange} required /></div><div><label htmlFor="message">消息</label><textarea id="message" name="message" value={formData.message} onChange={handleChange} required /></div><button type="submit">提交</button></form>);
};export default ContactForm;

2. 创建 API 路由

Next.js 使创建 API 路由变得很容易。在 pages/api 目录下创建一个名为 contact.js 的文件来处理表单提交。

// pages/api/contact.js
export default function handler(req, res) {if (req.method === 'POST') {const { name, email, message } = req.body;// 在这里执行任何服务器端验证或处理console.log('收到的联系表单数据:', { name, email, message });// 发送响应回客户端res.status(200).json({ message: '表单提交成功！' });} else {// 处理任何其他 HTTP 方法res.setHeader('Allow', ['POST']);res.status(405).end(`Method ${req.method} Not Allowed`);}
}

3. 在页面中集成表单组件

在你的页面之一中使用 ContactForm 组件，例如，在 index.js 页面中。

// pages/index.js
import Head from 'next/head';
import ContactForm from '../components/ContactForm';export default function Home() {return (<div><Head><title>联系我们</title></Head><main><h1>联系我们</h1><ContactForm /></main></div>);
}

4. 运行你的应用

使用以下命令运行你的 Next.js 应用：

npm run dev

你的表单应该在主页上可用，当你提交表单时，它会发送一个 POST 请求到 /api/contact，由你创建的 API 路由来处理。

额外提示

验证: 你可能需要在客户端（使用像 formik 或 react-hook-form 这样的库）和服务器端添加验证。
错误处理: 改进错误处理，为用户提供更好的反馈。
样式: 使用 CSS 或 styled-components 这样的 CSS-in-JS 解决方案来美化你的表单。

这是一个基本的例子，但它为在 Next.js 中构建更复杂的表单提交提供了一个坚实的基础。

标题英语翻译

Creating a form submission in a Next.js application involves a few key steps, including setting up the form, handling the form submission, and managing the server-side or API logic if needed. Below are the steps to develop a simple form submission using Next.js.

1. Set Up the Form Component

First, create a form component. In this example, we’ll create a ContactForm component.

// components/ContactForm.js
import { useState } from 'react';const ContactForm = () => {const [formData, setFormData] = useState({name: '',email: '',message: '',});const handleChange = (e) => {const { name, value } = e.target;setFormData({ ...formData, [name]: value });};const handleSubmit = async (e) => {e.preventDefault();try {const response = await fetch('/api/contact', {method: 'POST',headers: {'Content-Type': 'application/json',},body: JSON.stringify(formData),});if (!response.ok) {throw new Error('Network response was not ok');}const result = await response.json();alert('Message sent successfully!');} catch (error) {console.error('There was a problem with the fetch operation:', error);}};return (<form onSubmit={handleSubmit}><div><label htmlFor="name">Name</label><input type="text" id="name" name="name" value={formData.name} onChange={handleChange} required /></div><div><label htmlFor="email">Email</label><input type="email" id="email" name="email" value={formData.email} onChange={handleChange} required /></div><div><label htmlFor="message">Message</label><textarea id="message" name="message" value={formData.message} onChange={handleChange} required /></div><button type="submit">Submit</button></form>);
};export default ContactForm;

2. Create an API Route

Next.js makes it easy to create API routes. Create a file named contact.js in the pages/api directory to handle the form submission.

// pages/api/contact.js
export default function handler(req, res) {if (req.method === 'POST') {const { name, email, message } = req.body;// Perform any server-side validation or processing hereconsole.log('Received contact form data:', { name, email, message });// Send a response back to the clientres.status(200).json({ message: 'Form submitted successfully!' });} else {// Handle any other HTTP methodres.setHeader('Allow', ['POST']);res.status(405).end(`Method ${req.method} Not Allowed`);}
}

3. Integrate the Form Component in a Page

Use the ContactForm component in one of your pages, for example, the index.js page.

// pages/index.js
import Head from 'next/head';
import ContactForm from '../components/ContactForm';export default function Home() {return (<div><Head><title>Contact Us</title></Head><main><h1>Contact Us</h1><ContactForm /></main></div>);
}

4. Run Your Application

Run your Next.js application with the following command:

npm run dev

Your form should be available on the homepage, and when you submit the form, it will send a POST request to /api/contact, which will be handled by the API route you created.

Additional Tips

Validation: You might want to add validation both on the client side (using libraries like formik or react-hook-form) and the server side.
Error Handling: Improve error handling to provide better feedback to users.
Styling: Style your form using CSS or a CSS-in-JS solution like styled-components.

This is a basic example, but it provides a solid foundation for building more complex form submissions in Next.js.