SwiftUI: All Kinds of Pinned Headers
Zusammenfassung
Kurz
Der Bericht stellt SwiftUI-Techniken für feste, dehnbare und beim Scrollen schrumpfende Kopfbereiche vor. Als bevorzugte Lösung für den Übergang zur kompakten Ansicht beschreibt der Autor zwei übereinander angeordnete Kopfbereiche, wobei der große per Versatz bewegt wird; die Beispiele und Bewertungen beruhen auf den dargestellten Beobachtungen, ohne systematische Tests verschiedener Geräte oder Versionen.
Mittel
Der Bericht beschreibt drei SwiftUI-Muster für angeheftete Kopfbereiche: feste Abschnittsüberschriften, einen dehnbaren Kopfbereich und einen, der beim Scrollen zu einer kompakten Version wird. Für einfache Überschriften empfiehlt der Text `PinnedScrollableViews` in Lazy-Stacks; Plain- und Inset-Listen können ebenfalls Abschnittsüberschriften anheften.
Laut Autor können ScrollView-Inhalte über den sicheren Bildschirmbereich hinauslaufen, während angeheftete Ansichten innerhalb davon bleiben. Als Abhilfe nennt der Bericht `clipShape(Rectangle())`, eine minimale vertikale Polsterung oder eine NavigationStack mit Titel. Von einer Polsterung in Höhe der oberen Safe-Area-Inset wird abgeraten, weil SwiftUI den sicheren Bereich nach einer Polsterung offenbar selbst einberechnet. Für dehnbare Kopfbereiche wird `onScrollGeometryChange` genutzt. `safeAreaInset` könne dabei eine Rückkopplung zwischen Inhaltsrändern, Kopfbereichshöhe und Scrollereignissen auslösen.
Für den Übergang zu einer kompakten Ansicht verwirft der Text mehrere Ansätze wegen Problemen mit der Bildlaufanzeige oder beim Herunterziehen. Die abschließende Lösung platziert zwei Kopfbereichsansichten in einer ZStack über und unter der ScrollView und verschiebt die große Ansicht, statt sie tatsächlich scrollen zu lassen. Der Autor beurteilt das Ergebnis als besser; systematische Tests verschiedener Geräte oder Versionen werden nicht berichtet.
Ausführlich lesen
Der Bericht erklärt drei SwiftUI-Muster für angeheftete Kopfbereiche: einfache Abschnittsüberschriften, einen beim Herunterziehen dehnbaren Kopfbereich und einen Kopfbereich, der beim Scrollen in eine kompakte Version wechselt. Die Autorin oder der Autor zeigt jeweils Beispielcode und erläutert beobachtetes Verhalten; die Aussagen beruhen auf den beschriebenen SwiftUI-Beispielen und dem Vergleich mit der Kontakte-App.
Für einfache angeheftete Überschriften empfiehlt der Text `PinnedScrollableViews` in einer `LazyVStack` oder `LazyHStack`. Bei vertikalen Stapeln bleiben Überschriften oben und Fußzeilen unten angeheftet; bei horizontalen Stapeln liegen sie an der führenden beziehungsweise nachlaufenden Kante. Auch bestimmte Listenstile, insbesondere Plain und Inset, können Abschnittsüberschriften anheften.
Ein Problem sieht der Bericht darin, dass ScrollView-Inhalte über den sicheren Bildschirmbereich hinauslaufen können, angeheftete Ansichten dies aber nicht tun. Als Abhilfe nennt er drei Möglichkeiten: die ScrollView mit `clipShape(Rectangle())` beschneiden, eine sehr kleine vertikale Polsterung hinzufügen oder die Ansicht mit Titel in eine `NavigationStack` setzen. Der Text warnt davor, dafür einfach die obere `safeAreaInsets`-Höhe als Polsterung einzusetzen, weil SwiftUI nach schon geringfügiger Polsterung den sicheren Bereich offenbar selbst berücksichtigt und dadurch zu viel Abstand entstehen könne. `scrollClipDisabled(false)` hält die schreibende Person in diesem Zusammenhang für unnötig.
Für einen dehnbaren Einzelkopfbereich wird `onScrollGeometryChange` verwendet, um den Scrollversatz zu beobachten und die Höhe einer oben überlagerten Ansicht anzupassen. Ein transparenter Platzhalter in der ScrollView reserviert Raum für den Kopfbereich. Laut Bericht eignet sich `safeAreaInset` hier nicht: Die dadurch veränderten oberen Inhaltsränder können bei jedem Überziehen eine Rückkopplung auslösen. Der neue Versatz verändert die Kopfbereichshöhe, diese wiederum die Inhaltsränder, woraufhin erneut ein Scrollereignis entsteht.
Der anspruchsvollste Fall ist ein großer Kopfbereich, der beim Überziehen im Hintergrund wächst, zunächst mit dem Inhalt scrollt und nach einer Schwelle kompakt angeheftet wird. Ein erster Versuch ersetzt den scrollenden Bereich nach Erreichen der Schwelle durch einen Platzhalter und zeigt die kompakte Variante als Overlay. Der Autor hält das Ergebnis bei ausgeblendeter Bildlaufanzeige für brauchbar, berichtet aber von auffälligem Verhalten der Anzeige. Weitere Ansätze mit ignoriertem sicheren Bereich oder eingefärbtem ScrollView-Hintergrund scheitern laut Darstellung beim Herunterziehen beziehungsweise am Ende der Liste.
Die abschließende Lösung legt zwei Kopfbereichsansichten in einer ZStack über und unter die ScrollView. Vor dem Schwellenwert liegt die große Ansicht darüber und wird anhand des Versatzes verschoben; danach erscheint die kompakte Ansicht oben. So wird die Bewegung nachgebildet, ohne den großen Kopfbereich tatsächlich scrollen zu lassen. Der Bericht bewertet das visuelle Ergebnis als besser, liefert jedoch keine systematische Prüfung verschiedener iOS-Versionen, Geräte oder weiterer Randfälle.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Es wurden keine Fragen angegeben, daher bleibt die Einordnung leer. Die Prüfung bezieht sich auf die Zusammenfassung „mittel“. Die Zusammenfassung „kurz“ ist ebenfalls inhaltlich treu, lässt aber dieselben Punkte aus. Ihr Hinweis auf fehlende systematische Tests ist eine sinnvolle Einschränkung und keine Erfindung, weil der Bericht selbst keine solchen Tests anführt.
Im Bericht, aber nicht in der Zusammenfassung
- Die drei Anforderungen an den Transformations-Kopfbereich (Dehnung beim Überscrollen, Mitscrollen bis zur Schwelle, danach Anheften) und der Bezug zur Contacts-App
- Die verworfenen Ansätze für den Übergang (ignoresSafeArea bei List, Hintergrund der ScrollView) und ihre jeweiligen Probleme
- Das Problem mit der Bildlaufanzeige, das die finale Lösung motiviert
- Der Hinweis, dass safeAreaInsets.top nicht verwendet werden sollte, und dass scrollClipDisabled unnötig ist
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.