Skip to content

前端架构

前端技术点

阅读器

genshin-novel-reader-web 使用 React 18、Ant Design 5、Vite 7 和 Less。Axios 访问在线 API;react-intl-universal 负责国际化;localforage 用于保存阅读样式。Vite 将应用构建为可嵌入 Node Web 的库,npm run local-build 用于本地集成构建。

UI 按 src/features/ 的功能目录组织,通用 API、模型、国际化和工具位于 src/shared/。入口组件 App.js 组合导航栏、阅读区和设置面板。用户可导入本地文件、在线搜索/阅读小说、管理书架和评论,以及调整阅读样式和模式。

状态管理

阅读器使用 React useState、useEffect 和回调管理组件状态;跨多个功能区共享的 API、用户和移动端状态通过 AppContext 传递。没有 Redux store、reducers 或 React Router。

当前阅读器状态包括文件列表和选中文件、阅读样式、分页位置、面板可见性以及在线 API/用户信息。文件列表和当前阅读位置保存在内存中;阅读样式写入 localforage。详见状态管理和浏览器存储。

管理页面

Node API 仓库的 react/ 子项目包含登录、注册、退出及管理员统计界面,使用 React 和 Ant Design。它与 npm 发布的阅读器包是不同的前端入口,服务端用 EJS 页面和静态资源集成。

其他主要依赖

  • classnames:组合 CSS 类名。
  • is-hotkey:键盘快捷键处理。
  • react-color:颜色选择器。
  • react-icons:图标。
  • react-select:选择控件。
  • react-transition-group:过渡效果。
  • jspdf:导出 PDF。
  • qrcode.react:二维码展示。

依赖的当前版本以 genshin-novel-reader-web/package.json 为准。