SwiftUI: Custom Pull Down To Refresh
Zusammenfassung
Kurz
Der Bericht zeigt eine SwiftUI-Lösung für Pull-to-Refresh mit anpassbarem Indikator und Auslöseschwelle, die vor dem Auslösen abgebrochen werden kann. Sie verwendet `ScrollView`-Geometrie und Scroll-Phasen; laut Autor funktioniert der Ansatz mit `List` und `ScrollViewReader` nicht wie gewünscht.
Mittel
Der Bericht stellt eine eigene Pull-to-Refresh-Lösung für SwiftUI vor. Gegenüber `.refreshable(action:)` soll sie einen frei gestaltbaren Indikator, einstellbare Schwellwerte, eine beim Herunterziehen wachsende Anzeige und einen Abbruch vor dem Auslösen ermöglichen.
Dazu nutzt der Code eine `ScrollView`: `onScrollGeometryChange` verfolgt den Versatz und steuert Anzeige sowie Größe des Indikators. `onScrollPhaseChange` prüft beim Ende der Berührung, ob der Auslöseschwellwert überschritten wurde. Erst dann startet die asynchrone Refresh-Aktion. Laut Autor verhindert diese Trennung, dass ein bloßes Herunterziehen den Vorgang sofort auslöst. Ein `GeometryReader` ermittelt die Höhe des Indikators, damit beim Verkleinern auch der belegte Platz angepasst wird.
Der Artikel verpackt das Muster außerdem in einen Modifier für `ScrollView`, der Statusbindung, Aktion, Indikatoransicht und Schwellenwerte entgegennimmt. Als Grenze nennt der Autor, dass `onScrollPhaseChange` mit `List` und `ScrollViewReader` in diesem Beispiel nicht wiederholt funktioniert. Daher basiert die Lösung auf einer normalen `ScrollView`. Die gezeigten Ergebnisse sind Codebeispiele und Animationen; ein systematischer Test wird nicht beschrieben.
Ausführlich lesen
Der Bericht beschreibt eine selbst entwickelte Pull-to-Refresh-Lösung für SwiftUI. Der Autor hält die übliche Systemfunktion `.refreshable(action:)` für nützlich, vermisst dabei aber zwei Möglichkeiten: einen eigenen Indikator anzuzeigen und den Schwellwert für den Refresh-Auslöser festzulegen. Seine Lösung soll außerdem den Indikator beim Herunterziehen schrittweise vergrößern und einen Abbruch ermöglichen, wenn die Person die Ansicht wieder nach oben schiebt und vor Erreichen des Auslöseschwellwerts loslässt.
Die Umsetzung beruht auf `ScrollView` und den Scroll-Rückmeldungen `onScrollGeometryChange` und `onScrollPhaseChange`. Die Geometrie liefert den aktuellen Versatz samt oberem Inhaltsabstand. Daraus berechnet der Code, wie weit die Ansicht heruntergezogen wurde, und passt Anzeige und Größe des Indikators daran an. Ein Schwellenwert bestimmt, wann der Indikator erscheint; ein weiterer legt fest, wann der Refresh ausgelöst wird. Die Aktion startet erst, wenn die Scroll-Phase von `.interacting` in eine andere Phase wechselt und der Versatz dann den eingestellten Grenzwert überschreitet. Während der Aktion wird der Status `isRefreshing` gesetzt. Nach Abschluss der asynchronen Aktion wird er zurückgesetzt.
Der Artikel erklärt, weshalb die beiden Rückmeldungen verschiedene Aufgaben übernehmen: Die Geometrieänderung dient der laufenden, proportionalen Anzeige des Indikators. Den Refresh-Status setzt der Code dagegen erst beim Ende der Interaktion. Ohne diese Trennung könnte die Aktion bereits beim bloßen Überschreiten des Schwellenwerts starten, sodass ein anschließendes Hochschieben den Vorgang nicht mehr verhindert. Ein `GeometryReader` misst die ursprüngliche Höhe des Indikators. Der Code passt nicht nur dessen Skalierung, sondern auch die belegte Höhe an; laut Autor soll dies einen sichtbaren Sprung beim Verschwinden verhindern.
Anschließend verpackt der Bericht die Lösung in einen View Modifier für `ScrollView`. Dieser nimmt eine Bindung für den Refresh-Status, eine asynchrone Aktion, eine vom Aufrufer bereitgestellte Indikatoransicht sowie beide Schwellenwerte entgegen. Die Beschränkung auf `ScrollView` soll verhindern, dass das Einbetten anderer Ansichten deren Layout verändert; insbesondere könne eine in eine weitere `ScrollView` eingeschlossene `List` nicht mehr angezeigt werden.
Als konkrete Einschränkung nennt der Autor, dass `onScrollPhaseChange` in seiner Umsetzung mit `List` und `ScrollViewReader` nicht funktioniert: Es werde beim Erscheinen der Ansicht einmal ausgelöst und danach nicht erneut. Deshalb verwendet das Beispiel eine normale `ScrollView` mit `LazyVStack`. Der Artikel zeigt Codebeispiele und animierte Demonstrationen, enthält aber keinen dokumentierten systematischen Test oder Vergleich. Die Aussagen zu Verhalten und Einschränkungen sind somit die Darstellung des Autors. Zudem wird nur ein einfacher Textindikator als Beispiel gezeigt; der Modifier ermöglicht laut Code jedoch eine frei übergebene Indikatoransicht.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Luna hat nur die Sammelfrage SF-T1 eingeordnet; Teilfragen wurden nicht angegeben und deshalb nicht bewertet.
Im Bericht, aber nicht in der Zusammenfassung
- Der Modifier ist bewusst nur für ScrollView gedacht, weil eine List innerhalb einer ScrollView nicht angezeigt wird.
- onScrollPhaseChange feuert bei List und ScrollViewReader laut Autor nur einmal beim Erscheinen der Ansicht.
In der Zusammenfassung, laut Prüfung nicht im Bericht belegt
- Die Einschränkung „in diesem Beispiel“ bei List und ScrollViewReader; der Bericht formuliert die Grenze allgemein.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Tempo und Grenzen
- SF-T1 Welche messbaren Schwellen sollen eine Pause auslösen, und wer prüft sie?
- clef 100 %kein Bezug
- Luna 26 %einzelne zitierbare Belege
- JEV 100 %kein Bezug
- amos 100 %kein Bezug
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung gleiches Oberthema, hilft nicht