Mit SwiftUI einen Atlas fĂŒr Pfeilgiftfrösche bauen, um ArrangementView auf dem iPhone Duo zu verstehen: Split, Overlay, geteilter Zustand und echte Simulator-Screenshots.
Ein faltbares Telefon bringt mehr AnzeigeflÀche. Und ein paar Gewissheiten weniger. Frösche können ihre Beine falten, ohne die SwiftUI-Dokumentation aufzuschlagen. Versuchen wir, uns etwas von ihnen abzuschauen.
Bisher lieĂ sich ein adaptives Layout oft auf eine Frage reduzieren: âWie viel Platz habe ich?â Beim iPhone Duo muss man auch fragen, wo dieser Platz liegt. Eine groĂe, flache FlĂ€che, zwei durch ein Scharnier getrennte Bereiche, ein kompakteres AuĂendisplay: Dieselben Pixel erfĂŒllen nicht dieselben Aufgaben.
Mit iOS 27.1 fĂŒhrt Apple einen SwiftUI-Container ein, um zwei zusammengehörige Inhalte anzuordnen: ArrangementView. Um zu verstehen, was sich dadurch Ă€ndert, habe ich FrogAtlas gebaut, einen kleinen Atlas fĂŒr Pfeilgiftfrösche. Steckbriefe, Fotos und eine Karte. Und Frösche mit genug Farbe, damit wir nicht wieder nur blaue Layout-Rechtecke als Beispiel sehen. đž
Die App sieht aus wie eine alte naturkundliche EnzyklopĂ€die: elfenbeinfarbenes Papier, Serifenschrift, feine Linien und beschriftete Tafeln. Eine KI-generierte Zeichnung von D. tinctorius, angefertigt nach einem mit Quellenangabe versehenen Foto, ergĂ€nzt die Referenzbilder. Ăber die SchaltflĂ€che âFoto ansehenâ gelangt man zurĂŒck zum Originalbild. Die Stimmung: ein alter Band Naturgeschichte, dessen Inhaltsverzeichnis auf BerĂŒhrung reagiert.
Die Screenshots in diesem Artikel stammen aus der App im iPhone-Duo-Simulator mit iOS 27.1. Sie zeigen die Softwaredarstellung, keinen Ergonomietest mit einem physischen GerĂ€t. Apples offizielle Rahmen helfen, AuĂendisplay, aufgeklapptes Innendisplay und Buchposition auseinanderzuhalten. Einige Bewohner des Terrariums haben sich auĂerdem in die SeitenrĂ€nder verirrt.
Willkommen im Terrarium
FrogAtlas zeigt drei Arten: Dendrobates tinctorius, Dendrobates auratus und Dendrobates leucomelas. Eine Auswahl fĂŒr die Demo, kein vollstĂ€ndiges Verzeichnis der Gattung. Drei Arten, drei Muster und keine Rezension meiner typografischen Entscheidungen.
Die Daten stammen aus dem Wikipedia-Artikel ĂŒber Dendrobates und den einzelnen Artbeschreibungen. Es handelt sich um Amphibien aus der Familie der Dendrobatidae, die mit den feuchten tropischen WĂ€ldern Mittel- und SĂŒdamerikas verbunden sind. Die Gattung liefert den Kontext; die Steckbriefe prĂ€zisieren GröĂe, Lebensraum und Verbreitung der jeweiligen Art.
Ein kurzer Umweg durch die Taxonomie ist nötig. Auf der Seite zur Gattung stehen noch âfĂŒnf Artenâ und eine Liste, die D. azureus enthĂ€lt, nebeneinander. Das Verzeichnis Amphibian Species of the World fĂŒhrt diesen Namen als Synonym von D. tinctorius. In der App bleibt die blaue Form âazureusâ deshalb dieser Art zugeordnet. Eine spektakulĂ€re Farbe macht fĂŒr sich allein noch keine neue Art. Auch ein sehr schönes Blau nicht.
Die Aufgabe fĂŒr die OberflĂ€che ist einfach. Ich wĂ€hle einen Frosch, lese seinen Steckbrief, sehe mir sein Foto an. Danach wechsle ich zur Karte, um die Regionen einzuordnen, in denen die Art vorkommt.
Im aufgeklappten Zustand können Steckbrief und Foto nebeneinander bestehen. In Buchposition erzwingt das Scharnier eine Trennung. Auf dem AuĂendisplay möchte ich vor allem einen gut lesbaren Steckbrief und eine Möglichkeit behalten, die Art zu wechseln. Jeden Bildschirm separat zu bauen wĂ€re einfach genug. Sie bei ĂbergĂ€ngen konsistent zu halten, ist schon schwieriger.

