可缩放的 SwiftUI 图片预览器：优雅呈现图像的 10 个步骤

2023-09-05 06:16:26

SwiftUI 实现缩放图片预览器的 10 个步骤

在 SwiftUI 的推动下，iOS 开发界正在逐渐从 UIKit 转向 SwiftUI。为了响应这一趋势，本文将带您领略如何利用 SwiftUI 的强大功能，打造一个精美的可缩放图片预览器。本教程包含 10 个清晰易懂的步骤，循序渐进地指导您完成整个开发过程。

1. 创建 SwiftUI 项目

首先，在 Xcode 中创建一个新的 SwiftUI 项目，并将其命名为 "ImagePreviewer"。

2. 添加图像

在 Assets.xcassets 中，添加您要预览的图像。本教程中，我们将使用一张名为 "sample-image.jpg" 的示例图像。

3. 创建 ImagePreview 视图

在 ContentView.swift 中，创建一个新的 SwiftUI 视图，称为 ImagePreview。此视图将负责显示和缩放图像。

struct ImagePreview: View {
    @State private var scale: CGFloat = 1.0
    @State private var offset: CGSize = .zero
    
    var body: some View {
        Image("sample-image")
            .resizable()
            .scaleEffect(scale)
            .offset(offset)
            .gesture(
                MagnificationGesture()
                    .onChanged { value in
                        scale = value
                    }
                DragGesture()
                    .onChanged { value in
                        offset = value.translation
                    }
            )
    }
}

4. 缩放和拖动

在 ImagePreview 视图中，我们使用 scaleEffect 和 offset modifiers 来实现缩放和拖动功能。MagnificationGesture 和 DragGesture 允许用户通过手势进行交互。

5. 添加边框

为了突出显示缩放后的图像，我们可以添加一个边框。在 ImagePreview 视图中，添加如下代码：

.overlay(
    Rectangle()
        .stroke(Color.white, lineWidth: 2)
)

6. 添加手柄

为了更方便地缩放和拖动图像，我们可以添加手柄。在 ImagePreview 视图中，添加如下代码：

.overlay(
    ZStack {
        // 左上角手柄
        Circle()
            .frame(width: 30, height: 30)
            .foregroundColor(.white)
            .position(x: 15, y: 15)
            .gesture(
                DragGesture()
                    .onChanged { value in
                        offset.width -= value.translation.width
                        offset.height -= value.translation.height
                        scale -= value.translation.width / 100
                    }
            )
        
        // 右下角手柄
        Circle()
            .frame(width: 30, height: 30)
            .foregroundColor(.white)
            .position(x: UIScreen.main.bounds.width - 15, y: UIScreen.main.bounds.height - 15)
            .gesture(
                DragGesture()
                    .onChanged { value in
                        offset.width += value.translation.width
                        offset.height += value.translation.height
                        scale += value.translation.width / 100
                    }
            )
    }
)

7. 限制缩放和拖动

为了防止图像被过度缩放或拖出视图，我们可以设置限制。在 ImagePreview 视图中，添加如下代码：

.scaleEffect(scale < 1 ? 1 : scale, anchor: .center)
.offset(offset.width > 0 ? 0 : offset.width, offset.height > 0 ? 0 : offset.height)

8. 添加背景

为了改善图像的可视性，我们可以添加一个背景。在 ImagePreview 视图中，添加如下代码：

.background(Color.black)

9. 导航到预览器

在 ContentView 视图中，添加一个 NavigationLink，以便从主视图导航到图像预览器。

struct ContentView: View {
    var body: some View {
        NavigationView {
            NavigationLink(destination: ImagePreview()) {
                Text("Open Image Previewer")
            }
        }
    }
}