前端状态管理
前端状态管理¶
当前方案¶
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 为准。