Patrones de UI en SwiftUI
Inicio rápido
Elige una pista según tu objetivo:
Proyecto existente
- Identifica la funcionalidad o pantalla y el modelo de interacción principal (lista, detalle, editor, ajustes, con pestañas).
- Busca un ejemplo cercano en el repositorio con
rg "TabView\("o similar, luego lee la vista SwiftUI más cercana. - Aplica las convenciones locales: prefiere estado nativo de SwiftUI, mantén el estado local cuando sea posible y usa inyección de entorno para dependencias compartidas.
- Elige la referencia de componente relevante de
references/components-index.mdy sigue su guía. - Construye la vista con subvistas pequeñas y enfocadas y flujo de datos nativo de SwiftUI.
Scaffolding de nuevo proyecto
- Comienza con
references/app-scaffolding-wiring.mdpara cablear TabView + NavigationStack + sheets. - Añade un
AppTaby unRouterPathmínimos basados en los esqueletos proporcionados. - Elige la siguiente referencia de componente según la UI que necesites primero (TabView, NavigationStack, Sheets).
- Expande los enums de ruta y sheet a medida que se añadan nuevas pantallas.
Reglas generales a seguir
- Usa estado moderno de SwiftUI (
@State,@Binding,@Observable,@Environment) y evita modelos de vista innecesarios. - Prefiere composición; mantén las vistas pequeñas y enfocadas.
- Usa async/await con
.tasky estados explícitos de carga y error. - Mantén los patrones heredados existentes solo al editar archivos heredados.
- Sigue el formateador y la guía de estilo del proyecto.
- Sheets: Prefiere
.sheet(item:)sobre.sheet(isPresented:)cuando el estado representa un modelo seleccionado. Evitaif letdentro del cuerpo de un sheet. Los sheets deben poseer sus acciones y llamar adismiss()internamente en lugar de reenviar closuresonCancel/onConfirm.
Flujo de trabajo para una nueva vista SwiftUI
- Define el estado de la vista y su ubicación de propiedad.
- Identifica las dependencias a inyectar mediante
@Environment. - Esboza la jerarquía de la vista y extrae partes repetidas en subvistas.
- Implementa la carga asíncrona con
.tasky un enum de estado explícito si es necesario. - Añade etiquetas o identificadores de accesibilidad cuando la UI sea interactiva.
- Valida con una compilación y actualiza los puntos de llamada si es necesario.
Referencias de componentes
Usa references/components-index.md como punto de entrada. Cada referencia de componente debe incluir:
- Intención y escenarios de mejor ajuste.
- Patrón de uso mínimo con convenciones locales.
- Errores comunes y notas de rendimiento.
- Rutas a ejemplos existentes en el repositorio actual.
Patrones de Sheet
Sheet basado en item (preferido)
@State private var selectedItem: Item?
.sheet(item: $selectedItem) { item in
EditItemSheet(item: item)
}
Sheet que posee sus acciones
struct EditItemSheet: View {
@Environment(\.dismiss) private var dismiss
@Environment(Store.self) private var store
let item: Item
@State private var isSaving = false
var body: some View {
VStack {
Button(isSaving ? "Guardando…" : "Guardar") {
Task { await save() }
}
}
}
private func save() async {
isSaving = true
await store.save(item)
dismiss()
}
}
Añadir una nueva referencia de componente
- Crea
references/<component>.md. - Mantenlo breve y accionable; enlaza a archivos concretos en el repositorio actual.
- Actualiza
references/components-index.mdcon la nueva entrada.