use-the-loader v1.0.2

use-the-loader

又又又一个 React 的数据加载钩子。

Another React loader hook.

该库提供两个基础的 hooks：

• useTheParams - 将多个任意的 prop 、state 、变量，构建成一个参数组合，并跟踪该参数的变化。
• useTheLoader - 关注由 params 变化触发的数据加载（不限制如何实现 loader）。

useTheParams

本来 React 的 useState 是一个十分简单且美妙的东西，我们总是乐于从基础的 state 去构建组件或 hook。

但不可避免的是多个属性（prop）或state，需要做组合，成为一个数组或object，再关注这个组合的变化，去触发下一层的操作。

这时候基于 useEffect，总是力有不逮（浅层比较深度不足，逻辑越做越复杂）。

这时候你可以选择诸如 useReducer, Redux 或 Mobx 等等，不过不管用哪个，你的代码都将变得越发庞大，需要学习的东西也越多（需要掌控和制定的规范也越来越多）。

回到问题的本质，我们需要的，只是一个组合追踪而已，为什么要让事情变复杂？

所以就有了这个 useTheParams，当你在为各种各样的 prop、state 疲于奔命时，用 useTheParams 就对了，一下子全解决了。

主要特性

• 泛型设计 - useTheParams 不锁定到底是数组还是 object，还是一个字符串，你传入什么，类型就是什么。
• 可自定义 compare 方法，默认使用了 just-compare
• onChange 事件

基础用法

import { useSearch } from '@tanstack/react-location';
import { useState } from 'react';
import { useTheParams } from 'use-the-loader';

type AnyComponentProps = {
  id?: string,
}

function AnyComponent({ id }: AnyComponentProps) {
  // Router 的 url 查询字符串变量
  const { page, search } = useSearch();
  // 组件内 state
  const [type, setType] = useState('user');

  const [params, setParams] = useTheParams(
    // 构成 params 的数据，
    // 当这些数据变动时，将自动触发 params onChange
    { id, type, page, search },
    {
      onChange: (p) => {
        // 当 params 变化时触发
      },
      // 自定义比较函数
      compare: (v1, v2) => v1 === v2,
    }
  );

  // 组件输出 ...
  return <div>AnyComponent</div>;
}

useTheLoader

又又又一个 React 的数据加载钩子。

• 不关注如何缓存
• 不关注如何实现（到底是 fetch 还是 axios，还是 graphql，还是啥）
• 只需要一个 loader 函数
• 以及 loader 函数的参数 params

useTheLoader 提供：

• 泛型设计，准确定位（编辑器可智能识别，自动提示） loader、loader 参数，loader 的 Promise<infer T>
• 根据 params 变化，自动 reload
• 可控 canLoad(params)
• 前置 beforeLoad(params) ，以修正实际 loader 的参数
• 后置 onLoad(data, params)，以便于对数据分割处理
• 过滤器 filter(data) ，以便于数据加工过滤

基础用法

import { useSearch } from '@tanstack/react-location';
import { useState } from 'react';
import { axios } from 'axios';
import { useTheLoader } from 'use-the-loader';

type LoaderQuery = {
  type?: string,
  page?: number,
  search?: string,
}

type LoaderData = {
  data: Record<string, unknown>,
  otherInfo?: Record<string, unknown>,
  filtered?: boolean,
}

const loader = (id: string, query: LoaderQuery): Promise<LoaderData> => new Promise<LoaderData>((resolve, reject) => {
  axios.request({ url: '....' })
    .then(resp => resolve(resp.data))
    .catch(err => reject(err));
})

type AnyComponentProps = {
  id?: string,
}

function AnyComponent({ id }: AnyComponentProps) {
  // Router 的 url 查询字符串变量
  const { page, search } = useSearch();
  // 组件内 state
  const [type, setType] = useState('user');

  const [otherInfo, setOtherInfo] = useState<Record<string, unknown> | undefined>(undefined);

  const { state, data, loading, reloading, } = useTheLoader({
    // 必须，loader 本体，决定了 params 参数的类型以及 data 的类型
    loader: loader,
    // 必须，参数构成
    params: [id, { type, page, search }],
    // 可选，是否可加载，不指定时，默认为 true
    canLoad: () => id != null,
    // 可选，加载数据前
    beforeLoad: ([, q]) => {
      q.type = q.type == null ? '' : q.type;
    },
    // 可选，加载数据后
    onLoad: (d) => {
      setOtherInfo(d.otherInfo);
    },
    // 可选，对加载的数据进行过滤
    filter: (d) => ({ ...d, filtered: true })
  });

  // 组件输出 ...
  return <div>AnyComponent</div>;
}

注意：当 loader 处于 loading 状态（未加载完毕）时，params 变化不会触发数据 reload。