4.8 KiB

Raw Blame History Unescape Escape

HistoryView 导航方式修改说明

概述

本次更新修改了 HistoryView.swift，将其中的二维码详情页面展示方式从 .sheet 模态展示改为 NavigationLink 页面导航，与 ScannerView 保持一致，提供更统一的用户体验。

主要变更

1. 移除 Overlay 导航按钮

删除了页面底部的橙色"查看二维码详情"按钮
简化了界面，减少了视觉干扰

2. 修改 HistoryItemRow 导航方式

从 .sheet 模态展示改为 NavigationLink 页面导航
移除了 @State private var showingDetail 状态变量
移除了 .onTapGesture 和 .sheet 修饰符

3. 使用背景 NavigationLink

在 HistoryItemRow 的 .background 中添加 NavigationLink
使用 EmptyView() 作为标签，保持视觉上的透明
只有二维码类型的项目才会显示导航链接

技术实现

之前的实现（Sheet 方式）

@State private var showingDetail = false

.onTapGesture {
    if item.dataType == DataType.qrcode.rawValue {
        showingDetail = true
    }
}
.sheet(isPresented: $showingDetail) {
    if item.dataType == DataType.qrcode.rawValue {
        NavigationView {
            QRCodeDetailView(historyItem: item)
        }
    }
}

现在的实现（NavigationLink 方式）

.background(
    // 为二维码类型添加导航链接
    Group {
        if item.dataType == DataType.qrcode.rawValue {
            NavigationLink(
                destination: QRCodeDetailView(historyItem: item),
                label: { EmptyView() }
            )
        }
    }
)

用户体验改进

1. 统一的导航体验

与 ScannerView 的导航方式保持一致
用户在不同页面间切换时体验更加一致

2. 更直观的交互

点击二维码历史记录项直接导航到详情页
无需额外的按钮或手势识别

3. 更流畅的页面切换

使用原生导航栈，支持返回手势
页面切换动画更加自然

功能保持

1. 导航条件

仍然只有二维码类型的项目才能导航到详情页
条形码项目保持原有的只读状态

2. 详情页功能

详情页的所有功能保持不变
包括收藏、复制、分享等操作

3. 返回行为

从详情页返回时回到历史记录列表
保持用户的浏览上下文

代码优化

1. 状态管理简化

移除了不必要的状态变量
减少了状态管理的复杂性

2. 事件处理简化

移除了手动的事件处理逻辑
依赖 SwiftUI 的自动导航处理

3. 性能提升

减少了状态更新和重绘
更高效的导航处理

文件修改

主要文件：MyQrCode/Views/HistoryView.swift
移除内容：
- .overlay 修饰符和其中的导航按钮
- @State private var showingDetail
- .onTapGesture 修饰符
- .sheet 修饰符
新增内容：
- .background 修饰符中的 NavigationLink

测试建议

1. 导航功能测试

测试点击二维码历史记录项是否正确导航
验证条形码项目是否无法导航
检查返回按钮和手势是否正常工作

2. 界面一致性测试

验证与 ScannerView 的导航体验是否一致
检查页面切换动画是否流畅

3. 功能完整性测试

确保详情页的所有功能正常工作
验证历史记录的其他功能不受影响

注意事项

1. 导航栈管理

确保导航栈的正确管理
避免导航栈过深的问题

2. 性能考虑

大量历史记录时导航链接的性能影响
监控内存使用情况

3. 用户体验

确保导航行为符合用户预期
保持界面的简洁性

向后兼容性

不影响现有的历史记录功能
不影响条形码项目的显示
不影响其他页面的功能

总结

本次修改成功将 HistoryView 的导航方式从 .sheet 改为 NavigationLink，并解决了双重导航栈问题，实现了：

统一的用户体验：与 ScannerView 保持一致的导航方式
简化的代码结构：移除了复杂的状态管理和事件处理
更好的性能：减少了不必要的状态更新和重绘
更流畅的交互：使用原生导航栈，支持返回手势
修复双重返回按钮：移除 HistoryView 内部的 NavigationView，避免导航栈嵌套

导航层级修复

修复前的导航层级：

ContentView (NavigationView)
  └── HistoryView (NavigationView) <- 导致双重导航栈
      └── QRCodeDetailView

修复后的导航层级：

ContentView (NavigationView)
  └── HistoryView (直接使用外层导航)
      └── QRCodeDetailView

这些改进使得整个应用的导航体验更加一致和流畅，彻底解决了双重返回按钮的问题，提升了用户的使用体验。

4.8 KiB Raw Blame History Unescape Escape