====== 什么是组件 ====== **组件**是界面上「独立、可复用的一块 UI 及其行为的封装」。从形态上看它就是一个函数: props ──▶ [ 组件 ] ──▶ UI(React 元素 / 一段描述) 输入是 **props**(外部传进来的数据与回调),输出是**描述界面该长什么样**的 React 元素。组件本身不直接操作真实 DOM,它只负责「根据当前输入算出 UI」,剩下的交给框架。 // 最小可用组件:不接收任何输入 function Badge() { return 新; } // 接收输入的组件 type AvatarProps = { src: string; alt: string; size?: number; // 可选 }; function Avatar({ src, alt, size = 40 }: AvatarProps) { return {alt}; } 使用组件和写 HTML 标签很像,但属性名是 JS 的 camelCase,值用 `{}` 传表达式: // 字符串可以省略引号写法,其它类型必须用 {} 三条最基本的原则: * 组件名**首字母必须大写**,否则会被当成原生 HTML 标签; * 一个组件只负责**一块** UI 及其交互,职责单一才谈得上复用; * 组件返回的是**描述**(React 元素),不是已经创建好的 DOM 节点。 ===== 一、props:组件的输入契约 ===== props 是组件对外暴露的「接口」。它在组件的整个生命周期里**只读**,组件不能自己修改。 ^ 形态 ^ 写法示例 ^ 说明 ^ | 必填 | ''name: string'' | 调用方少传就报错 | | 可选 | ''size?: number'' | 可以省略,读出来可能是 undefined | | 默认值 | ''size = 40'' | 解构参数时给默认值,只对 undefined 生效 | | 回调 | ''onClick?: () => void'' | 把「发生了什么」告诉父组件 | | 内容插槽 | ''children: React.ReactNode'' | 标签之间的内容 | | 原生属性透传 | ''React.ComponentProps<"button">'' | 一次性拿到某个原生标签的全部属性 | | 其余属性 | ''...rest'' | 收集未显式声明的属性,再原样透传 | type ButtonProps = { label: string; variant?: "primary" | "ghost"; // 联合类型:只允许这几个取值 disabled?: boolean; onClick?: () => void; }; function Button({ label, variant = "primary", disabled, onClick }: ButtonProps) { return ( ); } // 使用 ); } * state 是**组件私有**的,外部无法直接读取或修改; * 外部需要感知变化时,要么走**回调**,要么把 state **提升**出去改成受控组件; * 副作用(请求、订阅、定时器)用 ''useEffect'' 管理,并且要写清理逻辑。 更完整的用法见 [[react:组件基础]]。 ===== 六、常见坑 ===== * **组件名小写**:%% )} ); } ''editing'' 变成 true 时 ''ReplyBox'' 才被创建(挂载),变回 false 时它被销毁(卸载)。带来三个直接结果: * 组件内部的状态**每次从头开始**:上次没提交的草稿、校验错误、展开过的下拉,全部清零; * 组件里的 ''useEffect'' 每次打开都会重新执行,卸载时自动跑清理函数(订阅、定时器、事件监听随之解除); * 没被打开时几乎不产生任何开销。 代价是:状态留不住;带退场动画的组件,可能在动画播完之前就被卸载掉了。 **写法二:常驻渲染——一直挂载,只切换显示** function Post({ content }: { content: string }) { const [visible, setVisible] = useState(false); return (

{content}

{ submit(text); setVisible(false); }} />
); }
这里有两个值得记住的套路: * ''onVisibleChange={setVisible}'':子组件调用 ''onVisibleChange(false)'',效果就等于父组件执行 ''setVisible(false)'',不必再包一层 ''(v) => setVisible(v)''; * 组件自己负责「不可见时少做事」,例如根据 ''visible'' 决定要不要请求数据、要不要渲染内容。 好处是内部状态和动画都保得住;代价是它一直留在组件树里,即使从未被打开过。 **怎么选** ^ 关注点 ^ 条件渲染(挂载 / 卸载) ^ 常驻渲染(切换 visible) ^ | 内部 state | 每次重新开始 | 保留 | | 副作用 / 请求 | 每次打开重新执行 | 只在首次执行,需自己按 visible 变化触发 | | 卸载清理 | 框架自动完成 | 需自己判断处理 | | 退场动画 | 容易被打断 | 好实现 | | 内存与开销 | 用时才付出 | 一直存在 | | 适合场景 | 较重、一次性、希望每次初始化 | 较轻、需要保留状态或有动画 | 判断方法很简单:**先问「我希望内部状态和副作用跟着开关重置,还是保留?」**,答案基本就决定了写法。 **用 ''&&'' 做条件渲染时的两个坑** * 左边必须是布尔值:''count && '' 在 ''count'' 为 0 时会把 0 渲染到页面上,应写成 ''count > 0 ? : null'',或先用布尔变量接住; * 需要「否则分支」就用三元表达式,不要并排写两个 ''&&'',否则顺序和漏渲染都很难排查。 还要分清一点:条件渲染控制的是**组件存不存在**,而不是「显示还是隐藏」。只想切换可见性时,交给组件自己的 ''visible'' 或 CSS 更合适。 ===== 八、小结 ===== * 组件 = 输入 props → 输出 UI 的可复用单元,名字首字母大写。 * props 是只读的输入契约;''children'' 是特殊 prop,用来接收标签之间的内容。 * 数据向下(props)、事件向上(回调),单向流动最好推理。 * 用 TypeScript 把契约写清楚:必填/可选/默认值/回调/children/原生属性透传/泛型组件。 * 倾向组合而非继承:拆小、拼装、复合组件、受控与非受控各取所需,共享数据就提升状态。 * 组件「什么时候存在」也是一种设计:按需挂载还是常驻,取决于你希望内部状态与副作用是否重置。 相关:[[react:基础概念]]、[[react:组件基础]]、[[react:props-state]]、[[react:usestate]]、[[react:jsx]]、[[typescript:什么是接口]]、[[typescript:什么是函数]]