【实战】 六、用户体验优化 - 加载中和错误状态处理(上) —— React17+React Hook+TS4 最佳实践,仿 Jira 企业级项目(八)

news/2024/12/2 22:56:34/

文章目录

    • 一、项目起航:项目初始化与配置
    • 二、React 与 Hook 应用:实现项目列表
    • 三、TS 应用:JS神助攻 - 强类型
    • 四、JWT、用户认证与异步请求
    • 五、CSS 其实很简单 - 用 CSS-in-JS 添加样式
    • 六、用户体验优化 - 加载中和错误状态处理
      • 1.给页面添加 Loading 和 Error 状态,增加页面友好性
      • 2.用高级 Hook-useAsync 统一处理 Loading 和 Error 状态


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


相对原教程,我在学习开始时(2023.03)采用的是当前最新版本:

版本
react & react-dom^18.2.0
react-router & react-router-dom^6.11.2
antd^4.24.8
@commitlint/cli & @commitlint/config-conventional^17.4.4
eslint-config-prettier^8.6.0
husky^8.0.3
lint-staged^13.1.2
prettier2.8.4
json-server0.17.2
craco-less^2.0.0
@craco/craco^7.1.0
qs^6.11.0
dayjs^1.11.7
react-helmet^6.1.0
@types/react-helmet^6.1.6
react-query^6.1.0
@welldone-software/why-did-you-render^7.0.1
@emotion/react & @emotion/styled^11.10.6

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


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

  • 【实战】 一、项目起航:项目初始化与配置 —— React17+React Hook+TS4 最佳实践,仿 Jira 企业级项目(一)

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

  • 【实战】 二、React 与 Hook 应用:实现项目列表 —— React17+React Hook+TS4 最佳实践,仿 Jira 企业级项目(二)

三、TS 应用:JS神助攻 - 强类型

  • 【实战】三、 TS 应用:JS神助攻 - 强类型 —— React17+React Hook+TS4 最佳实践,仿 Jira 企业级项目(三)

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

  • 【实战】四、 JWT、用户认证与异步请求(上) —— React17+React Hook+TS4 最佳实践,仿 Jira 企业级项目(四)

  • 【实战】四、 JWT、用户认证与异步请求(下) —— React17+React Hook+TS4 最佳实践,仿 Jira 企业级项目(五)

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

  • 【实战】 五、CSS 其实很简单 - 用 CSS-in-JS 添加样式(上) —— React17+React Hook+TS4 最佳实践,仿 Jira 企业级项目(六)

  • 【实战】 五、CSS 其实很简单 - 用 CSS-in-JS 添加样式(下) —— React17+React Hook+TS4 最佳实践,仿 Jira 企业级项目(七)

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

1.给页面添加 Loading 和 Error 状态,增加页面友好性

修改 src\screens\ProjectList\index.tsx(新增 loading 状态 和 请求错误提示)(部分未修改内容省略):

