【实战】 七、Hook，路由，与 URL 状态管理(下) —— React17+React Hook+TS4 最佳实践，仿 Jira 企业级项目（十三）

文章目录

• • 一、项目起航：项目初始化与配置
  • 二、React 与 Hook 应用：实现项目列表
  • 三、TS 应用：JS神助攻 – 强类型
  • 四、JWT、用户认证与异步请求
  • 五、CSS 其实很简单 – 用 CSS-in-JS 添加样式
  • 六、用户体验优化 – 加载中和错误状态处理
  • 七、Hook，路由，与 URL 状态管理
  • • 1+2.
    • 3~6
    • 7.完成URL状态管理与JS中的 iterator讲解

学习内容来源：React + React Hook + TS 最佳实践-慕课网

相对原教程，我在学习开始时（2023.03）采用的是当前最新版本：

具体配置、操作和内容会有差异，“坑”也会有所不同。。。

一、项目起航：项目初始化与配置

• 一、项目起航：项目初始化与配置

二、React 与 Hook 应用：实现项目列表

• 二、React 与 Hook 应用：实现项目列表

三、TS 应用：JS神助攻 – 强类型

• 三、 TS 应用：JS神助攻 – 强类型

四、JWT、用户认证与异步请求

• 四、 JWT、用户认证与异步请求(上)

---

• 四、 JWT、用户认证与异步请求(下)

五、CSS 其实很简单 – 用 CSS-in-JS 添加样式

• 五、CSS 其实很简单 – 用 CSS-in-JS 添加样式(上)

---

• 五、CSS 其实很简单 – 用 CSS-in-JS 添加样式(下)

六、用户体验优化 – 加载中和错误状态处理

• 六、用户体验优化 – 加载中和错误状态处理(上)

---

• 六、用户体验优化 – 加载中和错误状态处理(中)

---

• 六、用户体验优化 – 加载中和错误状态处理(下)

七、Hook，路由，与 URL 状态管理

1+2.

• 七、Hook，路由，与 URL 状态管理(上)

3~6

• 七、Hook，路由，与 URL 状态管理(中)

7.完成URL状态管理与JS中的 iterator讲解

searchParams 拿到了, 接下来用暴露出来的 setSearchParams 来替换 ProjectList 里的 setParam

修改 src\screens\ProjectList\index.tsx：

...export const ProjectList = () => {const [param, setParam] = useUrlQueryParam(["name", "personId"]);...};...

但是这样使用 setParam 时若是传入一个 { name1: 'Jack' } 的参数，没有任何报错拦截，这样肯定是不行的，所以需要在 setParam 即 setSearchParams 中使用对 key 的判断

修改 src\utils\url.ts ：

import { useMemo } from "react";import { URLSearchParamsInit, useSearchParams } from "react-router-dom";import { cleanObject } from "utils";...export const useUrlQueryParam = <K extends string>(keys: K[]) => {const [searchParams, setSearchParams] = useSearchParams();return [useMemo(() => keys.reduce((prev, key) => {// searchParams.get 可能会返回 null，需要预设值来兼容return { ...prev, [key]: searchParams.get(key) || "" };// 初始值会对类型造成影响，需要手动指定}, {} as { [key in K]: string }),// eslint-disable-next-line react-hooks/exhaustive-deps[searchParams]),(params: Partial<{ [key in K]: unknown }>) => {const o = cleanObject({ ...Object.fromEntries(searchParams), ...params }) as URLSearchParamsInitreturn setSearchParams(o)},] as const;};

• 遇到类似下面这样的类型不匹配问题，可以直接使用 as 来强制指定为提示的类型
  • 类型“{ [x: string]: unknown; }”的参数不能赋给类型“URLSearchParamsInit | ((prev: URLSearchParams) => URLSearchParamsInit) | undefined”的参数。

通过 Object.fromEntries 引出 Iterator 的概念：

Symbol.iterator 为每一个对象定义了默认的迭代器。该迭代器可以被 for...of 循环使用。

Symbol.iterator – JavaScript | MDN

在浏览器的 console 中做个小实验：

• 定义一个数组并使用 for..of 遍历

let arr = [1, 2, 3]for(v of arr) { console.log(v) }// 1// 2// 3

• 通过 Symbol.iterator 属性查看 此数组的 遍历器

arr[Symbol.iterator]// ƒ values() { [native code] }

• 将其执行结果拿出来

let i = a[Symbol.iterator]()i// Array Iterator {}//[[Prototype]]: Array Iterator//next: ƒ next()//Symbol(Symbol.toStringTag): "Array Iterator"//[[Prototype]]: Object

• 可以看到它有个 next() 方法，执行一下

i.next()// {value: 1, done: false}i.next()// {value: 2, done: false}i.next()// {value: 3, done: false}i.next()// {value: undefined, done: true}

• 接下来实现一下自定义遍历器

const obj = {data: ["hello", "world"],[Symbol.iterator]() {const self = this;let index = 0;return {next() {if (index < self.data.length) {return {value: self.data[index++] + "!",done: false};} else {return { value: undefined, done: true };}}};}};for (let o of obj) {console.log(o);}

线上地址：https://codesandbox.io/s/upbeat-wood-bum3j

回归项目代码，searchParams 是 URLSearchParams 类型，通过以下代码可以看出使用 Object.fromEntries 可以将其（entries）转为 object

new URLSearchParams({name: 'Jack'})[Symbol.iterator]// ƒ entries() { [native code] }

代码逻辑明白了，接下来看下页面效果：

• http://localhost:3000/projects?name=骑手&personId=18 直接访问，参数在页面中保持
• 在页面中修改参数，URL 中同时更改，但有个小问题，下拉选择负责人时，页面中展示的是 personId，接下来解决一下

在 src\screens\ProjectList\index.tsx 中打印 param

在 src\screens\ProjectList\components\SearchPanel.tsx 中打印 users

运行代码可以发现，param 中 id 是 string 但 users 中是 number，没有很好兼容，暂时在src\screens\ProjectList\components\SearchPanel.tsx 中将 id 强制转换为 string（String(user.id)）：

...export const SearchPanel = ({ users, param, setParam }: SearchPanelProps) => {return (<Form css={{ marginBottom: "2rem", ">*": "" }} layout="inline">...<Form.Item><Select {...}><Select.Option value="">负责人</Select.Option>{users.map((user) => (<Select.Option key={user.id} value={String(user.id)}>...</Select.Option>))}</Select></Form.Item></Form>);};

查看页面效果，功能正常啦！

部分引用笔记还在草稿阶段，敬请期待。。。