SwiftUI: Customize ProgressView
Zusammenfassung
Kurz
Der vollständige Bericht erklärt SwiftUIs `ProgressView` und zeigt, wo einfache Modifikatoren an Grenzen stoßen. Mit eigenen `ProgressViewStyle`-Implementierungen entstehen unter anderem anpassbare Balken und Ringe, Anzeigen mit Symbolen, fortschrittsabhängig gefüllte Bilder und Fortschrittsdarstellungen entlang eines Pfads.
Mittel
Der vollständige Bericht zeigt, wie sich SwiftUIs `ProgressView` anpassen lässt. Er beginnt mit linearen und kreisförmigen Standardanzeigen sowie `Gauge`-Varianten; deren Darstellung kann laut Beitrag je nach Plattform abweichen. Mit Modifikatoren lässt sich die Balkenfarbe über `.tint` ändern. Ein farbiger Hintergrund ist mit `.background` und einer Kapselbegrenzung möglich, funktioniert laut Beispiel aber nicht zuverlässig zusammen mit den eingebauten Labels. Auch die Höhe lässt sich nicht direkt bequem ändern: `.scaleEffect` kann helfen, dabei jedoch die abgerundeten Enden verformen.
Für mehr Kontrolle führt der Beitrag `ProgressViewStyle` vor und zeigt eigene lineare und kreisförmige Anzeigen mit einstellbaren Farben und Größen. Weitere Beispiele platzieren Symbole am Fortschrittsbalken, füllen ein Bild entsprechend dem Fortschritt oder zeichnen einen zugeschnittenen Teil eines eigenen Pfads. Die Ausrichtung der Bildfüllung kann angepasst werden. Die Beispiele dienen als Gestaltungsansätze; eine umfassende Plattform- und Versionsübersicht oder systematische Vergleiche enthält der Bericht nicht.
Ausführlich lesen
Der vollständige bereitgestellte Bericht ist ein SwiftUI-Tutorial von Itsuki zur Anpassung der eingebauten `ProgressView`. Die Autorin bzw. der Autor zeigt zunächst die beiden Grundformen, linear und kreisförmig, mit einem Beispiel, das den Fortschritt per Button schrittweise erhöht. Dabei wird darauf hingewiesen, dass die Darstellung des kreisförmigen Stils auf macOS anders ausfallen kann. Als verwandte Alternative stellt der Beitrag `Gauge` vor: Es gibt lineare und kreisförmige Varianten mit mehreren Stilen; laut Bericht ähnelt `AccessoryLinearCapacity` einer `ProgressView`.
Anschließend behandelt der Beitrag die Grenzen einfacher Modifikatoren. Für die Farbe des Fortschrittsbalkens empfiehlt er `.tint`; `.foregroundStyle()` funktioniere dafür nach Aussage des Berichts nicht. Eine farbige Hintergrundfläche lasse sich mit `.background` und `.clipShape(Capsule())` ergänzen. Ohne die Kapselbegrenzung könne der rechteckige Hintergrund an den abgerundeten Enden sichtbar bleiben. Bei `ProgressView` mit eingebauten Beschriftungen funktioniere dieser Ansatz laut Beispiel jedoch nicht wie gewünscht; eigene `Text`-Elemente in einem `VStack` seien eine mögliche Ausweichlösung. Die Balkenhöhe lasse sich dem Beitrag zufolge nicht zuverlässig mit `.frame(height:)` ändern. Als Behelf zeigt er `.scaleEffect(y:)`, merkt aber an, dass dadurch die Kapselenden verloren gehen können.
Für weitergehende Gestaltung erklärt der Bericht das Protokoll `ProgressViewStyle` und demonstriert mehrere eigene Stile. Ein kreisförmiger Fortschrittsring zeichnet einen Hintergrundkreis und einen entsprechend dem Fortschritt zugeschnittenen Vordergrund; Farbe, Hintergrundfarbe und Linienbreite sind einstellbar. Der lineare Stil verwendet zwei Kapseln, wobei die Breite der gefüllten Kapsel aus dem Fortschrittsanteil und der verfügbaren Geometrie berechnet wird. Eine Variante ergänzt ein Symbol am aktuellen Stand und eine Zielflagge; das Fortschrittssymbol wird bei vollständigem Fortschritt ausgeblendet, damit sich die Symbole nicht überlagern.
Weitere Beispiele füllen ein Bild – standardmäßig ein Herzsymbol – abhängig vom Fortschritt von unten. Durch geänderte Ausrichtung und variable Höhe oder Breite kann die Füllung laut Anleitung auch oben, links oder rechts beginnen. Schließlich überträgt der Beitrag das Ringprinzip auf einen selbst definierten `Path`: Ein Hintergrundpfad bleibt sichtbar, während ein zugeschnittener Vordergrundpfad den Fortschritt darstellt. Die Beispiele verwenden SwiftUI-Code; der Bericht erläutert einzelne gestalterische Grenzen, liefert aber keine systematische Plattform- oder Versionsübersicht und keine vergleichenden Messungen. Er versteht die Varianten als Anregungen für eigene Stile, nicht als abschließende Liste aller Möglichkeiten.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Luna hat zwei Fassungen geliefert, kurz und mittel; beide wurden geprüft. Die kurze Fassung ist treu, aber knapp. Die mittlere Fassung ist im Kern treu, verallgemeinert aber die Plattformangabe und lässt einige praktische Hinweise aus. Da Luna für Sammel- und Teilfragen jeweils (keine) angegeben hat, gibt es nichts einzuordnen und die Einordnung bleibt leer.
Im Bericht, aber nicht in der Zusammenfassung
- Gauge als Alternative zu ProgressView, etwa AccessoryLinearCapacity, das wie ein ProgressView aussieht
- foregroundStyle wirkt bei ProgressView nicht, nur tint
- Ohne Kapselbegrenzung sind bei der Hintergrundfarbe sichtbare Ecken zu sehen
- Die kurze Fassung nennt Modifikatoren und Gauge nicht
In der Zusammenfassung, laut Prüfung nicht im Bericht belegt
- Die Plattformabweichung wird auf die Gauge-Varianten ausgeweitet; der Bericht nennt sie nur für den kreisförmigen ProgressView auf macOS
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.