001project_wildgrowth/ios/WildGrowth/字号优化说明.md

4.0 KiB
Raw Blame History

字号优化说明 - 2026年2月

📊 优化原则

核心理念:调整略小的字号至合理层级,保持已经合理的字号不变,确保 UI 一致性和良好的阅读体验。


已调整的字号(略小 → 合理)

1. 播放器正文区域 (ContentBlockBuilder.swift)

元素 原字号 新字号 调整理由
正文 17pt 19pt 提升长文阅读舒适度,符合阅读类应用标准
主标题 28pt 30pt 与正文字号成比例协调
H1 标题 24pt 26pt 与正文字号成比例协调
H2 标题 20pt 22pt 与正文字号成比例协调
高亮文本 18pt 20pt 与正文字号成比例协调
行间距 9pt 10pt 保持黄金比例 1.72x (19×1.72≈32.7)
段落间距 22pt 24pt 随正文字号增大

影响范围

  • VerticalScreenPlayerView - 播放器正文渲染
  • ArticleRichTextViewRepresentable - 富文本显示

2. 地图页 (MapView.swift)

元素 原字号 新字号 调整理由
章节标题 20pt 22pt 增强区块分割感,提升层级清晰度
课程标题 16pt 17pt 略微偏小,提升至标准阅读字号
进度信息 caption (11-12pt) label (13pt) caption 过小,调整至 label 防止难以阅读

影响范围

  • VerticalListLayout - 章节标题
  • LessonListRow - 课程条目标题
  • AtmosphericHeaderView - 悬浮卡片进度信息

🔒 保持不变的合理字号

以下字号已处于最佳层级,无需调整

区域 元素 字号 评价
MapView 头部大标题 32pt 适当,具有冲击力
ProfileView 统计数字 32pt 适当,数据展示清晰
DiscoveryView 运营位标题 22pt 适当,信息层级合理
GrowthTopBar 导航标签 18pt (active) / 16pt (inactive) 适当,选中态明显
DesignSystem 各类按钮与标签 13pt-16pt 适当,符合 iOS 设计规范
ProfileView 笔记入口卡片 16pt (title) / 13pt (label) 适当,层级清晰
MapView 悬浮卡片按钮 15pt 适当,易于点击

📈 字号层级体系(完整)

层级 字号范围 用途 示例
Display 30-32pt 页面主标题、数据展示 播放器主标题 (30pt)、统计数字 (32pt)
H1 26-28pt 一级标题 播放器 H1 (26pt)
H2 22-24pt 二级标题、模块标题 地图章节标题 (22pt)、发现页标题 (22pt)
H3 18-20pt 三级标题、Tab 标签 播放器高亮 (20pt)、Tab Bar 选中 (18pt)
Body 17-19pt 正文、列表项 播放器正文 (19pt)、地图课程标题 (17pt)
Label 13-16pt 辅助信息、按钮 进度信息 (13pt)、按钮文字 (16pt)
Caption 11-12pt 极小辅助文本(谨慎使用) ⚠️ 已基本避免使用

🎯 设计原则总结

  1. 阅读优先正文区域字号要足够大19pt确保长时间阅读不疲劳
  2. 比例协调:标题与正文成比例缩放,保持视觉节奏
  3. 层级清晰:字号差异明显(至少 2-4pt确保信息层级清晰
  4. 避免过小:尽量避免使用 caption11-12pt最小使用 label13pt
  5. 符合规范:参考 Apple HIG 和主流阅读应用(微信读书、即刻等)

📝 后续建议

  1. 播放器体验:可考虑根据用户反馈,提供字号调节功能(小、中、大)
  2. 无障碍支持确保所有文字支持动态字体Dynamic Type
  3. 对比测试:可通过 A/B 测试验证字号调整对阅读完成率的影响
  4. 一致性检查:定期审查新增页面,确保字号符合设计系统

优化完成日期2026年2月1日
Git 提交记录2a44791 - 优化字号层级,提升阅读体验