iPhone Duo: ripensare i layout SwiftUI, una rana alla volta 🐸

Tre rane freccia, un iPhone pieghevole e una scheda che mantiene l’orientamento: capire ArrangementView in SwiftUI

Clément Sauvage13 min di lettura
iPhone Duo: ripensare i layout SwiftUI, una rana alla volta 🐸

Costruire con SwiftUI un atlante di Dendrobates per capire ArrangementView su iPhone Duo: split, overlay, stato condiviso e screenshot reali del simulatore.

Un telefono pieghevole aggiunge superficie di visualizzazione. E qualche certezza in meno. Le rane piegano le zampe senza aprire la documentazione di SwiftUI. Proviamo a prendere spunto da loro.

Finora spesso bastava una domanda per riassumere un layout adattivo: «quanto spazio ho?». Con iPhone Duo bisogna chiedersi anche dove si trova quello spazio. Un’ampia superficie piatta, due aree separate dalla piega, uno schermo esterno più compatto: gli stessi pixel non svolgono lo stesso ruolo.

Con iOS 27.1 Apple introduce un contenitore SwiftUI per organizzare due contenuti collegati: ArrangementView. Per capire cosa cambia, ho costruito FrogAtlas, un piccolo atlante di dendrobatidi. Schede, fotografie e una mappa. E rane abbastanza colorate da risparmiarci i soliti rettangoli blu degli esempi di layout. 🐸

Ho dato all’app l’aspetto di una vecchia enciclopedia di storia naturale: carta color avorio, caratteri con grazie, filetti sottili e tavole illustrate con didascalie. Un disegno di D. tinctorius generato dall’IA a partire da una fotografia accreditata affianca le immagini di riferimento. Il pulsante «Vedi la fotografia» riporta all’immagine originale. L’atmosfera è quella di un vecchio volume naturalistico, ma con un indice che risponde al tocco.

Le schermate di questo articolo provengono dall’app eseguita nel simulatore iPhone Duo con iOS 27.1. Mostrano il rendering software, non una prova di ergonomia su un dispositivo fisico. Le cornici ufficiali di Apple aiutano a distinguere lo schermo esterno, quello interno aperto e la posizione a libro. Alcuni abitanti del terrario si sono infilati anche nei margini.

Benvenuti nel terrario

FrogAtlas presenta tre specie: Dendrobates tinctorius, Dendrobates auratus e Dendrobates leucomelas. Una selezione per la demo, non un inventario completo del genere. Tre specie, tre livree e nessun giudizio sulle mie scelte tipografiche.

I dati provengono dalla pagina di Wikipedia dedicata ai Dendrobates e dalle schede delle singole specie. Sono anfibi della famiglia Dendrobatidae, associati alle foreste tropicali umide dell’America centrale e meridionale. Il genere fornisce il contesto; le schede precisano dimensioni, habitat e distribuzione di ogni specie.

Serve una breve parentesi tassonomica. La pagina del genere riporta ancora «cinque specie» e allo stesso tempo un elenco che include D. azureus. Il riferimento Amphibian Species of the World classifica quel nome come sinonimo di D. tinctorius. Nell’app, quindi, la forma blu «azureus» resta associata a questa specie. Un colore spettacolare, da solo, non crea una nuova specie. Neppure un blu bellissimo.

L’esigenza dell’interfaccia è semplice. Scelgo una rana, leggo la sua scheda e guardo la fotografia. Poi passo alla mappa per capire in quali regioni è presente la specie.

Quando il telefono è aperto, scheda e fotografia possono coesistere. In posizione a libro, la piega impone una separazione. Sullo schermo esterno voglio soprattutto una scheda leggibile e un modo per cambiare specie. Costruire ciascuna schermata separatamente sarebbe abbastanza facile. Mantenerle coerenti durante le transizioni è già meno semplice.

FrogAtlas aperto: la scheda di Dendrobates tinctorius e la tavola illustrata occupano due aree distinte.

FrogAtlas in stile split sullo schermo interno aperto in piano. La tavola artistica è stata generata con l’IA a partire dalla fotografia di Olaf Leillinger, CC BY-SA 3.0. La fotografia originale resta accessibile nell’app. Crediti completi alla fine dell’articolo.

Due contenuti collegati, una responsabilità di layout

ArrangementView riceve una vista primaria e una secondaria. Lo stile descrive la loro relazione spaziale. Poi il contenitore decide come disporle in base al contesto: proporzioni disponibili, classi di dimensione e aree riservate, inclusa la piega.

