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,其他查询字段保持不变。
按自己的节奏,确认真正理解。