...
import { Typography } from "antd";export const ProjectList = () => {const [users, setUsers] = useState([]);const [isLoading, setIsLoading] = useState(false);const [error, setError] = useState<null | Error>(null);...useEffect(() => {setIsLoading(true)// React Hook "useHttp" cannot be called inside a callback. React Hooks must be called in a React function component or a custom React Hook function.client("projects", { data: cleanObject(lastParam) }).then(setList).catch(error => {setList([])setError(error)}).finally(() => setIsLoading(false));// React Hook useEffect has a missing dependency: 'client'. Either include it or remove the dependency array.// eslint-disable-next-line react-hooks/exhaustive-deps}, [lastParam]);...return (<Container><h1>项目列表</h1><SearchPanel users={users} param={param} setParam={setParam} />{error ? <Typography.Text type="danger">{error.message}</Typography.Text> : null}<List loading={isLoading} users={users} dataSource={list} /></Container>);
};...

修改 src\screens\ProjectList\components\List.tsxListProps 继承 TableProps, Table 的属性(透传))(部分未修改内容省略):

import { Table, TableProps } from "antd";
...interface ListProps extends TableProps<Project> {users: User[];
}// type PropsType = Omit<ListProps, 'users'>
export const List = ({ users, ...props }: ListProps) => {return (<Tablepagination={false}columns={...}{ ...props }></Table>);
};

为方便后续在组件外再次配置 Table 的属性(透传),直接让 ListProps 继承 TableProps, TableProps 单独抽出到 props

配置请求最短时间(如下图),即可清楚看到 loading 效果
在这里插入图片描述
配置请求失败比例为百分百即可看到错误提示:
在这里插入图片描述

2.用高级 Hook-useAsync 统一处理 Loading 和 Error 状态

新建 src\utils\use-async.ts (统一对 异步状态请求数据 的管理):

import { useState } from "react";interface State<D> {error: Error | null;data: D | null;stat: 'ready' | 'loading' | 'error' | 'success'
}const defaultInitialState: State<null> = {stat: 'ready',data: null,error: null
}export const useAsync = <D>(initialState?: State<D>) => {const [state, setState] = useState<State<D>>({...defaultInitialState,...initialState})const setData = (data: D) => setState({data,stat: 'success',error: null})const setError = (error: Error) => setState({error,stat: 'error',data: null})// run 来触发异步请求const run = (promise: Promise<D>) => {if(!promise || !promise.then) {throw new Error('请传入 Promise 类型数据')}setState({...state, stat: 'loading'})return promise.then(data => {setData(data)return data}).catch(error => {setError(error)return error})}return {isReady: state.stat === 'ready',isLoading: state.stat === 'loading',isError: state.stat === 'error',isSuccess: state.stat === 'success',run,setData,setError,...state}
}

修改 src\screens\ProjectList\components\List.tsx (将 Project 导出,以便后续引用)(部分未修改内容省略):

...
export interface Project {...}
...

修改 src\screens\ProjectList\index.tsx (部分未修改内容省略):

  • 删去之前 loadingerror 相关内容;
  • 删去 client 异步请求 then 及后续操作;
  • 使用 useAsync 统一处理 异步状态请求数据
...
import { List, Project } from "./components/List";
...
import { useAsync } from "utils/use-async";export const ProjectList = () => {const [users, setUsers] = useState([]);const [param, setParam] = useState({name: "",personId: "",});// 对 param 进行防抖处理const lastParam = useDebounce(param);const client = useHttp();const { run, isLoading, error, data: list } = useAsync<Project[]>();useEffect(() => {run(client("projects", { data: cleanObject(lastParam) }))// eslint-disable-next-line react-hooks/exhaustive-deps}, [lastParam]);useMount(() => client("users").then(setUsers));return (<Container>...<List loading={isLoading} users={users} dataSource={list || []} /></Container>);
};
...

新建 src\utils\project.ts (单独处理 Project 数据的异步请求):

import { cleanObject } from "utils";
import { useHttp } from "./http";
import { useAsync } from "./use-async";
import { useEffect } from "react";
import { Project } from "screens/ProjectList/components/List";export const useProjects = (param?: Partial<Project>) => {const client = useHttp();const { run, ...result } = useAsync<Project[]>();useEffect(() => {run(client("projects", { data: cleanObject(param || {}) }))// eslint-disable-next-line react-hooks/exhaustive-deps}, [param]);return result
}

新建 src\utils\use-users.ts (单独处理 User 数据的异步请求):

import { cleanObject } from "utils";
import { useHttp } from "./http";
import { useAsync } from "./use-async";
import { useEffect } from "react";
import { User } from "screens/ProjectList/components/SearchPanel";export const useUsers = (param?: Partial<User>) => {const client = useHttp();const { run, ...result } = useAsync<User[]>();useEffect(() => {run(client("users", { data: cleanObject(param || {}) }))// eslint-disable-next-line react-hooks/exhaustive-deps}, [param]);return result
}

再次修改 src\screens\ProjectList\index.tsx (部分未修改内容省略):

  • ProjectUser 数据获取分别单独抽离
import { SearchPanel } from "./components/SearchPanel";
import { List } from "./components/List";
import { useState } from "react";
import { useDebounce } from "utils";
import styled from "@emotion/styled";
import { Typography } from "antd";
import { useProjects } from "utils/project";
import { useUsers } from "utils/use-users";export const ProjectList = () => {const [param, setParam] = useState({name: "",personId: "",});// 对 param 进行防抖处理后接入请求const { isLoading, error, data: list } = useProjects(useDebounce(param));const { data: users } = useUsers();return (<Container><h1>项目列表</h1><SearchPanel users={users || []} param={param} setParam={setParam} />{error ? (<Typography.Text type="danger">{error.message}</Typography.Text>) : null}<List loading={isLoading} users={users || []} dataSource={list || []} /></Container>);
};
...

测试功能:一切正常!


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


http://www.ppmy.cn/news/728529.html

相关文章

简要介绍 | 大规模三维场景理解:从点云到智能导航

注1&#xff1a;本文系“简要介绍”系列之一&#xff0c;仅从概念上对大规模三维场景理解进行非常简要的介绍&#xff0c;不适合用于深入和详细的了解。 大规模三维场景理解&#xff1a;从点云到智能导航 InteriorNet: Mega-scale Multi-sensor Photo-realistic Indoor Scenes …

多测师肖sir_高级金牌讲师_项目介绍之保险项目的案例

案例1: https://www.chinalife.com.cn/chinalife/index/ 中国人寿 名称:中国人寿(china life) 公司以及背景的介绍:中国人寿集团目前拥有中国人寿保险股份有限公司,广发银行股份有限公司,中国人寿资产管理有限公司,中国人寿财产保险有限公司,中国人寿养老保险有限公司…

$HOME

Ubuntu中 命令行输入$HOME bash: /home/XXX: Is a directory $HOME 是用户主目录 转载于:https://www.cnblogs.com/Todd-Qi/p/10390547.html

H.264 Reference Model JM 19.0及以前版本下载地址

JM19.0: http://iphome.hhi.de/suehring/tml/download/ 之前版本&#xff1a;http://iphome.hhi.de/suehring/tml/download/old_jm/ 感谢 Karsten Suehring 大佬&#xff01;

H.264编解码器

JM H.264标准研究团队的官方参考软件实现了H.264的全部特征运算复杂&#xff0c;无优化&#xff0c;编解码难以实时常用于科学研究领域 http://iphome.hhi.de/suehring/tml/ 旧版本下载 http://iphome.hhi.de/suehring/tml/download/old_jm/ X264 著名的H.264开源编码器&…

My Home

public class HomeApplication {public static void main(String[] args) {System.out.println("欢迎你来到这里&#xff01;");} }

【H.264/AVC视频编解码技术详解】四. 常见H.264视频编解码器(X264和JM)及参考软件JM的下载与编解码

《H.264/AVC视频编解码技术详解》视频教程已经在“CSDN学院”上线&#xff0c;视频中详述了H.264的背景、标准协议和实现&#xff0c;并通过一个实战工程的形式对H.264的标准进行解析和实现&#xff0c;欢迎观看&#xff01; “纸上得来终觉浅&#xff0c;绝知此事要躬行”&am…

H.264官方软件JM源代码分析

JM源码地址&#xff1a; http://iphome.hhi.de/suehring/tml/download/ 参考&#xff1a; H.264官方软件JM源代码简单分析-编码器lencod H.264官方软件JM源代码简单分析-解码器ldecod HEVC官方软件HM源代码简单分析-编码器TAppEncoder HEVC官方软件HM源代码简单分析-解码…