31 lines
1.3 KiB
Markdown
31 lines
1.3 KiB
Markdown
|
---
|
|||
|
|
name: jjb-route-query-params
|
|||
|
|
description: 定义 JJB 项目获取路由查询参数规范。在使用 tools.router.query、获取 query 参数或搜索表单状态持久化时使用。禁止对路由参数进行类型转换。
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 路由与导航
|
|||
|
|
|
|||
|
|
## 获取路由参数
|
|||
|
|
|
|||
|
|
### 获取查询参数（Query 参数）
|
|||
|
|
|
|||
|
|
- **方法**：使用 `tools.router.query` 获取路由查询参数
|
|||
|
|
- **适用范围**：适用于所有组件，不限于路由页面组件
|
|||
|
|
- **返回格式**：返回一个 Proxy 对象，包含所有查询参数
|
|||
|
|
|
|||
|
|
- 基本使用：
|
|||
|
|
|
|||
|
|
```javascript
|
|||
|
|
import { tools } from '@cqsjjb/jjb-common-lib';
|
|||
|
|
|
|||
|
|
// 当前 URL: /user/list?page=1&size=10&status=active
|
|||
|
|
const queryParams = tools.router.query;
|
|||
|
|
// queryParams => { page: '1', size: '10', status: 'active' }
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- **禁止行为**：禁止对路由参数进行转换操作（如将 id 字段值转换为 number），这会导致 id 值失真。路由参数应保持原始字符串格式。
|
|||
|
|
|
|||
|
|
- **详细 API 文档**：参考 [`21-jjb-common-lib/01-tools模块使用规范`](../../21-jjb-common-lib/01-tools模块使用规范.md)（查看"2.9 路由参数管理"章节）
|
|||
|
|
|
|||
|
|
- **搜索表单场景**：在搜索表单中使用 `router.query` 进行状态持久化，参考 [`06-搜索区规范`](../../06-搜索区规范/02-搜索状态持久化/SKILL.md)
|