在 SwiftUI 2025 中使用環形進度條

SwiftUI 是 Apple 在 WWDC 2019 推出的創新框架，讓開發者能夠快速開發原生的 iOS、macOS、tvOS 和 watchOS 應用程式。隨著 SwiftUI 的持續更新，我們在這裡將介紹如何在 SwiftUI 中使用環形進度條，並提供 2025 最新語法及最佳實踐。

環形進度條概述

環形進度條（Circular Progress View）可以有效地顯示任務的進度，讓使用者更直觀地了解當前狀態。在 SwiftUI 中，我們可以輕鬆地創建和自訂這個元件。

如何創建環形進度條

在 SwiftUI 中，使用 CircularProgressView 來創建環形進度條。這個元件接受一個 Double 型別的參數，表示進度的比例。例如，以下程式碼創建了一個進度為 50% 的環形進度條：

CircularProgressView(progress: 0.5)

自訂環形進度條的外觀

使用 CircularProgressViewStyle 可以自訂環形進度條的外觀和行為。以下是設定環形進度條顏色的範例：

CircularProgressView(progress: 0.5)
    .progressViewStyle(CircularProgressViewStyle(tint: .red))

此外，你還可以自訂環形進度條的動畫時間，以下程式碼將動畫時間設為 1 秒：

CircularProgressView(progress: 0.5)
    .progressViewStyle(CircularProgressViewStyle(animationDuration: 1.0))

環形進度條的實作範例

以下是一個完整的 SwiftUI 實作範例，展示如何在視圖中使用環形進度條：

struct ContentView: View {
    @State private var progress: Double = 0.0

    var body: some View {
        VStack {
            CircularProgressView(progress: progress)
                .progressViewStyle(CircularProgressViewStyle(tint: .blue))
                .frame(width: 100, height: 100)

            Button("Increase Progress") {
                withAnimation {
                    progress = min(progress + 0.1, 1.0)
                }
            }
        }
    }
}

錯誤排除

在使用環形進度條時，常見錯誤包括：
1. 進度值超過 1.0：確保進度值始終在 0.0 到 1.0 之間。
2. 未正確自訂樣式：檢查是否正確應用 CircularProgressViewStyle。

延伸應用

環形進度條可以用於多種場景，例如：
– 下載進度顯示
– 任務完成度指示
– 遊戲進度更新

總結

在本文中，我們介紹了如何在 SwiftUI 2025 中使用環形進度條，包括如何創建、樣式自訂以及實作範例。這些知識將幫助你在 iOS 開發中更有效地使用環形進度條。

Q&A（常見問題解答）

1. 如何更改環形進度條的顏色？

使用 CircularProgressViewStyle 的 tint 屬性來設定顏色，例如 .progressViewStyle(CircularProgressViewStyle(tint: .green))。

2. 環形進度條可以使用動畫嗎？

是的，可以使用 CircularProgressViewStyle 的 animationDuration 屬性來自訂動畫時間。

3. 如何檢查進度值是否有效？

確保進度值在 0.0 到 1.0 之間，可以使用 min(progress + 0.1, 1.0) 來限制進度值。

在 SwiftUI 中使用環形進度條
—

Categorized in:

iOSswift

Tagged in:

,