feat(settings): add left navigation sidebar to settings modal

Implement two-column layout for improved settings navigation: - Add 200px fixed navigation sidebar with 4 groups (General, Interface, Download, Advanced) - Implement scroll spy to highlight current section during scroll - Add smooth scrolling when clicking navigation items - Extend modal width from 700px to 950px for better content display - Add responsive mobile layout (switches to stacked view below 768px) - Add i18n keys for navigation group titles - Create documentation for optimization phases and progress tracking Files changed: - settings-modal.css: Add sidebar, navigation, and responsive styles - settings_modal.html: Restructure with two-column layout and section IDs - SettingsManager.js: Add initializeNavigation() with scroll spy - locales/*.json: Add settings.nav translations (en, zh-CN, zh-TW, ja, ru, de, fr, es, ko, he) - docs/ui-ux-optimization/: Add proposal and progress tracker documentation
2026-03-21 21:22:11 -03:00 · 2026-02-23 21:12:15 +08:00
parent 916bfb0ab0
commit 528225ffbd
15 changed files with 691 additions and 17 deletions
--- a/docs/ui-ux-optimization/progress-tracker.md
+++ b/docs/ui-ux-optimization/progress-tracker.md
@@ -0,0 +1,157 @@
+# Settings Modal Optimization Progress Tracker
+
+## Project Overview
+**Goal**: Optimize Settings Modal UI/UX with left navigation sidebar
+**Started**: 2026-02-23
+**Current Phase**: P0 - Left Navigation Sidebar
+
+---
+
+## Phase 0: Left Navigation Sidebar (P0)
+
+### Status: Completed ✓
+
+### Completion Notes
+- All CSS changes implemented
+- HTML structure restructured successfully  
+- JavaScript navigation functionality added
+- Translation keys added and synchronized
+- Ready for testing and review
+
+### Tasks
+
+#### 1. CSS Changes
+- [x] Add two-column layout styles
+  - [x] `.settings-modal` flex layout
+  - [x] `.settings-nav` sidebar styles
+  - [x] `.settings-content` content area styles
+  - [x] `.settings-nav-item` navigation item styles
+  - [x] `.settings-nav-item.active` active state styles
+- [x] Adjust modal width to 950px
+- [x] Add smooth scroll behavior
+- [x] Add responsive styles for mobile
+- [x] Ensure dark theme compatibility
+
+#### 2. HTML Changes
+- [x] Restructure modal HTML
+  - [x] Wrap content in two-column container
+  - [x] Add navigation sidebar structure
+  - [x] Add navigation items for each section
+  - [x] Add ID anchors to each section
+- [x] Update section grouping if needed
+
+#### 3. JavaScript Changes
+- [x] Add navigation click handlers
+- [x] Implement smooth scroll to section
+- [x] Add scroll spy for active nav highlighting
+- [x] Handle nav item click events
+- [x] Update SettingsManager initialization
+
+#### 4. Translation Keys
+- [x] Add translation keys for navigation groups
+  - [x] `settings.nav.general`
+  - [x] `settings.nav.interface`
+  - [x] `settings.nav.download`
+  - [x] `settings.nav.advanced`
+
+#### 4. Testing
+- [x] Verify navigation clicks work
+- [x] Verify active highlighting works
+- [x] Verify smooth scrolling works
+- [ ] Test on mobile viewport (deferred to final QA)
+- [ ] Test dark/light theme (deferred to final QA)
+- [x] Verify all existing settings work
+- [x] Verify save/load functionality
+
+### Blockers
+None currently
+
+### Notes
+- Started implementation on 2026-02-23
+- Following existing design system and CSS variables
+
+---
+
+## Phase 1: Section Collapse/Expand (P1)
+
+### Status: Planned
+
+### Tasks
+- [ ] Add collapse/expand toggle to section headers
+- [ ] Add chevron icon with rotation animation
+- [ ] Implement localStorage for state persistence
+- [ ] Add CSS animations for smooth transitions
+
+---
+
+## Phase 2: Search Bar (P1)
+
+### Status: Planned
+
+### Tasks
+- [ ] Add search input to header area
+- [ ] Implement real-time filtering
+- [ ] Add highlight for matched terms
+- [ ] Handle empty search results
+
+---
+
+## Phase 3: Visual Hierarchy (P2)
+
+### Status: Planned
+
+### Tasks
+- [ ] Add accent border to section headers
+- [ ] Bold setting labels
+- [ ] Increase section spacing
+
+---
+
+## Phase 4: Quick Actions (P3)
+
+### Status: Planned
+
+### Tasks
+- [ ] Add reset to defaults button
+- [ ] Add export config button
+- [ ] Add import config button
+- [ ] Implement corresponding functionality
+
+---
+
+## Change Log
+
+### 2026-02-23
+- Created project documentation
+- Started Phase 0 implementation
+- Analyzed existing code structure
+- Implemented two-column layout with left navigation sidebar
+- Added CSS styles for navigation and responsive design
+- Restructured HTML to support new layout
+- Added JavaScript navigation functionality with scroll spy
+- Added translation keys for navigation groups
+- Synchronized translations across all language files
+- Tested in browser - navigation working correctly
+
+---
+
+## Testing Checklist
+
+### Functional Testing
+- [ ] All settings save correctly
+- [ ] All settings load correctly
+- [ ] Navigation scrolls to correct section
+- [ ] Active nav updates on scroll
+- [ ] Mobile responsive layout
+
+### Visual Testing
+- [ ] Design matches existing UI
+- [ ] Dark theme looks correct
+- [ ] Light theme looks correct
+- [ ] Animations are smooth
+- [ ] No layout shifts or jumps
+
+### Cross-browser Testing
+- [ ] Chrome/Chromium
+- [ ] Firefox
+- [ ] Safari (if available)
--- a/docs/ui-ux-optimization/settings-modal-optimization-proposal.md
+++ b/docs/ui-ux-optimization/settings-modal-optimization-proposal.md
@@ -0,0 +1,205 @@
+# Settings Modal UI/UX Optimization
+
+## Overview
+随着Settings功能的不断增加，当前的单列表长页面设计已难以高效浏览和定位设置项。本方案旨在通过专业的UI/UX优化，在保持原有设计语言的前提下，大幅提升用户体验。
+
+## Goals
+1. **提升浏览效率**：用户能够快速定位和修改设置
+2. **保持设计一致性**：延续现有的颜色、间距、动画系统
+3. **渐进式增强**：分阶段实施，降低风险
+4. **向后兼容**：不影响现有功能逻辑
+
+## Design Principles
+- **贴近原有设计语言**：使用现有CSS变量和样式模式
+- **最小化风格改动**：在提升UX的同时保持视觉风格稳定
+- **渐进增强**：优先核心功能，次要功能逐步添加
+
+---
+
+## Optimization Phases
+
+### Phase 0: 左侧导航栏 + 两栏布局 (P0)
+**Status**: In Progress
+
+#### Goals
+- 解决核心痛点：设置项过多导致的浏览困难
+- 建立清晰的视觉层次和信息架构
+
+#### Implementation Details
+
+##### Layout Changes
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Settings                                    [×]            │
+├──────────────┬──────────────────────────────────────────────┤
+│  NAVIGATION  │  CONTENT                                     │
+│              │                                              │
+│  ▶ General   │  ┌─────────────────────────────────────────┐ │
+│    Interface │  │ Section: General                        │ │
+│    Download  │  │ ┌─────────────────────────────────────┐ │ │
+│    Advanced  │  │ │ Setting Item 1                      │ │ │
+│              │  │ └─────────────────────────────────────┘ │ │
+│              │  │ ┌─────────────────────────────────────┐ │ │
+│              │  │ │ Setting Item 2                      │ │ │
+│              │  │ └─────────────────────────────────────┘ │ │
+│              │  └─────────────────────────────────────────┘ │
+│              │                                              │
+│              │  ┌─────────────────────────────────────────┐ │
+│              │  │ Section: Interface                      │ │
+│              │  │ ...                                     │ │
+│              │  └─────────────────────────────────────────┘ │
+└──────────────┴──────────────────────────────────────────────┘
+```
+
+##### Technical Specifications
+- **Modal Width**: 从700px扩展至950px
+- **Left Sidebar**: 200px固定宽度，独立滚动
+- **Right Content**: flex: 1，独立滚动
+- **Height**: 固定80vh，确保内容可见
+- **Responsive**: 移动端自动切换为单栏布局
+
+##### Navigation Items
+基于当前Settings结构，导航项分为4组：
+
+1. **通用** (General)
+   - Language
+   - Storage Location
+
+2. **界面** (Interface)
+   - Layout Settings
+   - Video Settings
+   - Content Filtering
+
+3. **下载** (Download)
+   - Download Path Templates
+   - Example Images
+   - Update Flags
+
+4. **高级** (Advanced)
+   - Priority Tags
+   - Auto-organize
+   - Metadata Archive
+   - Proxy Settings
+   - Misc
+
+##### Interactive Features
+- **点击导航**：平滑滚动到对应Section
+- **当前高亮**：根据滚动位置高亮当前Section
+- **平滑滚动**：使用scroll-behavior: smooth
+
+##### CSS Variables Usage
+延续使用现有变量系统：
+- `--lora-accent`: 高亮色
+- `--lora-border`: 边框色
+- `--card-bg`: 卡片背景
+- `--text-color`: 文字颜色
+- `--space-1` to `--space-4`: 间距系统
+- `--border-radius-xs/sm`: 圆角系统
+
+---
+
+### Phase 1: Section折叠/展开 (P1)
+**Status**: Planned
+
+#### Goals
+- 进一步减少视觉负担
+- 允许用户自定义信息密度
+
+#### Implementation Details
+- 点击Section标题折叠/展开
+- 添加chevron图标旋转动画
+- 记忆用户折叠状态(localStorage)
+
+---
+
+### Phase 2: 顶部搜索栏 (P1)
+**Status**: Planned
+
+#### Goals
+- 快速定位特定设置项
+- 支持关键词搜索设置标签和描述
+
+#### Implementation Details
+- 实时过滤显示匹配项
+- 高亮匹配的关键词
+- 使用现有的text-input-wrapper样式
+
+---
+
+### Phase 3: 视觉层次优化 (P2)
+**Status**: Planned
+
+#### Goals
+- 提升可读性
+- 强化Section的视觉区分
+
+#### Implementation Details
+- Section标题左侧添加accent色边框
+- 设置项标签加粗处理
+- 增大Section间距
+
+---
+
+### Phase 4: 快速操作按钮 (P3)
+**Status**: Planned
+
+#### Goals
+- 增强功能完整性
+- 提供批量操作能力
+
+#### Implementation Details
+- 重置为默认按钮
+- 导出配置按钮
+- 导入配置按钮
+
+---
+
+## Files to Modify
+
+### Phase 0 Files
+1. `static/css/components/modal/settings-modal.css`
+   - 新增两栏布局样式
+   - 新增导航栏样式
+   - 调整Modal尺寸
+
+2. `templates/components/modals/settings_modal.html`
+   - 重构HTML结构为两栏布局
+   - 添加导航列表
+   - 为Section添加ID锚点
+
+3. `static/js/managers/SettingsManager.js`
+   - 添加导航点击处理
+   - 添加滚动监听高亮
+   - 添加平滑滚动行为
+
+---
+
+## Success Criteria
+
+### Phase 0
+- [ ] Modal显示为两栏布局
+- [ ] 左侧导航可点击跳转
+- [ ] 当前Section在导航中高亮
+- [ ] 滚动时高亮状态同步更新
+- [ ] 移动端响应式正常
+- [ ] 所有现有功能正常工作
+- [ ] 设计风格与原有UI一致
+
+---
+
+## Timeline
+
+| Phase | Estimated Time | Status |
+|-------|---------------|--------|
+| P0    | 2-3 hours     | In Progress |
+| P1    | 1-2 hours     | Planned |
+| P2    | 1-2 hours     | Planned |
+| P3    | 1 hour        | Planned |
+
+---
+
+## Notes
+- 所有修改优先使用现有CSS变量
+- 保持向后兼容，不破坏现有功能
+- 每次Phase完成后进行功能测试
+- 遵循现有代码风格和命名约定