剪藏
Rethinking your position
Learn how to learn
3R编码 | nestjs最佳实践 - 课程概览
3R编码 | Node.js开发环境搭建
3R编码 | Nestjs+Eslint+SWC应用初始化及断点调试
3R编码 | 装饰器与反射
3R编码 | Nestjs核心概念
3R编码 | 无懈可击的Linux服务器构建
3R编码 | 使用Turborepo+pnpm workspaces构建monorepo应用
3R编码 | 使用Gitea+Drone自建CICD平台
3R编码 | 整合Typeorm实现CRUD
3R编码 | 请求数据的验证和响应数据的序列化
3R编码 | 数据关联与树形嵌套结构的分类和评论的实现
3R编码 | 自定义全局的验证管道,拦截器和过滤器
3R编码 | 自定义数据验证约束及约束中的依赖注入
3R编码 | 批量操作及软删除(回收站)功能使用
3R编码 | 数据库与MeiliSearch的全文搜索
3R编码 | 数据操作代码的抽象化
3R编码 | 整合bun与pm2实现开发环境与生产环境免编译和自启
3R编码 | 自建配置系统实现
3R编码 | 嵌套路由与Swagger文档实现
3R编码 | 使用Yargs构建命令行工具
3R编码 | 生产环境下静默启动以及PM2 API的使用
3R编码 | 数据迁移功能的实现
3R编码 | 数据填充命令实现
3R编码 | 用户模块开发以及使用Passport实现JWT认证和无痛刷新
3R编码 | 基于CASL的RBAC动态角色及权限系统实现
3R编码 | 模型动态关联与基于CASL的动态权限的实现
3R编码 | 使用BullMQ实现异步验证短信与邮件发送
3R编码 | WebSocket实现消息广播功能
3R编码 | chapter27
3R编码 | chapter28
3R编码 | TS全栈+AI开发实战 - 课程概览
3R编码 | Node.js环境搭建及应用初始化
3R编码 | Next.js应用初始化
3R编码 | React内置Hooks的使用与自定义详解
3R编码 | Next.js中使用Zustand进行状态管理详解
3R编码 | Next.js核心概念及应用构建
微电子学第1话 MOS Differential Pair (I)
微电子学第1话 MOS Differential Pair (I)
微电子学第3话 CMRR
微电子学第2话 MOS Differential Pair (II)
终于有人讲了,凭什么三极管能放大?
降低人类负担:类型系统即边界
固态变压器SST是什么
本站点使用 MrDoc 构建
-
+
3R编码 | React内置Hooks的使用与自定义详解
学习一些react自带的hooks以基本掌握react应用的简单开发。在这节课中,我们通过几个小案例(如黑暗主题切换,语言包选择等)详细深入地了解一下react编码的一个基本规则,为后面课程的前端部分的学习打下坚实的基础 ### 课程目标[](#课程目标 "课程目标的直接链接") 本节课的目标如下 - 掌握react基本使用和开发 - 掌握immer的概念和使用 - 掌握常用的React Hooks的使用方法 - 掌握自定义hooks的编写 ### 技术概念[](#技术概念 "技术概念的直接链接") 以下为本节课所涉及的技术概念 - [immer](https://immerjs.github.io/immer/zh-CN/):使用proxy实现了不可变数据类型 - [clsx](https://github.com/lukeed/clsx):一个用于动态合成react css类的工具 - [lodash](https://lodash.com/docs):包含了一大堆常用js函数的js工具库 ### 前置准备[](#前置准备 "前置准备的直接链接") 请在学习本课前务必预先阅读以下文档 - [react api参考](https://zh-hans.react.dev/reference/react)(仅供查询所用) - [immer.js官方文档](https://immerjs.github.io/immer/zh-CN/) - @ant-design/v5-patch-for-react-19用于解决antd和react19的兼容性问题,详情请查看[此文章](https://ant.design/docs/react/v5-for-19) 前期给tailwind加前缀只是用来演示这个配置,正式项目中站长不喜欢用。所以为了方便编写tailwind类,我们把前缀去除 先把tailwind本身和shadcn的配置去除`tw`前缀 ``` /* src/app/styles/tailwind.css */@layer theme, base, antd, components, utilities;@import 'tailwindcss';/* ... */// components.json{ // ... "tailwind": { "config": "", "css": "src/app/styles/index.css", "baseColor": "zinc", "cssVariables": true, "prefix": "" },} ``` 然后把所有css和tsx文件中的tailwind类的`tw:`前缀给去除掉 在开始编码之前先安装以下依赖 ``` pnpm add immer @ant-design/v5-patch-for-react-19 ``` 在`src/app/demo/layout.tsx`中导入`@ant-design/v5-patch-for-react-19` ``` // src/app/demo/layout.tsx// ...import '@ant-design/v5-patch-for-react-19'; ``` 添加一个`src/app/demo/_components`目录,在demo中添加一个`style.module.css`,用于设置本课程案例的css样式 ``` /* src/app/demo/_components/style.module.css */@reference "#tailwind.css";.container { @apply bg-neutral-100/40 shadow-black/20 backdrop-blur-sm shadow-md rounded-md p-5 m-5 min-w-[20rem];}html.dark { .container { @apply bg-neutral-800/40 shadow-slate-100/30; }} ``` ### useState[](#usestate "useState的直接链接") 注意 下面所有Demo的演示图中的样式等可能跟你运行时有些不一样(比如标题变粗变大等)。这是因为在制作课程时,还没有做tailwind与antd的样式冲突解决,所以不必担心这个问题。你运行时的界面才是正常现象! 此Hook用于改变组件内的状态 此钩子解构出两个值,并赋值到一个数组内 - 第一个元素代表该状态的值 - 第二个元素用于设置状态的值 编写如下示例 ``` // src/app/demo/_components/state.tsx'use client';// ...import $styles from './style.module.css';const StateDemo: FC = () => { const [count, setCount] = useState(1); const [isShow, toggleShow] = useState(true); return ( <div className={clsx($styles.container, 'w-[20rem]')}> <h2 className="text-center">useState Demo</h2> {isShow && <p className="text-center py-5">{count}</p>} <div className="flex justify-around"> <Button onClick={() => setCount(count + 1)} type="dashed"> 增加 </Button> <Button onClick={() => setCount(count - 1)} type="dashed"> 减少 </Button> <Button onClick={() => toggleShow(!isShow)} type="dashed"> {isShow ? '显示' : '隐藏'} </Button> </div> </div> );};export default StateDemo; ``` 然后在`src/app/demo/page.tsx`中引入 success 此处我们清空掉上一节tailwind课的代码,重置为react初始化这节课的`App.tsx`,然后引入`StateDemo`组件 ``` // src/app/demo/page.tsximport type { FC } from 'react';import StateDemo from './_components/state';const DemoPage: FC = () => ( <div className={$styles.demo}> <StateDemo /> </div>);export default DemoPage; ``` 查看一下效果  ### useEffect[](#useeffect "useEffect的直接链接") 在状态不同的生命周期执行副作用 语法为 ``` useEffect(() => { 当依赖项改变时的执行逻辑 () => { 在执行逻辑运行前执行的先行逻辑,用于清理等操作 }},[依赖项]) ``` #### 简单用法[](#简单用法 "简单用法的直接链接") **在没有设置"依赖项"时,任何状态的改变都会导致该`useEffect`执行逻辑的运行** 每次状态更新都会执行`useEffect`里面的函数 - 当点击**ghost按钮**时,由于`ghost`的状态变化了,所以会同时执行两个`useEffect` - 同样地,当**浏览器宽度发生变化**时,也会同时执行两个`useEffect` ``` // src/app/demo/_components/effect.tsx// ...import { Button } from 'antd';import { type FC, useEffect, useState } from 'react';import $styles from './style.module.css';const EffectDemo: FC = () => { const [ghost, setGhost] = useState<boolean>(false); const [width, setWidth] = useState(0); const toggleGhostBtn = () => setGhost(!ghost); const resizeHandle = () => setWidth(window.innerWidth); useEffect(() => { if (typeof window !== 'undefined') { setWidth(window.innerWidth); console.log('浏览器宽度改变'); window.addEventListener('resize', resizeHandle); } }); useEffect(() => { console.log('切换幽灵按钮'); }); return ( <div className={$styles.container}> <h2 className="text-center">useEffect Demo</h2> <p className="py-5 text-center">{ghost ? 'ghost' : '普通'}按钮</p> <div className="flex flex-col justify-center"> <Button type="primary" onClick={toggleGhostBtn} ghost={ghost}> 切换按钮样式 </Button> <p className="pt-5 text-center">宽度为: {width}</p> </div> </div> );};export default EffectDemo; ``` 然后把这个组件放到`App.tsx`里面 ``` // src/app/demo/page.tsx// ...const DemoPage: FC = () => ( <div className={$styles.demo}> <StateDemo /> <EffectDemo /> </div>); ``` 效果如下  #### 依赖更新[](#依赖更新 "依赖更新的直接链接") 通过`useEffect`的第二个参数,可以指定其依赖的变量 - 只有此变量的状态更改时才会执行副作用函数 - 如果第二个参数为空,则只在第一次渲染和重新渲染时触发 ``` // src/demo/effect.tsx// ...const EffectDemo: FC = () => { // ... useEffect(() => { console.log('浏览器宽度改变'); window.addEventListener('resize', resizeHandle); }, [width]); useEffect(() => { console.log('切换幽灵按钮'); }, [ghost]); useEffect(() => { console.log('只在第一次或重新渲染组件时触发'); }, []);}; ```  #### 清理监听[](#清理监听 "清理监听的直接链接") **通过返回一个函数可以在执行逻辑之前进行一些操作** 在监听`width`的`useEffect`中,每次改变`width`的状态,都会添加一个`resize`事件,这会极大的耗费浏览器占用的内存,通过一个返回值的方式,即可在下一次`width`状态改变后与添加新的`resize`监听前,取消上次添加的`resize`监听事件 success 为了方便查看效果,这里我们把所有的`console.log`清除掉 ``` // src/demo/effect.tsx// ...const EffectDemo: FC = () => { // ... useEffect(() => { if (typeof window !== 'undefined') { setWidth(window.innerWidth); console.log('浏览器宽度改变'); window.addEventListener('resize', resizeHandle); } return () => { window.removeEventListener('resize', resizeHandle); }; }, [width]);}; ``` #### 异步执行[](#异步执行 "异步执行的直接链接") 在`useEffect`中执行异步函数的语法如下,其实就是在原函数里调用一个`async`打头的立即函数 ``` // src/demo/effect.tsx// ...useEffect(() => { (async () => {})();}); ``` 以下示例代码让按钮在变成`ghost`之后1s再变红色 ``` // src/demo/effect.tsx'use client';// ...const EffectDemo: FC = () => { const [red, setRed] = useState<boolean>(false); // ... useEffect(() => { (async () => { await new Promise((resolve) => { setTimeout(() => resolve(true), 1000); }); setRed(ghost); })(); }, [ghost]); return ( // ... <div className="flex justify-center flex-col"> <Button type="primary" onClick={toggleGhostBtn} ghost={ghost} danger={red}> 切换按钮样式 </Button> <p className="pt-5 text-center">宽度为: {width}</p> </div> );}; ``` 效果如图  ### Ref[](#ref "Ref的直接链接") #### useRef[](#useref "useRef的直接链接") 这个钩子用于记忆前一次操作的值 以下示例代表只有在在数据更新时才会调用函数,而第一次渲染不会执行函数 ``` // src/app/demo/_components/ref.tsx'use client';// ...import $styles from './style.module.css';const RefDemo: FC = () => { const [count, setCount] = useState(0); const inited = useRef(count); useEffect(() => { if (inited.current !== count) { inited.current = count; console.log('changed'); } }, [count]); return ( <div className={clsx($styles.container, 'w-80')}> <h2 className="text-center">useRef Demo</h2> <p className="py-5 text-center">{count}</p> <div className="flex justify-around"> <Button onClick={() => setCount(Math.ceil(Math.random() * 10))} type="dashed"> 变化 </Button> </div> </div> );};export default RefDemo;// src/app/demo/page.tsx// ...<div className={$styles.demo}> <StateDemo /> <EffectDemo /> <RefDemo /></div>; ``` #### \[已弃\]forwardRef[](#已弃forwardref "[已弃]forwardRef的直接链接") 这个API在19版本中弃用,但react一般都向后兼容,所以我这里也讲解一下。课程中是使用的react19了,所以在课程中直接把`ref`做为`props`中传入即可 注意 为什么要给出react18这个老版本的api呢?因为很多react的生态(比如组件库等)目前都是用react18的语法写的,了解这个API方便更好的使用这些生态 结合`forwardRef`我们可以操作子组件 以下代码,我们与子组件建立一个双向通讯的同时,还可以通过`ref`去操作这个组件 ``` // src/app/demo/_components/ref.tsx// ...const MyInput = forwardRef<HTMLInputElement, { value: number; changeValue: (v: number) => void }>( ({ value, changeValue }, ref) => { const [local, setLocal] = useState<number | string>(value); useEffect(() => { changeValue(isNaN(Number(local)) ? 0 : Number(local)); }, [changeValue, local]); const handleChange: ChangeEventHandler<HTMLInputElement> = useCallback((e) => { setLocal(e.target.value); }, []); return <input value={value} ref={ref} placeholder="请输入值" onChange={handleChange} />; },);const RefDemo: FC = () => { // ... const inited = useRef(count); const ref = useRef<HTMLInputElement | null>(null); useEffect(() => { ref.current && ref.current.focus(); }, []); return ( <div className={clsx($styles.container, 'w-[20rem]')}> // ... <div className="flex flex-col"> <MyInput ref={ref} value={count} changeValue={setCount} /> </div> </div> );};export default RefDemo; ``` #### useImperativeHandle[](#useimperativehandle "useImperativeHandle的直接链接") 这个Hook用于在子组件中添加一些函数,然后这些函数可以在父组件中传入的`ref`来绑定,这样就可以在父组件中调用这些子组件中的函数了 此Hook接受三个参数 - ref - 返回给父组件的对象 - 更新依赖值 编写如下示例 ``` // src/app/demo/_components/ref.tsx// ...interface RefFunc { focus: () => void; memo: () => number;}const MyInput = forwardRef<RefFunc, { value: number; changeValue: (v: number) => void }>( ({ value, changeValue }, ref) => { const [local, setLocal] = useState<number | string>(value); const inputRef = useRef<HTMLInputElement | null>(null); useImperativeHandle( ref, () => ({ focus: () => inputRef.current.focus(), memo: () => value, }), [value], ); useEffect(() => { changeValue(isNaN(Number(local)) ? 0 : Number(local)); }, [changeValue, local]); const handleChange: ChangeEventHandler<HTMLInputElement> = useCallback((e) => { setLocal(e.target.value); }, []); return ( <input className="bg-white" value={value} ref={inputRef} placeholder="请输入值" onChange={handleChange} /> ); },);const RefDemo: FC = () => { const [count, setCount] = useState(0); const ref = useRef<RefFunc | null>(null); useEffect(() => { ref.current && ref.current.focus(); }, []); return ( <div className={clsx($styles.container, 'w-[20rem]')}> {/* ,,, */} <div className="flex flex-col"> {!isNil(ref.current) && <p className="my-3">前一个值:{ref.current.memo()}</p>} <MyInput ref={ref} value={count} changeValue={setCount} /> </div> </div> );};export default RefDemo; ``` 效果如下  ### 重复渲染[](#重复渲染 "重复渲染的直接链接") 在组件中直接写值的时候,会造成某个组件或兄弟组件或后代组件的重复渲染。我们可以通过以下方法来避免这种情况的发生以提供应用的性能 #### useMemo[](#usememo "useMemo的直接链接") 这个Hook用于缓存一些值,只有当它的依赖项改变时才能返回新的值 语法如下 信息 当依赖项改变时,会自行执行函数返回新的值 ``` useMemo(() => { 返回值;}, [依赖项]); ``` 编写以下示例并在`App.tsx`中导入 ``` // src/app/demo/_components/memo.tsx'use client';// ...import $styles from './style.module.css';const ChildCom1: FC<{ value: number }> = () => { console.log('渲染子组件1'); return null;};const ChildCom2: FC<{ value: number }> = () => { console.log('渲染子组件2'); return null;};const MemoDemo: FC = () => { const [count1, setCount1] = useState<number>(0); const [count2, setCount2] = useState<number>(0); return ( <div className={clsx($styles.container, 'w-[20rem]')}> <h2 className="text-center">useMemo Demo</h2> <div className="flex justify-around"> <Button onClick={() => setCount1(Math.ceil(Math.random() * 10))} type="dashed"> 变化coun1 </Button> <Button onClick={() => setCount2(Math.ceil(Math.random() * 10))} type="dashed"> 变化coun2 </Button> </div> <div className="flex justify-around"> <ChildCom1 value={count1} /> <ChildCom2 value={count2} /> </div> </div> );};export default MemoDemo;// src/app/demo/page.tsx// ...const DemoPage: FC = () => ( <> <StateDemo /> <EffectDemo /> <RefDemo /> <MemoDemo /> </>); ``` 可以看到每次,点击两个按钮中的任何一个,两个子组件都会被渲染  这样子,如果一个组件内有一批子组件,每个子组件又有很多子组件,则会出现大量的重复渲染而导致应用的性能问题 下面我们来改造一下,变成这样 ``` // src/app/demo/_components/memo.tsx// ...const MemoDemo: FC = () => { const [count1, setCount1] = useState<number>(0); const [count2, setCount2] = useState<number>(0); const ChildWrap1 = useMemo(() => <ChildCom1 value={count1} />, [count1]); const ChildWrap2 = useMemo(() => <ChildCom2 value={count2} />, [count2]); return ( <div className={clsx($styles.container, 'w-[20rem]')}> <h2 className="text-center">useMemo Demo</h2> <div className="flex justify-around"> <Button onClick={() => setCount1(Math.ceil(Math.random() * 10))} type="dashed"> 变化coun1 </Button> <Button onClick={() => setCount2(Math.ceil(Math.random() * 10))} type="dashed"> 变化coun2 </Button> </div> <div className="flex justify-around"> {ChildWrap1} {ChildWrap2} </div> </div> );}; ``` 我们使用`useMemo`把组件包起来,这样的话,只有在它的依赖更新时才会重新渲染这个子组件,于是就出现两个子组件互不影响的效果了  `useMemo`的使用场景非常多,我们将在后续课程中继续深入 #### memo函数[](#memo函数 "memo函数的直接链接") 另外,如果只是像上述例子一样,简单的防止子组件重复渲染的话,也可以使用`memo`函数。这会根据传入到子组件的props(参数)的变化来确定是否渲染该子组件,达到的效果跟`useMemo`是一样的 ``` // src/app/demo/_components/memo.tsx// ...const ChildCom1: FC<{ value: number }> = memo(() => { console.log('渲染子组件1'); return null;});const ChildCom2: FC<{ value: number }> = memo(() => { console.log('渲染子组件2'); return null;});const MemoDemo: FC = () => { // ... <div className="flex justify-around"> <ChildCom1 value={count1} /> <ChildCom2 value={count2} /> </div>;};export default MemoDemo; ``` #### useCallback[](#usecallback "useCallback的直接链接") 这个钩子与`useMemo`类似,只不过`useMemo`缓存的是一个函数中的返回值,而`useCallback`直接缓存函数本身 语法如下 ``` useCallback(() => {}, [依赖项]); ``` 例如以下代码,由于在点击按钮时`useState`解析出来的值会发生变化,从而导致组件被重新渲染,这导致`setCount`和`getInfo`这两个函数的堆栈地址发生变化 ``` // src/app/demo/_components/callback.tsx'use client';// ...const Info: FC<{ call: () => void }> = memo(() => { console.log('渲染消息'); return null;});export const CallbackDemo: FC = () => { const [, setCount] = useState<number>(0); const changeCount = () => setCount(Math.ceil(Math.random() * 10)); const getInfo = () => {}; useEffect(() => { console.log('getInfo函数的值改变'); }, [getInfo]); return ( <div className={clsx($styles.container, 'w-[20rem]')}> <h2 className="text-center">useCallback Demo</h2> <div className="flex justify-around"> <Info call={getInfo} /> <Button onClick={changeCount} type="dashed"> 变化count1 </Button> </div> </div> );};// src/app/demo/page.tsx// ...const DemoPage: FC = () => ( <div className={$styles.demo}> <StateDemo /> <EffectDemo /> <RefDemo /> <MemoDemo /> <CallbackDemo /> </div>); ``` 效果  由于`Info`组件不依赖于`setCount`而只依赖`getInfo`,所以我们可以用`useCallback`对`getInfo`做个缓存,这样即使`setCount`函数的堆栈发生变化也不影响`getInfo`函数 ``` // src/app/demo/_components/callback.tsx// ...export const CallbackDemo: FC = () => { const [, setCount] = useState<number>(0); const changeCount = () => setCount(Math.ceil(Math.random() * 10)); const getInfo = useCallback(() => {}, []); //...}; ```  ### use/useContext[](#useusecontext "use/useContext的直接链接") success 注意react v19更建议使用`use`替代`useContext`,详细请查看[这里](https://zh-hans.react.dev/reference/react/use) 用于向后代组件透传一个值(状态),以创建一个语言选择器为例 #### 定义类型[](#定义类型 "定义类型的直接链接") ``` // src/app/demo/_components/context/types.ts/** * 语言类型 */export interface LocaleType { /** * 语言名称 */ name: string; /** * 语言标签 */ label: string;}/** * 语言状态 */export interface LocaleState { locale: LocaleType; setLocale: (locale: LocaleType) => void;} ``` #### 定义语言列表[](#定义语言列表 "定义语言列表的直接链接") ``` // src/app/demo/_components/context/constants.tsimport type { Locale } from 'antd/es/locale';import enUS from 'antd/es/locale/en_US';import zhCN from 'antd/es/locale/zh_CN';import type { LocaleType } from './types';/** * antd语言包 */export const localeData: Record<string, Locale> = { en_US: enUS, zh_CN: zhCN,};/** * 可选语言列表 */export const locales: LocaleType[] = [ { name: 'en_US', label: '🇺🇸 english(US)', }, { name: 'zh_CN', label: '🇨🇳 简体中文', },]; ``` #### 创建context[](#创建context "创建context的直接链接") ``` // src/app/demo/_components/context/constants.ts// ...import { createContext } from 'react';import type { LocaleState, LocaleType } from './types';import { locales } from './constants';export const LocaleContext = createContext<LocaleState>({ locale: locales[0], setLocale: (_locale: LocaleType) => {},}); ``` #### 创建provider包装器[](#创建provider包装器 "创建provider包装器的直接链接") ``` // src/app/demo/_components/context/index.tsx// ...const LocaleProvider: FC<PropsWithChildren<LocaleState>> = ({ locale, setLocale, children }) => { const value = useMemo(() => ({ locale, setLocale }), [locale]); return <LocaleContext value={value}>{children}</LocaleContext>;}; ``` #### 创建Locale组件[](#创建locale组件 "创建Locale组件的直接链接") ``` // src/app/demo/_components/context/index.tsx// ...export const Locale: FC<PropsWithChildren> = ({ children }) => { const [locale, setLocale] = useState<LocaleType>(locales[0]); const changeLocale = useCallback((value: LocaleType) => { if (Object.keys(localeData).find((v) => v === value.name)) { setLocale(value); } }, []); return ( <LocaleProvider locale={locale} setLocale={changeLocale}> {children} </LocaleProvider> );}; ``` #### 包装Layout[](#包装layout "包装Layout的直接链接") 使用 `<Locale>`组件包装`DemoLayout`,而把原来的包装拆分成以下两个组件,这样就可以使用`use`(或`useContext`)来获取状态了 ``` // src/app/demo/layout.tsx// ...const DemoAntd: FC<PropsWithChildren> = ({ children }) => ( <ConfigProvider {/* ... */}> {/* ... */} </ConfigProvider>);const DemoLayout: FC<PropsWithChildren> = ({ children }) => ( <AntdRegistry> <Locale> <DemoAntd>{children}</DemoAntd> </Locale> </AntdRegistry>);export default DemoLayout; ``` 然后再次修改`DemoAntd`组件,在`ConfigProvider`中拿到当前的antd语言包,放入其配置中 ``` // src/app/demo/layout.tsx// ...const DemoAntd: FC<PropsWithChildren> = ({ children }) => { const { locale } = use(LocaleContext); const antdLocaleData = useMemo(() => { if (!Object.keys(localeData).find((v) => v === locale.name)) { return localeData[0]; } return localeData[locale.name]; }, [locale.name]); return ( <ConfigProvider locale={antdLocaleData} {/* ... */} > {/* ... */} </ConfigProvider> );}; ``` #### 语言选择器[](#语言选择器 "语言选择器的直接链接") ``` // src/app/demo/_components/context/index.tsx// ...import { Select } from 'antd';import { Pagination, Select } from 'antd';import $styles from '../style.module.css';export const LocaleConfig: FC = () => { const { locale, setLocale } = use(LocaleContext); const changeLocale = (value: string) => { const current = locales.find((item) => item.name === value); current && setLocale(current); }; return ( <Select defaultValue={locale.name} style={{ width: 120 }} onChange={changeLocale}> {locales.map(({ name, label }) => ( <Select.Option key={name} value={name}> {label} </Select.Option> ))} </Select> );};const ContextDemo: FC = () => { const { locale } = use(LocaleContext); return ( <div className={$styles.container}> <h2 className="text-center">useContext Demo</h2> <p className="text-center py-5">当前语言: {locale.label}</p> <div className="w-full"> <h3>Antd语言切换测试</h3> <div className="w-full my-4"> <LocaleConfig /> </div> </div> <Pagination defaultCurrent={0} total={500} /> </div> );};export default ContextDemo; ``` 在页面中加入Demo组件查看效果 ``` // src/app/demo/page.tsx// ...import ContextDemo from './_components/context';import $styles from './page.module.css';const DemoPage: FC = () => ( <div className={$styles.demo}> {/* <StateDemo /> <EffectDemo /> <RefDemo /> <MemoDemo /> <CallbackDemo /> */} <ContextDemo /> </div>);export default DemoPage; ```  ### useReducer[](#usereducer "useReducer的直接链接") 使用`Context`+`useReducer`可以实现轻量级的全局状态管理以实现一个简单的应用配置功能为例(包含标题设置和暗黑模式切换) #### 修改CSS[](#修改css "修改CSS的直接链接") 修改一下全局的css,让应用在暗黑模式下加载不同的背景图片 下载[暗色背景图](https://cn-nb1.rains3.com/3rcd/media/1735580150277.png)并保持到`src/app/styles/images`目录中,然后重命名为"bg-dark.png",修改demo布局的css ``` /* src/app/demo/layout.module.css */.layout { /* ... */}html:global(.dark) .layout { @apply bg-[url(../styles/images/bg-dark.png)];} ``` #### 编写类型[](#编写类型 "编写类型的直接链接") ``` // src/app/demo/_components/reducer/types.tsimport type { Dispatch } from 'react';/** * 主题颜色模式 */export enum ThemeMode { LIGHT = 'light', DARK = 'dark',}/** * 主题状态 */export interface ThemeState { /** * 当前主题颜色模式 */ mode: `${ThemeMode}`; /** * 是否紧凑模式 */ compact: boolean;}/** * 主题操作类型 */export enum ThemeActionType { /** * 切换主题颜色模式 */ CHANGE_MODE = 'change_mode', /** * 切换紧凑模式 */ CHANGE_COMPACT = 'change_compact',}/** * 主题操作 */export type ThemeAction = | { type: `${ThemeActionType.CHANGE_MODE}`; value: `${ThemeMode}` } | { type: `${ThemeActionType.CHANGE_COMPACT}`; value: boolean };/** 主题状态上下文类型 */export interface ThemeContextType { state: ThemeState; dispatch: Dispatch<ThemeAction>;} ``` #### 默认配置[](#默认配置 "默认配置的直接链接") ``` // src/app/demo/_components/reducer/constants.tsimport type { ThemeState } from './types';export const defaultThemeConfig: ThemeState = { mode: 'light', compact: false,}; ``` #### 创建Context[](#创建context-1 "创建Context的直接链接") ``` // src/app/demo/_components/reducer/constants.ts// 透传配置状态与dispatchimport { createContext } from 'react';// ...export const ThemeContext = createContext<ThemeContextType | null>(null); ``` #### 状态操作[](#状态操作 "状态操作的直接链接") 为了确保数据的唯一性不被污染,使用[immer.js](https://immerjs.github.io/immer/zh-CN/)操作数据(先安装依赖库`pnpm add immer`,然后重新加载vscode窗口) ``` // src/app/demo/_components/reducer/index.tsx'use client';import { produce } from 'immer';import { Reducer } from 'react';import { ThemeAction, ThemeState } from './types';const ThemeReducer: Reducer<ThemeState, ThemeAction> = produce((draft, action) => { switch (action.type) { case 'change_mode': draft.mode = action.value; break; case 'change_compact': draft.compact = action.value; break; default: break; }}); ``` #### 包装器组件[](#包装器组件 "包装器组件的直接链接") - 合并默认配置和初始化配置 - 把配置状态和`dispatch`传给`ThemeContext` ``` // src/app/demo/_components/reducer/index.tsx// ...const defaultData: Partial<ThemeState> = {};export const Theme: FC<PropsWithChildren<{ data?: ThemeState }>> = ({ data = defaultData, children,}) => { const [state, dispatch] = useReducer(ThemeReducer, data, (initData) => ({ ...defaultThemeConfig, ...initData, })); useEffect(() => { // 根据主题模式设置 html 的 class const html = document.getElementsByTagName('html'); if (html.length) { html[0].classList.remove('light'); html[0].classList.remove('dark'); html[0].classList.add(state.mode === 'dark' ? 'dark' : 'light'); } }, [state.mode]); const value = useMemo(() => ({ state, dispatch }), [state]); return <ThemeContext value={value}>{children}</ThemeContext>;}; ``` #### 修改布局[](#修改布局 "修改布局的直接链接") 在布局中使用`Theme`组件包装,并获取其状态以修改antd的主题算法 ``` // src/app/demo/layout.tsx// ...const DemoAntd: FC<PropsWithChildren> = ({ children }) => { // ... const { state: themeState } = use(ThemeContext) || { state: defaultThemeConfig }; const algorithm = useMemo(() => { const result = [themeState.compact ? theme.compactAlgorithm : theme.defaultAlgorithm]; if (themeState.mode === 'dark') result.push(theme.darkAlgorithm); return result; }, [themeState]); return ( <ConfigProvider locale={antdLocaleData} theme={{ algorithm, {/* ... */} }} > {/* ... */} </ConfigProvider> );};const DemoLayout: FC<PropsWithChildren> = ({ children }) => ( <AntdRegistry> <Locale> <Theme> <DemoAntd>{children}</DemoAntd> </Theme> </Locale> </AntdRegistry>); ``` #### 主题选择器[](#主题选择器 "主题选择器的直接链接") ``` // src/app/demo/_components/reducer/index.tsx// ...import { Calendar, Switch } from 'antd';import $styles from '../style.module.css';export const ThemeConfig: FC = () => { const context = use(ThemeContext); if (isNil(context)) return null; const { state, dispatch } = context; const toggleMode = () => dispatch({ type: 'change_mode', value: state.mode === 'light' ? 'dark' : 'light' }); const toggleCompact = () => dispatch({ type: 'change_compact', value: !state.compact }); return ( <> <Switch checkedChildren="🌛" unCheckedChildren="☀️" onChange={toggleMode} checked={state.mode === 'dark'} defaultChecked={state.mode === 'dark'} /> <Switch checkedChildren="紧凑" unCheckedChildren="正常" onChange={toggleCompact} checked={state.compact} defaultChecked={state.compact} /> </> );};const ReducerDemo: FC = () => { const context = use(ThemeContext); if (isNil(context)) return null; const { state: { mode, compact }, } = context; return ( <div className={$styles.container}> <h2 className="text-center">useReducer Demo</h2> <div className="flex flex-col items-center"> <p>主题模式: 「{mode === 'dark' ? '暗黑' : '明亮'}」</p> <p>是否紧凑: 「{compact ? '是' : '否'}」</p> <div className="mb-5 flex-auto"> <ThemeConfig /> </div> <div className="max-w-md"> <Calendar fullscreen={false} /> </div> </div> </div> );};export default ReducerDemo; ``` 在页面中加入Demo组件查看效果 ``` // src/app/demo/page.tsx// ...const DemoPage: FC = () => ( <div className={$styles.demo}> {/* <StateDemo /> <EffectDemo /> <RefDemo /> <MemoDemo /> <CallbackDemo /> */} <ContextDemo /> <ReducerDemo /> </div>);export default DemoPage; ``` 效果如下  ### 自定义Hooks[](#自定义hooks "自定义Hooks的直接链接") 自定义的Hook必须是以`use`开头的函数 我们先把`use(ThemeContext)`以及`use(LocaleContext)`改装成自定义Hook ``` // src/app/demo/_components/hooks.tsx'use client';// .../** * 获取主题状态 */export const useTheme = () => { const context = use(ThemeContext) ?? ({} as Record<string, any>); return useMemo( () => (isNil(context.state) ? defaultThemeConfig : context.state), [context.state], );};/** * 获取主题操作方法 */export const useThemeAction = () => { const context = use(ThemeContext) ?? ({} as Record<string, any>); return useCallback(isNil(context.dispatch) ? (_params: ThemeAction) => {} : context.dispatch, [ context.dispatch, ]);};/** * */export const useLocale = () => { const context = use(LocaleContext) ?? ({} as Record<string, any>); return useMemo(() => (isNil(context.locale) ? locales[0] : context.locale), [context.locale]);};/** * 获取语言切换方法 */export const useLocaleAction = () => { const context = use(LocaleContext) ?? ({} as Record<string, any>); return useCallback(isNil(context.setLocale) ? (_locale: LocaleType) => {} : context.setLocale, [ context.setLocale, ]);}; ``` 然后我们使用这些自定义Hook改变原来的直接`use`的方式 ``` // src/app/demo/layout.tsx// ...const DemoAntd: FC<PropsWithChildren> = ({ children }) => { const locale = useLocale(); const antdLocaleData = useMemo(() => { if (!Object.keys(localeData).find((v) => v === locale.name)) { return localeData[0]; } return localeData[locale.name]; }, [locale.name]); const themeState = useTheme(); const algorithm = useMemo(() => { const result = [themeState.compact ? theme.compactAlgorithm : theme.defaultAlgorithm]; if (themeState.mode === 'dark') result.push(theme.darkAlgorithm); return result; }, [themeState]); // ...};// src/app/demo/_components/context/index.tsxexport const LocaleConfig: FC = () => { const locale = useLocale(); const setLocale = useLocaleAction(); // ...};const ContextDemo: FC = () => { const locale = useLocale(); // ...};export default ContextDemo; ``` 下面,我们再尝试编写一个只在状态更新后执行副作用的`useEffect`(禁用第一次渲染就执行的模式) - `useUpdateEffect` ``` // src/app/demo/_components/hooks.tsx// ...import { isEqual, isNil } from 'lodash';/** * 首次渲染不执行,在依赖变化时执行effect * @param effect * @param deps */export const useUpdateEffect = (effect: EffectCallback, deps?: DependencyList) => { const inited = useRef(deps); useEffect(() => { if (!isEqual(inited.current, deps)) { inited.current = deps; effect(); } }, [deps]);};// src/app/demo/_components/custom.tsx'use client';// ...import { useUpdateEffect } from './hooks';import $styles from './style.module.css';const CustomDemo: FC = () => { const [count, setCount] = useState(0); useUpdateEffect(() => { console.log('changed'); }, [count]); return ( <div className={clsx($styles.container, 'w-80')}> <h2 className="text-center">Custom Demo</h2> <p className="py-5 text-center">{count}</p> <div className="flex justify-around"> <Button onClick={() => setCount(Math.ceil(Math.random() * 10))} type="dashed"> 变化 </Button> </div> </div> );};export default CustomDemo;// src/app/demo/page.tsx// ...const DemoPage: FC = () => ( <div className={$styles.demo}> <ContextDemo /> <ReducerDemo /> <CustomDemo /> </div>); ``` 可以看到,在首次渲染时,不会打印"changed"。只有点击按钮把状态更新后才会打印  ### 我的建议[](#我的建议 "我的建议的直接链接") 暂时来说,以上内容足够应对大部分react的基础开发。不过,在next.js的应用开发中肯定会涉及到更多内容,大家可以自行在react官网查询API。当然,还有诸如[react-use](https://github.com/streamich/react-use)、[ahooks](https://ahooks.js.org/zh-CN/)等许多好用的第三方hooks库可用,我们后续课程会用到,感兴趣的同学也可自行研究起来!
peipeo
2026年11月8日 11:06
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档(打印)
分享
链接
类型
密码
更新密码