首页 > 其他分享 >React后台管理(十二)-- 页面常用hook封装 --- useSearch搜索封装

React后台管理(十二)-- 页面常用hook封装 --- useSearch搜索封装

时间:2024-05-28 09:57:49浏览次数:33  
标签:current pageIndex 封装 pageSize -- --- searchForm state const

文章目录


前言

在今天的 React 生态系统中,有许多优秀的 React Hooks 库,如 ahooks,react-query等,可以自行查阅。这些库确实非常有用,我也在使用。然而,这个系列的初衷是为了教人入门 React 后台管理系统的开发,从零开始构建并实现常用功能。为了更好地理解和应用 React Hooks,这个系列会列举几个例子来讲,以便大家后续根据自己项目的需求继续封装一些自定义hook,或者使用 ahooks 库来满足项目需求。这样不仅可以帮助我们学习 React Hooks 的用法,同时也可以在项目中直接使用这些 Hooks,满足我们的需求。通过这种方式,我们可以在不依赖第三方库的情况下,同时学习和应用 React Hooks,掌握其优势,并为我们的项目开发带来更大的灵活性和效率。


一、useSearch自定义hook封装

结构分析:
(1)用于处理Ant Design表格数据请求的自定义Hook
(2)它可以帮助你在页面上轻松获取,更新和重置参数,同时还可以记录当前页码,以便在返回时定位到之前的分页数据。
(3)简化表格数据请求的操作,使得开发者可以更轻松地处理表格数据的搜索、筛选和分页

1. 核心代码

(1)hook文件代码+详细注释

// @/hook/use-search/index.js
import { useState, useRef, useEffect } from "react";
import useStore from "@/store";
import { useLocation } from "react-router-dom";
import Config from "@/config";
// 路由白名单
import white from "@/config/pageWhite";
export const useSearch = (params = {}) => {
 const { TableStore } = useStore();
 const { pathname } = useLocation(); // 获取当前的路由
 const handler = useRef(false); // 是否是手动请求
 const prevPath = TableStore.state.fromPath; // 上一个路由
 const searchForm = useRef({
   ...params,
   pageIndex: Config.pageIndex,
   pageSize: Config.pageSize,
 }); // 默认参数
 const copy = JSON.parse(
   JSON.stringify({
     ...params,
     pageIndex: Config.pageIndex,
     pageSize: Config.pageSize,
   })
 ); // 备份默认参数

 // 保存参数
 const saveReq = () => {
   localStorage.setItem("req", JSON.stringify(searchForm.current));
 };
 // 搜索时,参数更新
 const searchReq = () => {
   handler.current = true;
   searchForm.current.pageIndex = Config.pageIndex;
   saveReq();
 };
 // 重置时,参数更新
 const resetReq = () => {
   handler.current = true;
   searchForm.current = copy;
   saveReq();
 };
 // 页码更新
 const pageReq = () => {
   handler.current = true;
   searchForm.current.pageSize = TableStore.state.page.size;
   searchForm.current.pageIndex = TableStore.state.page.index;
   saveReq();
 };
 // 更新请求参数数据
 const updateReq = (value) => {
   const keys = Object.keys(value);
   // 不存在参数
   if (!keys.length) {
     return false;
   }
   // 存在参数,根据value传值,完成部分参数更新
   for (let key in value) {
     searchForm.current[key] = value[key];
   }
   // 重置当前页
   searchForm.current.pageIndex = Config.pageIndex;
   // 保存请求参数
   saveReq();
 };
 // 获取请求参数
 const getReq = () => {
   const action = TableStore.state.filterAction; // 筛选动作类型
   action === "reset" && resetReq(); // 重置,调用重置方法
   action === "search" && searchReq(); // 搜索,调用搜索方法
   action === "page" && pageReq(); // 页码更新,调用页码更新方法
   // 是否在白名单,即当前模块是否有详情页,如有详情页,当前列表就加入白名单,以便详情返回定位到之前的页码
   const isKey = white[pathname];
   // 上个路由是否是详情页
   const isValue = isKey && white[pathname].includes(prevPath);
   let result = searchForm.current;
   // 如果是从详情页回退,判断该模块是否需要恢复之前的请求参数
   if (isKey && isValue && !handler.current) {
     result = JSON.parse(localStorage.getItem("req")) || searchForm.current;
     searchForm.current = result;
   }
   // 设置筛选动作为null,防止重复请求
   TableStore.SET_FILTER_ACTION(null);
   return result;
 };
 useEffect(() => {
   TableStore.SET_CURRENT_PATH(pathname); // 执行副作用,设置当前路由
 }, [pathname]); // 依赖于location变化来执行副作用
 return {
   searchForm,
   saveReq,
   getReq,
   resetReq,
   pageReq,
   updateReq,
 };
};

(2)使用到的store说明

注意:为了记录路由,以便在需要时跳转到详情页并返回原页面时,能够定位到之前的页码。
详细store文件代码请查看之前文章:状态管理工具mobx使用以及项目使用到的store文件封装

(3)使用到的config文件代码

// @/config
export default {
  title: "AMORE管理系统",
  // 每页数量
  pageSize: 10,
  pageIndex: 1,
};

(4)使用到的白名单pageWhite文件代码

// @/config/pageWhite
export default {
  title: "AMORE管理系统",
  // 每页数量
  pageSize: 10,
  pageIndex: 1,
};

2. 使用方式

(1)layout布局组件->监听并记录路由

// @/layout/index.jsx
// 仅在pathname变化时执行一次
  useEffect(() => {
    TableStore.SET_CURRENT_PATH(pathname); // 执行副作用,设置当前路由
  }, [pathname]); // 依赖于location变化来执行副作用

详细layout布局组件代码请查看之前文章:layout布局相关组件封装,以及嵌套路由使用

(2)搜索按钮组件->记录列表搜索的动作类型:搜索 | 重置

// 搜索事件记录动作类型为search
const search = () => {
  TableStore.SET_FILTER_ACTION("search");
  props?.search();
};
// 重置事件记录动作类型为reset
const reset = () => {
  TableStore.SET_FILTER_ACTION("reset");
  props?.reset();
};
// 相关HTML代码
<Button type="primary" style={collapseMargin} onClick={() => search()}>
  查 询
</Button>
<Button style={collapseMargin} onClick={() => reset()}>
  重 置
</Button>

详细代码请查看之前的文章:开发页面前准备 — 表单搜索组件封装

(3)分页组件->记录列表搜索的动作类型:分页

// 分页器绑定分页事件
 <Pagination className="pull-right" size="small" disabled={state.current.disabled} defaultCurrent={state.current.pageIndex} current={state.current.pageIndex} pageSize={state.current.pageSize} total={state.current.total} showSizeChanger onChange={pageChange} />
 // 分页事件记录
 const pageChange = (page, pageSize) => {
    const isFunction = checkDataType().isFunction(props?.page);
    if (!isFunction) {
      return false;
    }
    state.current.disabled = true;
    // 记录动作类型
    TableStore.SET_FILTER_ACTION("page");
    TableStore.SET_PAGE({ size: pageSize, index: page });
    state.current.pageIndex = page;
    state.current.pageSize = pageSize;
    props?.page(page, pageSize).finally(() => {
      state.current.disabled = false;
    });
  };

详细请查看之前内容盒子封装文章:页面开发前准备—Outlet布局组件封装

(4)页面使用方式及详细说明如下

// 引入hook
import { useTable, useSearch } from "@/hook/index.js";
// 调用初始化配置
const { getReq, updateReq, searchForm } = useSearch({
  name: "",
  liaisonName: "",
  liaisonMobile: "",
  brandStatus: undefined,
});
----------------------------------------------------------------------------------------------
// 列表数据请求时,获取重组后的请求参数 getReq()
const getList = async () => {
  setLoading(true);
  ChainBrandsList(getReq())
    .then((res) => {
      console.log("getReq",getReq());
      setCustomerData({
        list: res.data?.records || [],
        count: res.data?.total || 0,
      });
      setLoading(false);
      tableRef.current && tableRef.current.setTotal(res.data?.total);
    })
    .catch(() => {
      setLoading(false);
    });
};
----------------------------------------------------------------------------------------------
// 搜索按钮组件->重置,搜索按钮回调后,更新参数
<SearchButton toggle={handlerToggle} reset={handlerReset} search={handlerSearch}></SearchButton>
// 搜索
const handlerSearch = () => {
  console.log("搜索", searchRef.current.getFieldValue());
  searchRef.current.getFieldValue() && updateReq(searchRef.current.getFieldValue());
  tableRef.current.reset();
  getList();
};
// 重置
const handlerReset = () => {
  searchRef.current.reset();
  getList(); 
};
----------------------------------------------------------------------------------------------
// container组件->分页回调时,更新参数
<CdList tableRef={tableRef} page={changePage}>
...
</CdList>
// 切换页码
const changePage = () => {
  return getList();
};
----------------------------------------------------------------------------------------------

3. 效果展示

在这里插入图片描述
在这里插入图片描述在这里插入图片描述


总结

下一篇讲【页面常用hook封装 — useTable封装】。关注本栏目,会实时更新。

标签:current,pageIndex,封装,pageSize,--,---,searchForm,state,const
From: https://blog.csdn.net/weixin_43883615/article/details/139238403

相关文章

  • js复制功能
    <divclass="content"></div><el-button@click="copy">复制</el-button>copy(){ letpList=document.querySelectorAll(".content") letvalueList=[] if(pList.length>0){ pList.forEach(......
  • 界面控件DevExtreme v23.2亮点 - 标签、表单、编辑器功能升级
    DevExtreme拥有高性能的HTML5/JavaScript小部件集合,使您可以利用现代Web开发堆栈(包括React,Angular,ASP.NETCore,jQuery,Knockout等)构建交互式的Web应用程序。从Angular和Reac,到ASP.NETCore或Vue,DevExtreme包含全面的高性能和响应式UI小部件集合,可在传统Web和下一代移动应用程序中......
  • nginx 配置 vue History模式
    解决需要加一行try_files$uri$uri//index.html;,其中/index.html是你自己的目录中的入口文件server{listen[::]:80default_server;#root/var/www/html;#Addindex.phptothelistifyouareusingPHPindexindex.htmlindex......
  • linux 系统概念总结
    一、MBR分区或GPT分区有什么区别MBR(MasterBootRecord)和GPT(GUIDPartitionTable)是用于在硬盘上进行分区的两种不同的标准容量支持:MBR:最大支持2TB的硬盘容量。GPT:支持非常大的硬盘容量,最大可达到数EB(Exabytes)级别。分区数限制:MBR:最多支持4个主分区,或者3个主分区和......
  • SQLServer统计监控SQL执行计划突变的方法
    使用动态管理视图(DMVs)来检测SQL执行计划的突变,你需要关注那些能够提供查询执行统计和计划信息的视图。以下是一些可以用于此目的的DMVs以及相应的查询示例:sys.dm_exec_query_stats:这个视图提供了关于SQLServer中查询执行的统计信息,包括CPU时间、总工作时间、执行次数等。SE......
  • 【WCH蓝牙系列芯片】-基于CH582开发板—主机连接从机(128bitUUID)实现通信
    -------------------------------------------------------------------------------------------------------------------------------------  在之前一篇主机枚举从机所有服务和特征的博客中,介绍主机连接从机的流程,并且枚举从机的服务,进行通信操作。在本篇博客中,基于CH582......
  • 背包九讲 一 01背包
    https://www.acwing.com/problem/content/2/有N件物品和一个容量是V的背包。每件物品只能使用一次。第i件物品的体积是vi,价值是wi。求解将哪些物品装入背包,可使这些物品的总体积不超过背包容量,且总价值最大。输出最大价值。输入格式第一行两个整数,N,V,用空格隔开,分别......
  • HITSC_6_Abstract Data Type (ADT)
    AbstractionandUser-DefinedTypes......
  • C#开发的应用升级更新服务器端工具 - 开源研究系列文章 - 个人小作品
          笔者开发过一些小应用,然后这些应用就需要有升级更新的功能,但是如果每个都集成进去也行,但是就是得写死更新的代码了。于是就想写一个应用升级更新的管理器,以前看到过Github上有一个AutoUpdate.Net,不过它那个要集成到应用中的,不符合笔者的需求,上次编写的那个没写完,然后......
  • 数组
    数组1.数组概述数组是相同类型数据的有序集合数组描述的是相同类型的若干个数据,按照一定的先后次序排列组合而成;其中,每一个数据称作一个数组元素,每个数组元素可以通过一个下标访问它们2.数组声明创建首先必须声明数组变量,才能在程序中使用数组。下面是声明数组变量的语法......