前端技术
前端技术点¶
前端框架 React¶
本项目使用 React 18 构建用户界面,并根据状态变化更新视图。
UI 组件库¶
项目早期使用 Reactstrap 作为 UI 组件库,并使用 Bootstrap 样式。以下是当时记录的版本范围,不一定代表当前依赖版本:
"bootstrap": "^5.2.3",
"reactstrap": "^9.1.5",
reactstrap 组件库和 bootstrap 组件库样式类似,且和 react 框架结合良好,日常使用较多,API 和配置较熟悉,所以选择这个作为组件库,减少了从零开始写 UI 组件消耗的时间成本。
状态管理¶
1、小说内容数据:支持本地上传,或者从服务器搜索加载两种模式。离线模式可以本地上传,上传后以 state 形式保存在 app 中。在线模式中,支持从服务器中查找小说并加载,可以把本地小说上传到服务器。
2、界面样式数据:支持自定义背景图片,背景色,字号,字体,文字颜色,行间隔,保存本地在浏览器存储中。
3、阅读模式数据:模式分为全屏模式、分页模式、章节模式,适合不同类型的小说或者阅读者的需求,界面渲染不同模式的组件。
项目早期使用 React state 管理状态。1.7 版本开始引入 React Redux 管理跨组件共享状态;局部状态仍由组件自身管理。具体示例见《前端状态管理》。
其他工具库说明¶
项目使用过以下第三方库(列表为技术文档记录,不保证与当前依赖完全一致):
axios:发送网络请求
classnames:组合 CSS 类名
deep-copy:深拷贝对象
is-hotkey:判断键盘快捷键
lodash:常用工具函数
react-color:颜色选择器
react-router-dom:浏览器路由
react-scripts:React 项目开发脚本
react-select:选择框组件
react-sweet-progress:进度条组件
react-transition-group:过渡动画
react-icons:图标
早期项目使用 Create React App;Webpack 由 react-scripts 集成管理。
// 以下为历史开发依赖示例,并非都属于 Babel 转换器。
Babel:@babel/cli、@babel/core、@babel/node、@babel/preset-env 等
Lint:eslint、eslint-config-airbnb-base、eslint-plugin-import
其他:babel-jest、babel-loader、form-data、jsdoc-to-markdown、localforage、match-sorter、multer、sort-by、web-vitals