`useSearchParams`

这是 useSearchParams 的网页版本。对于 React Native 版本，请点击这里.

类型声明

declare function useSearchParams(
  defaultInit?: URLSearchParamsInit
): [URLSearchParams, SetURLSearchParams];

type ParamKeyValuePair = [string, string];

type URLSearchParamsInit =
  | string
  | ParamKeyValuePair[]
  | Record<string, string | string[]>
  | URLSearchParams;

type SetURLSearchParams = (
  nextInit?:
    | URLSearchParamsInit
    | ((prev: URLSearchParams) => URLSearchParamsInit),
  navigateOpts?: : NavigateOptions
) => void;

interface NavigateOptions {
  replace?: boolean;
  state?: any;
  preventScrollReset?: boolean;
}

useSearchParams 钩子用于读取和修改当前位置 URL 中的查询字符串。与 React 自身的 useState 钩子一样，useSearchParams 返回一个包含两个值的数组：当前位置的搜索参数和一个可用于更新它们的函数。就像 React 的 useState 钩子一样，setSearchParams 也支持函数式更新。因此，您可以提供一个函数，该函数接受一个 searchParams 并返回一个更新后的版本。

import * as React from "react";
import { useSearchParams } from "react-router-dom";

function App() {
  let [searchParams, setSearchParams] = useSearchParams();

  function handleSubmit(event) {
    event.preventDefault();
    // The serialize function here would be responsible for
    // creating an object of { key: value } pairs from the
    // fields in the form that make up the query.
    let params = serializeFormQuery(event.target);
    setSearchParams(params);
  }

  return (
    <div>
      <form onSubmit={handleSubmit}>{/* ... */}</form>
    </div>
  );
}

setSearchParams 函数的工作方式类似于 navigate，但仅针对 URL 的搜索部分。还要注意，setSearchParams 的第二个参数与 navigate 的第二个参数类型相同。