FrogAtlas im Split-Stil auf dem flach geöffneten Innendisplay. Die kĂŒnstlerische Tafel wurde mit KI nach dem Foto von Olaf Leillinger erstellt (CC BY-SA 3.0). Das Originalfoto ist in der App erreichbar. Die vollstĂ€ndigen Credits stehen am Ende des Artikels.
Zwei zusammengehörige Inhalte, eine Verantwortung fĂŒrs Layout
ArrangementView erhĂ€lt eine primĂ€re und eine sekundĂ€re Ansicht. Der Stil beschreibt ihre rĂ€umliche Beziehung. Der Container entscheidet anschlieĂend abhĂ€ngig vom Kontext ĂŒber die Anordnung: verfĂŒgbare Proportionen, GröĂenklassen und reservierte Bereiche, darunter das Scharnier.
Beginnen wir mit Steckbrief und Foto:
enum AppLanguage {
case french
case english
}
NavigationStack {
ArrangementView {
FrogInformationView(frog: frog, language: .french)
} secondary: {
FrogPhotographyView(frog: frog, language: .french)
}
.arrangementViewStyle(.split)
}
Das Enum AppLanguage gehört zu unserer App. Der Parameter language gibt die gewÀhlte Sprache direkt an: .french oder .english.
FrogInformationView und FrogPhotographyView sind Komponenten unserer App. Der Container und der Stil stammen dagegen aus SwiftUI. Die Beispiele in diesem Artikel zielen auf iOS 27.1. Eine App, die Ă€ltere Versionen unterstĂŒtzt, braucht hinter einer VerfĂŒgbarkeitsprĂŒfung eine Alternative.
Der Stil .split teilt den Platz zwischen beiden Ansichten. Im einfachen Beispiel von Apple begĂŒnstigt ein breiterer als hoher Container eine horizontale Teilung; ein höherer als breiter Container eine vertikale. Die Regel auf âgroĂer Bildschirm gegen kleinen Bildschirmâ zu verkĂŒrzen, wĂŒrde einen Teil der Sache unterschlagen.
Was mich daran interessiert, ist die Verschiebung der Verantwortung. Der Steckbrief beschreibt seine Informationen. Das Foto zeigt das Bild. Der Container entscheidet, wie beides zusammenpasst. Ich muss diese Entscheidung nicht in jeder Komponente wiederholen.
Die Navigation bleibt ihre eigene Aufgabe
Der Name könnte verwirren, aber ArrangementView stellt keine Navigation bereit. Katalog, Ziele und der Weg zurĂŒck gehören weiterhin zu den ĂŒblichen Navigationscontainern.
Im Beispiel umschlieĂt NavigationStack die Anordnung. Ich verschachtele darin kein NavigationSplitView oder TabView, um eine Aufgabe zu erzwingen, fĂŒr die diese Ansichten nicht gedacht sind. Ich packe die Anordnung auch nicht in einen groĂen ScrollView, der die gesamte Seite umfasst. Der Steckbrief kann dagegen innerhalb des ihm zugewiesenen Bereichs selbst scrollen.
Die Apple-Session zu adaptiven Layouts erklÀrt die Abgrenzung zwischen Navigation, Anordnung und Inhalt sehr anschaulich.
Das Terrarium teilen: das LayoutverhÀltnis
Die HĂ€lfte fĂŒr den Steckbrief, die HĂ€lfte fĂŒrs Bild: ein Ausgangspunkt, keine Pflicht. Hier enthĂ€lt der Steckbrief Text und darf etwas mehr Platz bekommen. Der Name Dendrobates tinctorius ist nicht gerade fĂŒr eine Spalte mit drei Zeichen gemacht.
ArrangementView {
VStack(spacing: 0) {
FrogInformationView(frog: frog, language: .french)
}
.splitArrangementLayoutRatio(0.60)
} secondary: {
FrogPhotographyView(frog: frog, language: .french)
}
.arrangementViewStyle(.split)
Das entscheidende Detail: Der Modifikator wird auf das Kind angewendet, dessen PrĂ€ferenz man ausdrĂŒcken möchte, nicht auf das gesamte ArrangementView. So zeigt es auch die Dokumentation zu splitArrangementLayoutRatio.
Hier bitten wir um ungefĂ€hr 60 Prozent des Platzes fĂŒr den Steckbrief. Das VerhĂ€ltnis gilt fĂŒr die gewĂ€hlte Teilungsachse. Es verspricht nicht in jeder Position 60 Prozent des Bildschirms: Layoutbedingungen, PrioritĂ€ten und die physische Trennung spielen weiterhin eine Rolle.
Die kleine VStack mit einem Kind dient in der Demo als Wurzel des Bereichs. So liegt die Komponente, die den Arrangement-Kontext ausliest, darunter. Das ist auch praktisch relevant: Man sollte das tatsĂ€chliche Verhalten von Environment-Werten prĂŒfen und nicht nur feststellen, dass der Code kompiliert.
Den Steckbrief an die Entscheidung des Containers anpassen
Ein breiter Steckbrief kann MaĂe in zwei getrennten Blöcken zeigen. Ein kompakterer Bereich verlangt nach einer kĂŒrzeren Darstellung. Die Informationen bleiben verfĂŒgbar; ihre Form Ă€ndert sich.
struct FrogInformationView: View {
@Environment(\.splitArrangementAxis)
private var arrangementAxis
let frog: Frog
let language: AppLanguage
var body: some View {
ScrollView {
VStack(alignment: .leading) {
Text(frog.scientificName)
.italic()
if arrangementAxis == .horizontal {
FrogCharacteristicsGrid(frog: frog)
} else {
FrogCharacteristicsSummary(frog: frog)
}
}
}
}
}
FrogCharacteristicsGrid und FrogCharacteristicsSummary stehen hier fĂŒr zwei Darstellungsvarianten. Entscheidend ist die Frage ans System: Welche Achse verwendet die Anordnung?
splitArrangementAxis ist optional. AuĂerhalb eines Split-Arrangements kann der Wert nil sein. In diesem Beispiel dient die kompakte Darstellung auch dann als sinnvolle RĂŒckfallebene.
Ich muss weder das iPhone-Modell abfragen noch ĂŒberall Breiten-Schwellenwerte im Code verteilen. Das macht nicht jede Messung ĂŒberflĂŒssig. Es verhindert, dass ich noch einmal messe, was der Container bereits entschieden hat.
Kleiner Bildschirm: Der Frosch verlÀsst den Bildausschnitt
Auf einer schmalen FlÀche möchte ich vielleicht nur den Steckbrief behalten. Der Stil lÀsst sich auf bestimmte Achsen begrenzen:
ArrangementView {
FrogInformationView(frog: frog, language: .french)
} secondary: {
FrogPhotographyView(frog: frog, language: .french)
}
.arrangementViewStyle(.split.axes(.horizontal))
Wenn der Container entlang der erlaubten Achse nicht teilen kann, bleibt nur die primÀre Ansicht sichtbar. Das ist eine funktionale Entscheidung, nicht nur eine grafische.
Das Foto ergĂ€nzt den Steckbrief. Der ArtwĂ€hler ermöglicht dagegen, die App weiter zu erkunden. Deshalb bleibt er auĂerhalb des sekundĂ€ren Inhalts, der verschwinden kann.

