Files
argon-theme/.kiro/specs/loading-animation-cleanup/requirements.md
2026-03-03 14:58:17 +08:00

2.3 KiB
Raw Blame History

加载动画系统清理与文本效果修复

1. 概述

清理旧的加载动画代码,统一使用新的 PageLoader 系统,并修复文章中文本特效样式不显示的问题。

2. 背景

在之前的优化中:

  • 创建了全新的 PageLoader 模块SVG 圆环进度、智能进度算法、骨架屏)
  • 移除了向后兼容函数 showLoadingOverlay()hideLoadingOverlay()
  • 修复了黑幕(.heimu)样式在文章中不显示的问题

但仍存在以下问题:

  1. argontheme.js 第 4970-5040 行存在旧的加载动画代码,使用旧的 article-loading-overlay ID
  2. 其他文本效果(color-curtaintext-blurhuhua)可能在文章中不显示
  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 模块的重构