讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

Next.js 13 中父子客户端组件间状态通信的正确实践

雨墨吖_2528

雨墨吖_2528

发布时间:2026-02-18 14:12:10

|

992人浏览过

|

来源于php中文网

原创

Next.js 13 中父子客户端组件间状态通信的正确实践

在 Next.js 13 的 App Router 中,服务端组件向客户端组件传递 props 时需满足可序列化要求(如不能传函数),但两个客户端组件之间通信不受此限制,可直接通过 props 传递 setState 等函数实现状态同步。

在 next.js 13 的 app router 中,服务端组件向客户端组件传递 props 时需满足可序列化要求(如不能传函数),但**两个客户端组件之间通信不受此限制**,可直接通过 props 传递 `setstate` 等函数实现状态同步。

在 Next.js 13 的混合渲染模型中,一个常见误区是认为“所有客户端组件的 props 都必须可序列化”。实际上,Next.js 的官方约束仅适用于服务端组件 → 客户端组件的 props 传递:函数、Date、RegExp、Promise 等非可序列化值禁止从 Server Component 传入 Client Component;但Client Component 之间通信完全遵循标准 React 规则——即可以自由传递函数、对象、上下文、Ref 等任意 JavaScript 值。

因此,当父组件和子组件均为客户端组件(均含 'use client' 指令)时,你完全可以将 useState 返回的 setState 函数作为 prop 传递给子组件,并在子组件内安全调用:

// ChildComponent.tsx
'use client';

interface ChildProps {
  onChange: (e: React.ChangeEvent<HTMLSelectElement>) => void;
}

export default function ChildComponent({ onChange }: ChildProps) {
  return (
    <select onChange={onChange}>
      <option value="A">选项 A</option>
      <option value="B">选项 B</option>
      <option value="C">选项 C</option>
    </select>
  );
}
// ParentComponent.tsx
'use client';

import { useState } from 'react';
import ChildComponent from './ChildComponent';

export default function ParentComponent() {
  const [selectedValue, setSelectedValue] = useState<string | null>(null);

  const handleSelectChange = (e: React.ChangeEvent<HTMLSelectElement>) => {
    setSelectedValue(e.target.value);
    console.log('当前选中:', e.target.value);
  };

  return (
    <div>
      <h3>当前状态: {selectedValue ?? '未选择'}</h3>
      <ChildComponent onChange={handleSelectChange} />
    </div>
  );
}

✅ 关键前提:确保父子组件都明确声明 'use client' —— 若父组件是服务端组件(无 'use client'),则无法直接向子客户端组件传入 setSelectedValue,此时会触发 Error: Props must be serializable。若遇到该错误,请检查组件顶部是否遗漏了客户端指令。

jm-jsjkxyjs02-zlm-405
jm-jsjkxyjs02-zlm-405

使用约定式提交(Conventional Commits)生成标准化的 Git 提交信息。适用于以下场景: (1) 暂存更改时需要提交信息; (2) 审查 diff 时希望获得结构化摘要; (3) 编写 PR 描述或变更日志(changelog)条目; (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff,并生成按类型(type)划分范围的提交信息。

下载

⚠️ 注意事项:

  • 不要尝试在 Server Component 中定义 useState 或调用 setState —— 这会导致运行时错误;
  • 若需跨多个层级或复杂场景共享状态,再考虑 Context API 或 Zustand 等状态库;简单父子通信无需升级架构;
  • 使用 TypeScript 为 onChange 添加精确类型(如示例中的 React.ChangeEvent),可避免类型不匹配导致的隐式错误。

总结:Next.js 13 并未改变 React 的核心数据流原则。只要通信双方都是客户端组件,你就拥有完整的 React 能力 —— 包括函数传递、事件回调、状态提升等。回归基础、善用 'use client' 标识,即可优雅解决绝大多数状态联动问题。

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
TypeScript工程化开发与Vite构建优化实践
TypeScript工程化开发与Vite构建优化实践

本专题面向前端开发者,深入讲解 TypeScript 类型系统与大型项目结构设计方法,并结合 Vite 构建工具优化前端工程化流程。内容包括模块化设计、类型声明管理、代码分割、热更新原理以及构建性能调优。通过完整项目示例,帮助开发者提升代码可维护性与开发效率。

332

2026.02.13

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

540

2026.02.25

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

411

2026.03.13

TypeScript 全栈开发进阶指南
TypeScript 全栈开发进阶指南

面向有 JavaScript 基础的开发者,深入讲解 TypeScript 的类型系统与全栈开发实践。

326

2026.06.03

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

738

2026.06.16

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1049

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3400

2023.10.25

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

4876

2023.06.20

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.3万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn