从 Scene 窥探 ahooks 生态之秘：庖丁解牛，洞见其道！

2023-10-23 16:58:56

ahooks Scene: 剖析分页、表格、动态列表等核心组件

探索 ahooks Scene

ahooks Scene 是一个功能强大的工具包，旨在简化 React 中常见场景的开发。通过提供易于使用的 hooks，Scene 让开发者能够轻松构建分页、表格、无限滚动和动态列表等复杂组件。在本文中，我们将深入剖析 Scene 中的关键组件，了解其设计原理和实现细节。

分页：usePagination

源码分析：

import { useEffect, useState } from 'react';

const usePagination = (initialPage = 1, initialPageSize = 10) => {
  const [currentPage, setCurrentPage] = useState(initialPage);
  const [pageSize, setPageSize] = useState(initialPageSize);

  useEffect(() => {
    // ...
  }, [currentPage, pageSize]);

  return {
    currentPage,
    pageSize,
    setCurrentPage,
    setPageSize,
  };
};

设计思想：

usePagination 巧妙地将分页逻辑封装在一个 hook 中，方便开发者复用和定制分页功能。组件内部使用 useState 管理分页状态，并通过 useEffect 在状态更新时执行副作用，确保分页状态始终与实际页面保持同步。

表格：useAntdTable

源码分析：

import { useEffect, useState } from 'react';
import { Table } from 'antd';

const useAntdTable = (dataSource, columns, initialPage = 1, initialPageSize = 10) => {
  const [currentPage, setCurrentPage] = useState(initialPage);
  const [pageSize, setPageSize] = useState(initialPageSize);
  const [pagination, setPagination] = useState({
    current: currentPage,
    pageSize: pageSize,
  });

  useEffect(() => {
    // ...
  }, [currentPage, pageSize]);

  const handleTableChange = (pagination) => {
    setCurrentPage(pagination.current);
    setPageSize(pagination.pageSize);
  };

  return {
    Table,
    dataSource,
    columns,
    pagination,
    handleTableChange,
  };
};

设计思想：

useAntdTable 类似于 usePagination，将 Ant Design 表格相关的逻辑封装在一个 hook 中。它提供了分页、排序、过滤等功能，简化了构建复杂表格组件的过程。组件内部同样使用 useState 和 useEffect 管理表格状态，确保状态与实际页面同步。

融合表格：useFusionTable

源码分析：

import { useEffect, useState } from 'react';
import FusionTable from 'fusion-table';

const useFusionTable = (dataSource, columns, initialPage = 1, initialPageSize = 10) => {
  const [currentPage, setCurrentPage] = useState(initialPage);
  const [pageSize, setPageSize] = useState(initialPageSize);
  const [pagination, setPagination] = useState({
    current: currentPage,
    pageSize: pageSize,
  });

  useEffect(() => {
    // ...
  }, [currentPage, pageSize]);

  const handleTableChange = (pagination) => {
    setCurrentPage(pagination.current);
    setPageSize(pagination.pageSize);
  };

  return {
    FusionTable,
    dataSource,
    columns,
    pagination,
    handleTableChange,
  };
};

设计思想：

useFusionTable 与 useAntdTable 的设计思想相似，它将 FusionTable 表格相关的逻辑封装在一个 hook 中，并提供了分页、排序、过滤等功能。组件内部依然使用 useState 和 useEffect 管理表格状态，确保状态与实际页面同步。

无限滚动：useInfiniteScroll

源码分析：

import { useEffect, useState, useRef } from 'react';

const useInfiniteScroll = (fetchMore, initialPage = 1, initialPageSize = 10) => {
  const [currentPage, setCurrentPage] = useState(initialPage);
  const [pageSize, setPageSize] = useState(initialPageSize);
  const [hasMore, setHasMore] = useState(true);
  const [loading, setLoading] = useState(false);
  const scrollRef = useRef(null);

  useEffect(() => {
    // ...
  }, [currentPage, pageSize]);

  useEffect(() => {
    // ...
  }, [hasMore]);

  const handleScroll = (e) => {
    // ...
  };

  return {
    currentPage,
    pageSize,
    hasMore,
    loading,
    setCurrentPage,
    setPageSize,
    setHasMore,
    setLoading,
    scrollRef,
    handleScroll,
  };
};

设计思想：

useInfiniteScroll 将无限滚动逻辑封装在一个 hook 中，方便开发者构建流畅、高效的无限滚动列表。组件内部使用 useState 管理无限滚动状态，并通过 useEffect 在状态更新时执行副作用，确保状态与实际页面保持同步。handleScroll 方法用于处理滚动事件，实现无限滚动效果。

动态列表：useDynamicList

源码分析：

import { useEffect, useState } from 'react';

const useDynamicList = (initialItems = [], initialPage = 1, initialPageSize = 10) => {
  const [currentPage, setCurrentPage] = useState(initialPage);
  const [pageSize, setPageSize] = useState(initialPageSize);
  const [items, setItems] = useState(initialItems);

  useEffect(() => {
    // ...
  }, [currentPage, pageSize]);

  const addItem = (item) => {
    setItems([...items, item]);
  };

  const removeItem = (item) => {
    setItems(items.filter((i) => i !== item));
  };

  return {
    currentPage,
    pageSize,
    items,
    addItem,
    removeItem,
    setCurrentPage,
    setPageSize,
  };
};