feat(web): 地址栏驱动视图,刷新详情页不再回首页

- 新增 data/view.ts 与 useViewRoute:视图与地址双向同步,支持前进后退
- 条目地址带上所属分组,刷新 / 收藏后「返回」有确定落点
- 服务端只把 /c/** 回落到 index.html,其余路径仍返回 404
- 明细页返回按钮去掉左侧箭头图标
This commit is contained in:
2026-10-24 17:18:30 +08:00
parent 41fed5e64d
commit 19ead7b716
22 changed files with 2098 additions and 1321 deletions
+1 -14
View File
@@ -1,4 +1,3 @@
import type { NavModel } from './data/nav'
import type { Category } from './data/types'
export type Project = {
@@ -79,28 +78,17 @@ const CATALOG_EVENTS_ENDPOINT = '/api/catalog/events'
type CatalogPayload = {
categories?: Category[]
nav?: NavModel
}
/** 内容目录的完整返回:分类树 + 侧栏导航 */
/** 内容目录的完整返回;侧栏由这份分类树派生 */
export type Catalog = {
categories: Category[]
nav: NavModel
}
/** 服务端字段可能缺失,统一在这里补成空数组,组件层就不用判空 */
function normalizeNav(nav: NavModel | undefined): NavModel {
return {
topLevel: Array.isArray(nav?.topLevel) ? nav.topLevel : [],
groups: Array.isArray(nav?.groups) ? nav.groups : [],
}
}
/**
* 拉取完整内容目录。
*
* 数据量只有几十 KB,一次全量取回即可;搜索仍然在前端按关键字过滤。
* 分类与导航一起下发,因为首页和侧栏同时需要它们。
*/
export async function fetchCatalog(signal?: AbortSignal): Promise<Catalog> {
const response = await fetch(CATALOG_ENDPOINT, {
@@ -116,7 +104,6 @@ export async function fetchCatalog(signal?: AbortSignal): Promise<Catalog> {
return {
categories: Array.isArray(payload.categories) ? payload.categories : [],
nav: normalizeNav(payload.nav),
}
}