React / 系统课时

导航与路由参数

导航与路由参数

本课将为路由页面加入链接跳转,并从 URL 中读取商品编号、关键词和排序方式。完成后,页面导航不需要整页刷新,地址也能直接表达当前内容。

学习目标

  • 使用 Link 和 NavLink 实现客户端导航
  • 使用 useParams 读取动态路径参数
  • 使用 useSearchParams 读取和更新查询参数

使用链接完成页面跳转

普通 <a> 标签会让浏览器重新请求整个页面。React Router 提供的 Link 会更新地址并在客户端切换组件,从而保留单页应用体验。

NavLink 适合导航菜单,因为它能根据当前地址判断链接是否处于激活状态。

定义动态路由

路径中的 :productId 是动态参数。访问 /products/42 时,页面可以读取到字符串 "42"。

jsx
// src/App.jsx
import {
  Link,
  NavLink,
  Route,
  Routes,
  useParams,
  useSearchParams,
} from "react-router-dom";

function Navigation() {
  const linkClass = ({ isActive }) => (isActive ? "active" : "");

  return (
    <nav>
      <NavLink className={linkClass} to="/">
        首页
      </NavLink>
      {" | "}
      <NavLink className={linkClass} to="/products">
        商品
      </NavLink>
    </nav>
  );
}

function HomePage() {
  return <h2>首页</h2>;
}

function ProductListPage() {
  const [searchParams, setSearchParams] = useSearchParams();
  const keyword = searchParams.get("keyword") ?? "";
  const sort = searchParams.get("sort") ?? "default";

  function showReactProducts() {
    setSearchParams({ keyword: "react", sort: "price" });
  }

  return (
    <section>
      <h2>商品列表</h2>
      <p>关键词:{keyword || "全部"}</p>
      <p>排序:{sort}</p>
      <button onClick={showReactProducts}>筛选 React 商品</button>
      <ul>
        <li>
          <Link to="/products/101">查看商品 101</Link>
        </li>
        <li>
          <Link to="/products/202">查看商品 202</Link>
        </li>
      </ul>
    </section>
  );
}

function ProductDetailPage() {
  const { productId } = useParams();

  return (
    <section>
      <h2>商品详情</h2>
      <p>当前商品编号:{productId}</p>
      <Link to="/products">返回列表</Link>
    </section>
  );
}

function App() {
  return (
    <>
      <Navigation />
      <Routes>
        <Route path="/" element={<HomePage />} />
        <Route path="/products" element={<ProductListPage />} />
        <Route path="/products/:productId" element={<ProductDetailPage />} />
      </Routes>
    </>
  );
}

export default App;

预期结果

text
点击“商品”后地址变为 /products,页面不整页刷新。
点击“查看商品 101”后地址变为 /products/101,页面显示商品编号 101。
点击“筛选 React 商品”后地址变为 /products?keyword=react&sort=price。

区分路径参数与查询参数

路径参数通常标识一个明确资源,例如 /products/101 中的商品编号。查询参数通常描述筛选、排序和分页,例如 ?keyword=react&page=2。

useParams 返回的值都是字符串。需要进行数值计算时,应先转换并校验:

jsx
const { productId } = useParams();
const numericId = Number(productId);

if (!Number.isInteger(numericId) || numericId <= 0) {
  return <p>商品编号无效</p>;
}

预期结果

text
/products/12 可得到有效数字 12。
/products/abc 会显示“商品编号无效”。

示例中的真实路由是 /products/:productId;片段用于说明参数校验,放入详情组件时应与项目路径保持一致。

更新查询参数时保留必要字段

调用 setSearchParams 会生成新的查询字符串。若页面同时包含多个筛选条件,更新单个字段时应复制现有参数,避免覆盖其他条件。

jsx
function updatePage(searchParams, setSearchParams, page) {
  const next = new URLSearchParams(searchParams);
  next.set("page", String(page));
  setSearchParams(next);
}

这是片段示例,依赖组件中已有的 searchParams 与 setSearchParams。生效后只修改 page,其他查询字段保持不变。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

导航与路由参数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通