Partiamo dalla scheda e dalla fotografia:

enum AppLanguage {
    case french
    case english
}

NavigationStack {
    ArrangementView {
        FrogInformationView(frog: frog, language: .french)
    } secondary: {
        FrogPhotographyView(frog: frog, language: .french)
    }
    .arrangementViewStyle(.split)
}

L’enum AppLanguage appartiene alla nostra app. Il parametro language indica direttamente la lingua scelta: .french o .english.

I nomi FrogInformationView e FrogPhotographyView designano componenti della nostra app. Il contenitore e lo stile, invece, vengono da SwiftUI. Gli esempi di questo articolo si riferiscono a iOS 27.1; un’app che supporta versioni precedenti deve prevedere un’alternativa dietro un controllo di disponibilità.

Lo stile .split divide lo spazio fra le due viste. Nell’esempio semplice di Apple, un contenitore più largo che alto favorisce una divisione orizzontale; uno più alto che largo ne favorisce una verticale. Ridurre la regola a «schermo grande contro schermo piccolo» farebbe perdere una parte del problema.

Quello che mi interessa è lo spostamento di responsabilità. La scheda descrive le proprie informazioni. La fotografia mostra l’immagine. Il contenitore decide come farle coesistere. Non devo ripetere la stessa decisione in ogni componente.

La navigazione resta una responsabilità distinta

Il nome può trarre in inganno, ma ArrangementView non fornisce navigazione. Il catalogo, le destinazioni e il ritorno alla schermata precedente restano responsabilità dei consueti contenitori di navigazione.

Nell’esempio, NavigationStack racchiude l’arrangement. Non ci annido dentro un NavigationSplitView o un TabView per costringerlo a svolgere un ruolo che non gli spetta. Evito anche di mettere l’arrangement dentro un grande ScrollView che abbracci tutta la pagina. La scheda, invece, può avere il proprio scorrimento nell’area che le è assegnata.

La sessione Apple sui layout adattivi spiega bene la distinzione tra navigazione, disposizione e contenuto.

Dividere il terrario: il rapporto di layout

Metà alla scheda, metà all’immagine: è un punto di partenza, non un obbligo. Qui la scheda contiene testo e beneficia di un po’ più spazio. Il nome Dendrobates tinctorius non è esattamente fatto per una colonna larga tre caratteri.

ArrangementView {
    VStack(spacing: 0) {
        FrogInformationView(frog: frog, language: .french)
    }
    .splitArrangementLayoutRatio(0.60)
} secondary: {
    FrogPhotographyView(frog: frog, language: .french)
}
.arrangementViewStyle(.split)

Il dettaglio che conta: il modificatore si applica al figlio di cui si esprime la preferenza, non all’intero ArrangementView. È anche la forma mostrata nella documentazione di splitArrangementLayoutRatio.

Qui chiediamo circa il 60% dello spazio per la scheda. Il rapporto si riferisce all’asse di divisione scelto. Non promette il 60% dello schermo in ogni posizione: vincoli di layout, priorità e separazione fisica continuano a contare.

La piccola VStack con un solo figlio fa da radice dell’area nella demo. In questo modo il componente che legge il contesto dell’arrangement si trova al di sotto. È un dettaglio pratico: bisogna verificare il comportamento effettivo dei valori environment, non limitarsi a constatare che il codice compila.

Adattare la scheda alla scelta del contenitore

Una scheda larga può mostrare le misure in due blocchi distinti. Un’area più compatta richiede una presentazione più breve. Le informazioni restano disponibili; cambia il modo di mostrarle.

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 e FrogCharacteristicsSummary sono due varianti di presentazione. La domanda importante al sistema è: quale asse usa l’arrangement?

splitArrangementAxis è opzionale. Fuori da uno split arrangement, il valore può essere nil. In questo esempio la presentazione compatta è anche un fallback ragionevole in quel caso.

Non devo chiedere quale modello di iPhone sto usando né disseminare soglie di larghezza nel codice. Questo non elimina ogni necessità di misurare. Evita di misurare di nuovo ciò che il contenitore ha già deciso.

Schermo piccolo: la rana esce dall’inquadratura

Su una superficie stretta posso preferire tenere soltanto la scheda. Lo stile consente di limitare gli assi:

ArrangementView {
    FrogInformationView(frog: frog, language: .french)
} secondary: {
    FrogPhotographyView(frog: frog, language: .french)
}
.arrangementViewStyle(.split.axes(.horizontal))

Se il contenitore non può dividere lo spazio lungo l’asse consentito, resta visibile solo la vista primaria. È una decisione funzionale oltre che grafica.