AuĂendisplay, nur horizontale Teilung. Die groĂe Tafel verschwindet; Steckbrief und Artwahl bleiben zugĂ€nglich.
In unserem Beispiel gibt es eine wichtige Nuance. Das Foto kann verschwinden, ohne dass die textliche Beschreibung verloren geht. In einer visuellen Bestimmungs-App fĂŒr unterwegs könnte das Bild dagegen unverzichtbar sein. âSekundĂ€râ beschreibt die PrioritĂ€t innerhalb einer Aufgabe, keine endgĂŒltige Inhaltskategorie.
Die Karte im Hintergrund, der Frosch im Vordergrund
Weiter zum Atlas. Diesmal möchte ich eine Karte erkunden und einen kleinen Steckbrief im Vordergrund behalten. Der Stil .overlay passt zu dieser Beziehung.
ArrangementView {
VStack(spacing: 0) {
FrogSelectionPanel(frog: selectedFrog, language: .french)
}
} secondary: {
FrogWorldMap(selectedID: $selectedID, language: .french)
}
.arrangementViewStyle(.overlay)
Bei diesem Stil liegt die primĂ€re Ansicht im Vordergrund. Die Karte ist die sekundĂ€re Ansicht, auch wenn sie optisch den gröĂten Bereich einnimmt. âPrimĂ€râ heiĂt also nicht âam gröĂtenâ.

