Diseño Adaptativo en SwiftUI
Resumen
Habilidad disciplinaria para construir diseños que responden al espacio disponible en lugar de suposiciones del dispositivo. Cubre la selección de herramientas, limitaciones de clases de tamaño, ventanas de forma libre en iOS 26 y antipatrones comunes.
Principio fundamental: Tu diseño debería funcionar correctamente si Apple lanza un nuevo dispositivo mañana, o si iPadOS añade un nuevo modo de multitarea el próximo año. Responde a tu contenedor, no a tus suposiciones sobre el dispositivo.
Cuándo Usar Esta Habilidad
- "¿Cómo hago que este diseño funcione en iPad y iPhone?"
- "¿Debería usar GeometryReader o ViewThatFits?"
- "Mi diseño se rompe en Vista Dividida / Stage Manager"
- "Las clases de tamaño no me dan lo que necesito"
- "El diseñador quiere un diseño diferente para vertical vs horizontal"
- "Preparando la app para el redimensionamiento de ventanas en iOS 26"
Árbol de Decisión
"Necesito que mi diseño se adapte..."
│
├─ AL ESPACIO DISPONIBLE (impulsado por el contenedor)
│ │
│ ├─ "Elegir la variante que mejor encaja"
│ │ → ViewThatFits
│ │
│ ├─ "Cambio animado entre H↔V"
│ │ → AnyLayout + condición
│ │
│ ├─ "Leer tamaño para cálculos"
│ │ → onGeometryChange (iOS 16+)
│ │
│ └─ "Algoritmo de diseño personalizado"
│ → protocolo Layout
│
├─ A RASGOS DE LA PLATAFORMA
│ │
│ ├─ "Ancho Compacto vs Regular"
│ │ → horizontalSizeClass (⚠️ Limitaciones en iPad)
│ │
│ ├─ "Tamaño de texto de accesibilidad"
│ │ → dynamicTypeSize.isAccessibilitySize
│ │
│ └─ "Diferencias de plataforma"
│ → #if os() / Environment
│
└─ A LA FORMA DE LA VENTANA (relación de aspecto)
│
├─ "Semántica vertical vs horizontal"
│ → Geometry + umbral personalizado
│
├─ "Mostrar/ocultar columnas automáticamente"
│ → NavigationSplitView (automático en iOS 26)
│
└─ "Ciclo de vida de la ventana"
→ @Environment(\.scenePhase)
Selección de Herramientas
Decisión Rápida
¿Necesitas un valor calculado (ancho, alto)?
├─ SÍ → onGeometryChange
└─ NO → ¿Necesitas transiciones animadas?
├─ SÍ → AnyLayout + condición
└─ NO → ViewThatFits
Cuándo Usar Cada Herramienta
| Necesito... | Usa esto | No esto |
|---|---|---|
| Elegir entre 2-3 variantes de diseño | ViewThatFits | if size > X |
| Cambiar H↔V con animación | AnyLayout | HStack/VStack condicional |
| Leer el tamaño del contenedor | onGeometryChange | GeometryReader |
| Adaptarme al texto de accesibilidad | dynamicTypeSize | Puntos de quiebre fijos |
| Detectar ancho compacto | horizontalSizeClass | UIDevice.idiom |
| Detectar ventana estrecha en iPad | Geometry + umbral | Clase de tamaño sola |
| Ocultar/mostrar barra lateral | NavigationSplitView | Lógica de columna manual |
| Algoritmo de diseño personalizado | protocolo Layout | GeometryReaders anidados |
Patrón 1: ViewThatFits
Úsalo cuando: Tengas 2-3 variantes de diseño y quieras que SwiftUI elija la primera que encaje.
ViewThatFits {
// Primera opción: horizontal
HStack {
Image(systemName: "star")
Text("Favorito")
Spacer()
Button("Añadir") { }
}
// Alternativa: vertical
VStack {
HStack {
Image(systemName: "star")
Text("Favorito")
}
Button("Añadir") { }
}
}
Limitación: ViewThatFits no expone qué variante se eligió. Si necesitas ese estado para otras vistas, usa AnyLayout en su lugar.
Patrón 2: AnyLayout para Cambio Animado
Úsalo cuando: Necesites transiciones animadas entre diseños, o necesites saber el estado actual del diseño.
struct AdaptiveStack<Content: View>: View {
@Environment(\.horizontalSizeClass) var sizeClass
let content: Content
var layout: AnyLayout {
sizeClass == .compact
? AnyLayout(VStackLayout(spacing: 12))
: AnyLayout(HStackLayout(spacing: 20))
}
var body: some View {
layout {
content
}
.animation(.default, value: sizeClass)
}
}
Para Tipo Dinámico:
@Environment(\.dynamicTypeSize) var dynamicTypeSize
var layout: AnyLayout {
dynamicTypeSize.isAccessibilitySize
? AnyLayout(VStackLayout())
: AnyLayout(HStackLayout())
}
Patrón 3: onGeometryChange (Preferido para Geometría)
Úsalo cuando: Necesites dimensiones reales para cálculos. Preferido sobre GeometryReader.
struct ResponsiveGrid: View {
@State private var columnCount = 2
var body: some View {
LazyVGrid(columns: Array(repeating: GridItem(.flexible()), count: columnCount)) {
ForEach(items) { item in
ItemView(item: item)
}
}
.onGeometryChange(for: Int.self) { proxy in
max(1, Int(proxy.size.width / 150))
} action: { newCount in
columnCount = newCount
}
}
}
Para detección de relación de aspecto ("orientación" en iPad):
struct WindowShapeReader: View {
@State private var isWide = true
var body: some View {
content
.onGeometryChange(for: Bool.self) { proxy in
proxy.size.width > proxy.size.height * 1.2
} action: { newValue in
isWide = newValue
}
}
}
Patrón 4: GeometryReader (Cuando sea Necesario)
Úsalo cuando: Necesites geometría Y estés en iOS 15 o anterior, O necesites geometría durante la fase de diseño (no solo como efecto secundario).
// ✅ CORRECTO: GeometryReader restringido
VStack {
GeometryReader { geo in
Text("Ancho: \(geo.size.width)")
}
.frame(height: 44) // ¡DEBE restringirse!
Button("Siguiente") { }
}
// ❌ INCORRECTO: Sin restricción (codicioso)
VStack {
GeometryReader { geo in
Text("Ancho: \(geo.size.width)")
}
// Toma todo el espacio disponible, aplasta a los hermanos
Button("Siguiente") { }
}
Tabla de Verdad de Clases de Tamaño (iPad)
| Configuración | Horizontal | Vertical |
|---|---|---|
| Pantalla completa vertical | .regular | .regular |
| Pantalla completa horizontal | .regular | .regular |
| Vista Dividida al 70% | .regular | .regular |
| Vista Dividida al 50% | .regular | .regular |
| Vista Dividida al 33% | .compact | .regular |
| Slide Over | .compact | .regular |
| Con teclado | (sin cambios) | (sin cambios) |
Información clave: La clase de tamaño solo se vuelve .compact en iPad aproximadamente al 33% de ancho o en Slide Over. Para un control más fino, usa geometría.
Ventanas de Forma Libre en iOS 26
Qué Cambió
| Antes de iOS 26 | iOS 26+ |
|---|---|
| Tamaños fijos de Vista Dividida | Arrastrar para redimensionar de forma libre |
UIRequiresFullScreen permitido | Obsoleto |
| Sin barra de menú en iPad | Barra de menú vía .commands |
| Visibilidad de columna manual | NavigationSplitView se adapta automáticamente |
Directriz de Apple
"Redimensionar una app no debería alterar permanentemente su diseño. Sé oportunista al revertir al estado inicial siempre que sea posible."
Traducción: No guardes el estado del diseño basado en el tamaño de la ventana. Cuando la ventana vuelva a su tamaño original, el diseño también debería hacerlo.
Auto-Adaptación de NavigationSplitView
// iOS 26: Las columnas se muestran/ocultan automáticamente
NavigationSplitView {
Sidebar()
} content: {
ContentList()
} detail: {
DetailView()
}
// No se necesita gestión manual de columnVisibility
Lista de Verificación para la Migración
- Eliminar
UIRequiresFullScreende Info.plist - Probar en tamaños de ventana arbitrarios (no solo 33/50/66%)
- Verificar que el diseño no se "pegue" después de redimensionar
- Añadir comandos de barra de menú para acciones comunes
- Probar que los Controles de Ventana no se superpongan con elementos de la barra de herramientas
Antipatrones
❌ Observador de Orientación del Dispositivo
// ❌ INCORRECTO: Reporta el dispositivo, no la ventana
NotificationCenter.default.addObserver(
forName: UIDevice.orientationDidChangeNotification, ...
)
let orientation = UIDevice.current.orientation
if orientation.isLandscape { ... }
Por qué falla: Reporta la orientación física del dispositivo, no la forma de la ventana. Es incorrecto en Vista Dividida, Stage Manager, iOS 26.
Solución: Usa onGeometryChange para leer las dimensiones reales de la ventana.
❌ Límites de Pantalla (Screen Bounds)
// ❌ INCORRECTO: Devuelve la pantalla completa, no tu ventana
let width = UIScreen.main.bounds.width
if width > 700 { useWideLayout() }
Por qué falla: En multitarea, tu app puede tener solo el 40% de la pantalla.
Solución: Lee el tamaño real del contenedor de tu vista.
❌ Verificaciones de Modelo de Dispositivo
// ❌ INCORRECTO: Se rompe en nuevos dispositivos, incorrecto en multitarea
if UIDevice.current.userInterfaceIdiom == .pad {
useWideLayout()
}
Por qué falla: Un iPad en Vista Dividida 1/3 es más estrecho que un iPhone 14 Pro Max en horizontal.
Solución: Responde al espacio disponible, no a la identidad del dispositivo.
❌ GeometryReader Sin Restricciones
// ❌ INCORRECTO: GeometryReader es codicioso
VStack {
GeometryReader { geo in
Text("Tamaño: \(geo.size)")
}
Button("Siguiente") { } // Aplastado
}
Solución: Restringe con .frame() o usa onGeometryChange.
❌ Clase de Tamaño como Proxy de Orientación
// ❌ INCORRECTO: iPad es .regular en ambas orientaciones
var isLandscape: Bool {
horizontalSizeClass == .regular // ¡Siempre cierto en iPad!
}
Solución: Calcula a partir de la geometría real si necesitas la relación de aspecto.
Escenarios de Presión
"El diseñador quiere un diseño específico para iPhone"
Tentación: if UIDevice.current.userInterfaceIdiom == .phone
Respuesta: "Implementaré estos como diseños 'compacto' y 'regular' que cambian según el espacio disponible. El diseño de iPhone aparecerá en iPad cuando la ventana sea estrecha. Esto nos prepara para el futuro con Stage Manager e iOS 26."
"Solo usa GeometryReader, está bien"
Tentación: Envolver todo en GeometryReader.
Respuesta: "GeometryReader tiene efectos secundarios de diseño conocidos: se expande de forma codiciosa. onGeometryChange lee los mismos datos sin afectar el diseño. Está retroportado a iOS 16."
"Las clases de tamaño funcionaban antes"
Tentación: Forzar todo a través de la clase de tamaño.
Respuesta: "Las clases de tamaño son aproximadas. El iPad es .regular en ambas orientaciones. Usaré la clase de tamaño para categorías amplias y geometría para umbrales precisos."
"No soportamos la multitarea en iPad"
Tentación: UIRequiresFullScreen = true
Respuesta: "Apple ha obsoleto el modo solo-pantalla-completa en iOS 26. Incluso sin soporte activo para Vista Dividida, la app no puede romperse al redimensionarse. El diseño basado en espacio tiene el mismo costo."
Recursos
WWDC: 2025-208, 2024-10074, 2022-10056
Habilidades: axiom-swiftui-layout-ref, axiom-swiftui-debugging, axiom-liquid-glass