La fotografia completa la scheda. Il selettore delle specie, invece, permette di continuare a esplorare l’app. Per questo lo tengo fuori dal contenuto secondario, che potrebbe scomparire.

FrogAtlas sullo schermo esterno: la scheda resta visibile quando la divisione è limitata all’asse orizzontale.

Schermo esterno, solo divisione orizzontale. La grande tavola scompare; scheda e selezione della specie restano accessibili.

Nel nostro esempio c’è una sfumatura importante. La fotografia può scomparire senza far perdere la descrizione testuale. In un’app di identificazione visiva sul campo, invece, l’immagine potrebbe essere indispensabile. «Secondario» descrive una priorità all’interno di un’attività, non una categoria definitiva di contenuto.

La mappa sullo sfondo, la rana in primo piano

Passiamo all’atlante. Questa volta voglio esplorare una mappa con una piccola scheda in primo piano. Lo stile .overlay corrisponde a questa relazione.

ArrangementView {
    VStack(spacing: 0) {
        FrogSelectionPanel(frog: selectedFrog, language: .french)
    }
} secondary: {
    FrogWorldMap(selectedID: $selectedID, language: .french)
}
.arrangementViewStyle(.overlay)

Con questo stile, la vista primaria è in primo piano. La mappa è la vista secondaria, anche se occupa visivamente la superficie più grande. Primaria non significa quindi «più grande».

FrogAtlas aperto in piano: una scheda compatta è sovrapposta alla mappa interattiva.

Stile overlay in posizione piatta. La mappa dà il contesto geografico; la scheda ricorda la specie selezionata. Sfondo cartografico: Apple Maps.

Quando il dispositivo si piega, il contenitore può separare i due contenuti in aree distinte. Se la piccola scheda restasse identica, però, molto spazio rimarrebbe inutilizzato.

La scheda distende le zampe, la selezione resta

Il componente può leggere la propria posizione nell’arrangement con overlayArrangementZIndex:

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 è la scheda riassuntiva della nostra app. In sovrapposizione lascia spazio alla mappa sullo sfondo. Quando le viste sono separate, la scheda informativa può usare tutta la propria area e mostrare più dettagli.

FrogAtlas parzialmente piegato: mappa e scheda dettagliata occupano ciascuna una regione dello schermo.

Posizione a libro nel simulatore. La scheda guadagna spazio senza cambiare specie. La separazione centrale deriva dalla posizione del dispositivo.

Il punto architetturale è un altro: lo stato della selezione appartiene al parent, sopra le varianti di presentazione. In FrogAtlas un identificatore stabile rappresenta la specie; @AppStorage lo conserva anche tra un avvio e l’altro. Il telefono si piega, tinctorius resta tinctorius. Una metamorfosi in auratus a questo punto meriterebbe una segnalazione di bug.

La stessa attenzione vale per la mappa: ricrearne lo stato a ogni cambio di layout può far perdere l’inquadratura scelta. Una transizione riuscita conserva il lavoro in corso. Non si limita a produrre una bella immagine del prima e del dopo.

Nella posizione appoggiata sul tavolo, una divisione verticale può assegnare ruoli diversi alle due regioni. I contenuti da leggere e i controlli da toccare non hanno necessariamente le stesse esigenze. Va verificato nella pratica, soprattutto per l’accessibilità e la raggiungibilità dei gesti.

Limitare l’overlay, con un motivo

Come per lo split, si possono limitare gli assi consentiti:

.arrangementViewStyle(.overlay.axes(.vertical))

Questa configurazione restringe le possibili separazioni. Non la userei soltanto per imporre la stessa composizione ovunque. Se un pulsante resta nello stesso punto ma diventa difficile da raggiungere vicino alla piega, non abbiamo guadagnato molto.

Il criterio giusto resta l’azione della persona. Riesce a leggere, confrontare, selezionare e tornare indietro in ogni posizione? Se la separazione migliora queste attività, preferisco lasciare che sia il contenitore a gestirla.

Un atlante non deve fingere una precisione che non ha

Il modello mantiene le informazioni scientifiche indipendenti dal layout:

struct Frog: Identifiable {
    let id: String
    let scientificName: String
    let family: String
    let habitat: String
    let distribution: String
    let sourceURL: URL
}

È un modello semplificato per l’articolo. L’app aggiunge traduzioni, misure, crediti fotografici e coordinate per i suoi riferimenti didattici.

