70 lines
2.3 KiB
Markdown
70 lines
2.3 KiB
Markdown
|
# 加载动画系统清理与文本效果修复
|
|||
|
|
|
|||
|
|
## 1. 概述
|
|||
|
|
|
|||
|
|
清理旧的加载动画代码，统一使用新的 `PageLoader` 系统，并修复文章中文本特效样式不显示的问题。
|
|||
|
|
|
|||
|
|
## 2. 背景
|
|||
|
|
|
|||
|
|
在之前的优化中：
|
|||
|
|
- 创建了全新的 `PageLoader` 模块（SVG 圆环进度、智能进度算法、骨架屏）
|
|||
|
|
- 移除了向后兼容函数 `showLoadingOverlay()` 和 `hideLoadingOverlay()`
|
|||
|
|
- 修复了黑幕（`.heimu`）样式在文章中不显示的问题
|
|||
|
|
|
|||
|
|
但仍存在以下问题：
|
|||
|
|
1. `argontheme.js` 第 4970-5040 行存在旧的加载动画代码，使用旧的 `article-loading-overlay` ID
|
|||
|
|
2. 其他文本效果（`color-curtain`、`text-blur`、`huhua`）可能在文章中不显示
|
|||
|
|
3. 代码冗余，维护困难
|
|||
|
|
|
|||
|
|
## 3. 用户故事
|
|||
|
|
|
|||
|
|
### 3.1 作为开发者
|
|||
|
|
我希望代码库中只有一套加载动画系统，这样：
|
|||
|
|
- 代码更易维护
|
|||
|
|
- 避免新旧系统冲突
|
|||
|
|
- 减少代码体积
|
|||
|
|
|
|||
|
|
### 3.2 作为用户
|
|||
|
|
我希望在文章中使用的所有文本特效都能正常显示，包括：
|
|||
|
|
- 彩色黑幕（`color-curtain`）
|
|||
|
|
- 模糊文本（`text-blur`）
|
|||
|
|
- 划掉文本（`huhua`）
|
|||
|
|
|
|||
|
|
## 4. 验收标准
|
|||
|
|
|
|||
|
|
### 4.1 清理旧加载动画代码
|
|||
|
|
- [ ] 移除 `argontheme.js` 中第 4970-5040 行的旧加载动画代码
|
|||
|
|
- [ ] 确保所有加载动画调用都使用新的 `PageLoader` 系统
|
|||
|
|
- [ ] PJAX 加载动画正常工作
|
|||
|
|
- [ ] 页面初始加载动画正常工作
|
|||
|
|
|
|||
|
|
### 4.2 修复文本效果样式
|
|||
|
|
- [ ] `color-curtain` 在文章中正常显示和交互
|
|||
|
|
- [ ] `text-blur` 在文章中正常显示和交互
|
|||
|
|
- [ ] `huhua` 在文章中正常显示和交互
|
|||
|
|
- [ ] 夜间模式下所有文本效果颜色正确
|
|||
|
|
|
|||
|
|
### 4.3 代码质量
|
|||
|
|
- [ ] 遵循项目代码规范（Tab 缩进、单引号、严格相等）
|
|||
|
|
- [ ] 添加清晰的注释
|
|||
|
|
- [ ] 无控制台错误或警告
|
|||
|
|
|
|||
|
|
## 5. 技术约束
|
|||
|
|
|
|||
|
|
- 必须保持与现有 `PageLoader` 系统的兼容性
|
|||
|
|
- 不能破坏 PJAX 功能
|
|||
|
|
- 样式修复需要参考黑幕样式的修复方式（添加 `article .entry-content` 和 `.article-content` 选择器）
|
|||
|
|
- 遵循 Argon 主题代码规范
|
|||
|
|
|
|||
|
|
## 6. 非功能性需求
|
|||
|
|
|
|||
|
|
- 加载动画性能不能下降
|
|||
|
|
- 文本效果不能影响页面渲染性能
|
|||
|
|
- 代码体积应该减少（移除冗余代码）
|
|||
|
|
|
|||
|
|
## 7. 排除范围
|
|||
|
|
|
|||
|
|
- 不涉及其他页面元素的样式修复
|
|||
|
|
- 不涉及新功能开发
|
|||
|
|
- 不涉及其他 JavaScript 模块的重构
|