Skip to content

前端状态管理

前端状态管理

当前方案

genshin-novel-reader-web 使用 React hooks 管理阅读器状态,不使用 Redux。顶层 App 持有文件列表、当前文件、阅读样式、阅读位置、面板显示状态、在线 API 和用户信息。需要跨导航区、阅读区和设置区使用的 API、用户及移动端信息由 AppContext 提供。

局部对话框、Tabs 等交互状态留在各自组件中。状态更新通过 React setter 完成,避免直接修改数组或对象后期待 React 自动刷新。

持久化边界

  • 阅读器样式:通过 localforage 保存和加载。
  • 当前文件列表、选中位置和阅读进度:当前运行期间保存在内存,不会自动跨页面刷新持久化。
  • 在线书架:由 Node API 和数据库保存,登录后从服务端加载。
  • 登录令牌、用户名和语言:由 Cookie 保存,不属于 React Context 的持久化状态。

示例

const [files, setFiles] = useState([]);

function addFile(file) {
  setFiles((currentFiles) => [...currentFiles, file]);
}

添加文件时基于前一个状态创建新数组,避免原地修改 files。共享状态较复杂时可评估 Context 或其他方案,但当前实现的文档应以 hooks/Context 为准。