I punti sulla mappa non sono osservazioni né aree di distribuzione. Servono a orientarsi tra grandi regioni. L’interfaccia lo dice esplicitamente. Il punto “tinctorius” non è quindi l’indirizzo di casa di una rana. Un punto sulla mappa, una presenza segnalata in un paese e un’area di distribuzione cartografata sono tre livelli di informazione diversi.

Per un vero atlante scientifico servirebbero dati geografici documentati, con provenienza, data e incertezza. Disegnare un poligono attorno a qualche paese non risolverebbe il problema: darebbe solo una forma più convincente a una stima.

Anche sui numeri biologici preferisco essere prudente. Una fascia di dimensioni dipende dal sesso, dalle popolazioni e dalle misurazioni disponibili. Lo stato di conservazione richiede una fonte e una data. Per questa demo di layout preferisco poche informazioni verificabili a una scheda piena di numeri decorativi.

Cosa verificherei prima di distribuire l’app

La compilazione controlla i tipi. Non controlla la leggibilità né la continuità dell’esperienza. Una build riuscita non significa che tutte le rane siano sistemate bene. La demo è stata compilata con l’SDK iOS 27.1; gli screenshot sono stati realizzati cambiando davvero la posizione del simulatore.

Per un’app distribuita, la mia lista di verifica sarebbe breve ma rigorosa:

  • ritrovare la specie selezionata dopo ogni apertura, chiusura e rotazione;
  • mantenere accessibili le funzioni essenziali quando la vista secondaria scompare;
  • provare i testi francesi e inglesi con caratteri di grandi dimensioni;
  • verificare scorrimento, VoiceOver e controlli vicini alla piega;
  • provare le transizioni sul dispositivo, mentre una persona tiene davvero in mano il telefono.

Aggiungerei un ultimo punto: non trasformare tutto solo perché un’API lo permette. Un articolo che scorre può già funzionare molto bene. Spostarne i paragrafi tra due regioni rischierebbe soprattutto di far perdere il filo.

Cosa mi porto via da ArrangementView

Non vedo in questo contenitore la fine del lavoro di design. Vedo un modo più pulito per esprimerne una parte.

I dati descrivono le rane. I componenti sanno presentare una scheda, una fotografia o una mappa. L’arrangement organizza il loro rapporto nello spazio. E lo stato conserva ciò che la persona sta facendo.

Questa separazione è utile su un telefono pieghevole. Lo è anche ogni volta che un’interfaccia deve funzionare in formati diversi senza diventare una collezione di schermate indipendenti.

Scriviamo un po’ meno codice per posizionare gli elementi. La responsabilità di decidere cosa conta resta tutta nostra.

Le rane possono continuare a saltare. La selezione resta al suo posto. 🐸


Fonti e crediti

Documentazione consultata il 26 ottobre 2026: ArrangementView, rapporto di layout, asse dello split, Z-index dell’overlay, sessione Apple e Designing for iPhone Duo.

Dati naturalistici, rielaborati da Wikipedia: Dendrobates, D. tinctorius, D. auratus, D. leucomelas. I testi dei contributori sono distribuiti con licenza CC BY-SA 4.0. La sinonimia di azureus è stata verificata in Amphibian Species of the World, AMNH.

Fotografie da Wikimedia Commons: D. tinctorius — Olaf Leillinger, D. auratus — Wildfeuer, D. leucomelas — Boucaque. Tutte e tre sono sotto licenza CC BY-SA 3.0, ridimensionate e ritagliate nell’interfaccia; le modifiche mantengono la stessa licenza. Il disegno di D. tinctorius è un’interpretazione artistica generata dall’IA a partire dalla fotografia di Olaf Leillinger, distribuita con la medesima licenza. Schermate: FrogAtlas nel simulatore iPhone Duo; cartografia: Apple Maps, con attribuzioni conservate.

Il disegno di D. auratus nei margini è un’interpretazione artistica generata dall’IA a partire dalla fotografia di Wildfeuer citata sopra, sotto CC BY-SA 3.0. Questi disegni illustrano l’articolo e non servono a identificare le specie. Le cornici di iPhone Duo provengono dalle Apple Design Resources; seguono la licenza Apple Design Resources, distinta da quelle delle fotografie e dei disegni.


Come tutti gli articoli di questo blog, anche questo nasce da un testo scritto a mano e poi riletto da un’IA. La versione inglese è stata realizzata con l’aiuto dell’IA. Il codice di FrogAtlas è stato sviluppato in parte con un agente IA. Gli screenshot sono stati realizzati da questo agente.

Blog

Articoli correlati