Overlay-Stil im flach geöffneten Zustand. Die Karte liefert den geografischen Kontext; der Steckbrief erinnert an die ausgewÀhlte Art. Kartenhintergrund: Apple Maps.
Wenn das GerĂ€t zusammengeklappt wird, kann der Container die beiden Inhalte auf getrennte Bereiche verteilen. WĂŒrde der kleine Steckbrief dabei unverĂ€ndert bleiben, wĂ€re viel Platz ungenutzt.
Der Steckbrief klappt die Beine aus, die Auswahl bleibt
Die Komponente kann ihre Position im Arrangement ĂŒber overlayArrangementZIndex auslesen:
struct FrogSelectionPanel: View {
@Environment(\.overlayArrangementZIndex)
private var zIndex
let frog: Frog
let language: AppLanguage
var body: some View {
if zIndex > 0 {
CompactFrogCard(frog: frog)
} else {
FrogInformationView(frog: frog, language: language)
}
}
}
CompactFrogCard ist die kompakte Karte unserer App. Im Overlay lÀsst sie dem Kartenhintergrund Raum. Sind die Ansichten getrennt, kann der Steckbrief den ganzen Bereich nutzen und Details anzeigen.

Buchposition im Simulator. Der Steckbrief erhÀlt mehr Platz, ohne dass die ausgewÀhlte Art wechselt. Die Trennung in der Mitte ergibt sich aus der GerÀteposition.
Der architektonisch wichtige Punkt liegt woanders: Der Auswahlzustand gehört in den Parent, oberhalb der Darstellungsvarianten. In FrogAtlas steht eine stabile ID fĂŒr die Art; @AppStorage bewahrt sie auch zwischen Starts. Das Telefon klappt sich zusammen; tinctorius bleibt tinctorius. Eine Verwandlung in auratus wĂ€re an dieser Stelle einen Bug-Ticket wert.
Bei der Karte gilt dieselbe Vorsicht: Wird ihr Zustand bei jedem Layoutwechsel neu erstellt, kann der gewĂ€hlte Ausschnitt verloren gehen. Ein gelungener Ăbergang bewahrt die laufende Arbeit. Er liefert nicht nur ein hĂŒbsches Vorher-Nachher-Bild.
In der auf dem Tisch abgestellten Position kann eine vertikale Teilung den beiden Bereichen ebenfalls unterschiedliche Rollen geben. Inhalte zum Lesen und Bedienelemente zum Antippen haben nicht zwangslĂ€ufig dieselben Anforderungen. Das sollte man in der Praxis prĂŒfen, besonders im Hinblick auf Barrierefreiheit und die Reichweite von Gesten.
Das Overlay einschrĂ€nken â mit gutem Grund
Wie beim Split lassen sich auch beim Overlay erlaubte Achsen begrenzen:
.arrangementViewStyle(.overlay.axes(.vertical))
Diese Konfiguration schrĂ€nkt die möglichen Teilungen ein. Ich wĂŒrde sie nicht bloĂ verwenden, um ĂŒberall dieselbe Komposition zu erzwingen. Ein Button, der am selben Ort bleibt, aber nahe am Scharnier schwer erreichbar ist, hat wenig gewonnen.
Das richtige Kriterium bleibt die Handlung der Person. Kann sie in jeder Position lesen, vergleichen, auswĂ€hlen und zurĂŒckgehen? Wenn eine Trennung das verbessert, ĂŒberlasse ich sie lieber dem Container.
Ein Atlas sollte keine Genauigkeit vortÀuschen
Das Modell hÀlt die wissenschaftlichen Angaben unabhÀngig vom Layout:
struct Frog: Identifiable {
let id: String
let scientificName: String
let family: String
let habitat: String
let distribution: String
let sourceURL: URL
}
Das ist ein vereinfachtes Modell fĂŒr diesen Artikel. Die App ergĂ€nzt Ăbersetzungen, MaĂe, Fotocredits und Koordinaten fĂŒr ihre pĂ€dagogischen Markierungen.
Die Punkte auf der Karte sind keine Beobachtungen und keine Verbreitungsgebiete. Sie helfen, gröĂere Regionen einzuordnen. Die OberflĂ€che sagt das ausdrĂŒcklich. Der Punkt âtinctoriusâ ist also nicht die Postanschrift eines Frosches. Ein einzelner Kartenpunkt, ein Vorkommen in einem Land und ein kartiertes Verbreitungsgebiet sind drei verschiedene Informationsstufen.
FĂŒr einen echten wissenschaftlichen Atlas brĂ€uchte man dokumentierte Geodaten mit Herkunft, Datum und Unsicherheit. Ein Polygon um ein paar LĂ€nder wĂŒrde das Problem nicht lösen; es gĂ€be einer NĂ€herung nur eine ĂŒberzeugendere Form.
Auch bei biologischen Zahlen bin ich vorsichtig. Eine GröĂenangabe hĂ€ngt von Geschlecht, Population und verfĂŒgbaren Messungen ab. Ein GefĂ€hrdungsstatus braucht eine Quelle und ein Datum. FĂŒr diese Layout-Demo nehme ich lieber ein paar ĂŒberprĂŒfbare Angaben als einen Steckbrief voller dekorativer Zahlen.
Was ich vor der Auslieferung prĂŒfen wĂŒrde
Die Kompilierung prĂŒft Typen. Sie prĂŒft weder Lesbarkeit noch einen durchgĂ€ngigen Ablauf. Ein grĂŒner Build heiĂt nicht, dass alle Frösche gut untergebracht sind. Die Demo wurde mit dem iOS-27.1-SDK kompiliert; die Screenshots entstanden, nachdem ich die Simulatorposition tatsĂ€chlich gewechselt hatte.
FĂŒr eine veröffentlichte App wĂ€re meine kurze, aber anspruchsvolle PrĂŒfliste:
- die ausgewĂ€hlte Art nach jedem Ăffnen, SchlieĂen und Drehen wiederfinden;
- wichtige Funktionen erreichbar halten, wenn die sekundÀre Ansicht verschwindet;
- französische und englische Texte mit groĂen SchriftgröĂen testen;
- Scrollen, VoiceOver und Bedienelemente nahe am Scharnier prĂŒfen;
- ĂbergĂ€nge am GerĂ€t testen, wĂ€hrend eine Person das Telefon tatsĂ€chlich hĂ€lt.
Ein letzter Punkt gehört dazu: Nicht alles umbauen, nur weil eine API es ermöglicht. Ein scrollender Artikel kann bereits sehr gut funktionieren. Seine AbsÀtze zwischen zwei Bereichen zu verschieben, könnte vor allem den Lesefluss zerstören.
Was ich aus ArrangementView mitnehme
Ich sehe in diesem Container nicht das Ende der Designarbeit, sondern eine klarere Möglichkeit, einen Teil davon auszudrĂŒcken.
Die Daten beschreiben die Frösche. Die Komponenten können Steckbrief, Foto und Karte darstellen. Das Arrangement organisiert ihre rÀumliche Beziehung. Und der Zustand hÀlt fest, was die Person gerade tut.
Diese Trennung ist bei einem faltbaren Telefon nĂŒtzlich. Ebenso bei jeder OberflĂ€che, die in mehreren Formaten funktionieren soll, ohne zu einer Sammlung unabhĂ€ngiger Bildschirme zu werden.
Wir schreiben etwas weniger Code, um Elemente zu platzieren. Die Verantwortung dafĂŒr, was zĂ€hlt, bleibt vollstĂ€ndig bei uns.
Die Frösche können weiterhĂŒpfen. Die Auswahl bleibt an ihrem Platz. đž
Quellen und Credits
Dokumentation, abgerufen am 26. Oktober 2026: ArrangementView, LayoutverhÀltnis, Split-Achse, Z-Index des Overlays, Apple-Session und Designing for iPhone Duo.
Naturkundliche Angaben, sinngemÀà nach Wikipedia: Dendrobates, D. tinctorius, D. auratus, D. leucomelas. Die Texte stehen unter CC BY-SA 4.0. Die Synonymie von azureus wurde bei Amphibian Species of the World, AMNH geprĂŒft.
Fotos von Wikimedia Commons: D. tinctorius â Olaf Leillinger, D. auratus â Wildfeuer, D. leucomelas â Boucaque. Alle drei stehen unter CC BY-SA 3.0, wurden in der OberflĂ€che skaliert und zugeschnitten; diese Bearbeitungen behalten dieselbe Lizenz. Die Zeichnung von D. tinctorius ist eine KI-generierte kĂŒnstlerische Interpretation nach Olaf Leillingers Foto und steht unter derselben Lizenz. Screenshots: FrogAtlas im iPhone-Duo-Simulator; Kartendarstellung: Apple Maps, mit beibehaltener Quellenangabe.
Die Zeichnung von D. auratus am Seitenrand ist eine KI-generierte kĂŒnstlerische Interpretation nach dem oben genannten Foto von Wildfeuer unter CC BY-SA 3.0. Diese Zeichnungen illustrieren den Artikel und dienen nicht der Artenbestimmung. Die iPhone-Duo-Rahmen stammen aus den Apple Design Resources; fĂŒr sie gilt die Apple-Design-Resources-Lizenz, getrennt von den Lizenzen der Fotos und Zeichnungen.
Wie alle Artikel dieses Blogs basiert auch dieser auf einem von Hand geschriebenen Text, der anschlieĂend von einer KI gegengelesen wurde. Die englische Version entstand mit KI-UnterstĂŒtzung. Der Code fĂŒr FrogAtlas wurde teilweise mit einem KI-Agenten entwickelt. Die Screenshots wurden von diesem Agenten erstellt.
