nanhaoluo
db24ca2043
- 修复侧边抽屉文章目录在 PJAX 页面切换后不重新初始化的问题 - 优化涟漪点击效果：将结束动画从 scale 收缩改为 opacity 淡出 - 添加暗黑/明亮模式切换过渡动画（250ms 平滑过渡） - 优化分享面板动画：添加退出时的反向错落延迟 - 添加分享面板移动端响应式适配，防止视口溢出
4.7 KiB
4.7 KiB
Requirements Document
Introduction
本文档定义了 Argon 主题隐私政策页面移动端 UI 问题的修复需求。该页面未正确应用全局样式设置，导致侧边抽屉栏功能异常（文章目录、多邻国连胜、点击动画、主题切换）以及文章页面转发功能的动画问题。
Glossary
- Sidebar_Drawer: 移动端侧边折叠抽屉组件，包含文章目录、多邻国连胜记录、主题切换等功能
- TOC_Generator: 文章目录生成器，根据页面标题元素（h1-h6）自动生成导航目录
- Duolingo_Streak: 多邻国连胜记录显示组件，展示用户的学习连胜天数
- Ripple_Effect: Material Design 风格的涟漪点击效果动画
- Theme_Switcher: 暗黑/明亮模式切换组件
- Share_Panel: 文章分享面板组件，提供多种社交平台分享选项
Requirements
Requirement 1: 侧边抽屉文章目录生成
User Story: As a 移动端用户, I want 在侧边抽屉中看到正常的文章目录, so that 我可以快速导航到文章的各个章节。
Acceptance Criteria
- WHEN 用户在隐私政策页面打开侧边抽屉, THE TOC_Generator SHALL 正确解析页面中的标题元素（h1-h6）并生成目录
- WHEN 页面包含多级标题, THE TOC_Generator SHALL 以层级缩进方式显示目录结构
- WHEN 用户点击目录项, THE Sidebar_Drawer SHALL 平滑滚动到对应的标题位置
- IF 页面没有可识别的标题元素, THEN THE TOC_Generator SHALL 显示"无目录"提示而非空白
Requirement 2: 多邻国连胜记录显示
User Story: As a 用户, I want 在侧边抽屉中看到多邻国连胜记录, so that 我可以了解博主的学习进度。
Acceptance Criteria
- WHEN 用户打开侧边抽屉且多邻国功能已启用, THE Duolingo_Streak SHALL 正确显示连胜天数
- WHEN 多邻国 API 请求成功, THE Duolingo_Streak SHALL 显示用户头像、用户名和连胜火焰图标
- IF 多邻国 API 请求失败, THEN THE Duolingo_Streak SHALL 显示友好的错误提示或隐藏该组件
- THE Duolingo_Streak SHALL 在隐私政策页面与其他页面保持一致的显示效果
Requirement 3: 涟漪点击效果优化
User Story: As a 用户, I want 点击按钮时看到自然的涟漪效果, so that 交互反馈更加流畅自然。
Acceptance Criteria
- WHEN 用户点击侧边抽屉中的按钮, THE Ripple_Effect SHALL 从点击位置向外扩散
- WHEN 涟漪动画结束, THE Ripple_Effect SHALL 以淡出方式消失，而非倒放收缩
- THE Ripple_Effect SHALL 使用 opacity 淡出而非 scale 收缩作为结束动画
- THE Ripple_Effect SHALL 将动画时长控制在 300-400ms 范围内
Requirement 4: 暗黑/明亮模式切换流畅性
User Story: As a 用户, I want 暗黑和明亮模式之间的切换更加流畅, so that 视觉体验不会突兀。
Acceptance Criteria
- WHEN 用户切换主题模式, THE Theme_Switcher SHALL 使用平滑的颜色过渡动画
- THE Theme_Switcher SHALL 对所有颜色变化使用 CSS transition，时长为 200-300ms
- THE Theme_Switcher SHALL 确保背景色、文字色、边框色同步过渡
- THE Theme_Switcher SHALL 避免出现闪烁或跳变效果
Requirement 5: 转发按钮退出动画优化
User Story: As a 用户, I want 转发面板关闭时有正确的退出动画, so that 交互体验更加自然。
Acceptance Criteria
- WHEN 用户关闭转发面板, THE Share_Panel SHALL 使用向上滑出的退出动画
- THE Share_Panel SHALL 退出动画方向与进入动画方向一致（上滑进入则上滑退出）
- THE Share_Panel SHALL 退出动画不应出现歪斜或偏移
- THE Share_Panel SHALL 退出动画时长与进入动画时长一致
Requirement 6: 转发选项溢出修复
User Story: As a 用户, I want 转发选项完整显示在窗口内, so that 我可以看到并点击所有分享选项。
Acceptance Criteria
- THE Share_Panel SHALL 所有分享选项完整显示在视口范围内
- WHEN 分享选项数量较多, THE Share_Panel SHALL 使用滚动或换行方式适配
- THE Share_Panel SHALL 在各种屏幕尺寸下保持选项可见性
- THE Share_Panel SHALL 与屏幕边缘保持适当的安全边距
Requirement 7: 转发动画流畅性优化
User Story: As a 用户, I want 转发面板的动画更加流畅顺滑, so that 整体交互体验更好。
Acceptance Criteria
- THE Share_Panel SHALL 使用 GPU 加速属性（transform, opacity）进行动画
- THE Share_Panel SHALL 动画使用合适的缓动函数（ease-out 或 cubic-bezier）
- THE Share_Panel SHALL 避免动画过程中出现抖动或卡顿
- THE Share_Panel SHALL 分享图标按钮使用错落有致的出现动画