¿Qué hace Refactorizar vista SwiftUI?
Atribución: copiado de Dimillian/Skills de @Dimillian (2025-12-31).
Resumen
Aplicar una estructura y patrón de dependencias consistente a las vistas SwiftUI, con enfoque en ordenamiento, patrones Modelo-Vista (MV), manejo cuidadoso de view models y uso correcto de Observation.
Guías principales
1) Orden de la vista (de arriba a abajo)
Environmentprivate/publiclet@State/ otras propiedades almacenadasvarcomputadas (no vistas)initbody- constructores de vista computados / otros helpers de vista
- funciones helper / asíncronas
2) Preferir patrones MV (Modelo-Vista)
- Por defecto usar MV: Las vistas son expresiones de estado ligeras; los modelos/servicios poseen la lógica de negocio.
- Favorecer
@State,@Environment,@Queryytask/onChangepara la orquestación. - Inyectar servicios y modelos compartidos mediante
@Environment; mantener las vistas pequeñas y componibles. - Dividir vistas grandes en subvistas en lugar de introducir un view model.
3) Dividir cuerpos grandes y propiedades de vista
- Si
bodycrece más allá de una pantalla o tiene múltiples secciones lógicas, dividirlo en subvistas más pequeñas. - Extraer propiedades de vista computadas grandes (
var header: some View { ... }) en tiposViewdedicados cuando tengan estado o ramificaciones complejas. - Está bien mantener subvistas relacionadas como propiedades de vista computadas en el mismo archivo; extraer a un struct
Viewindependiente solo cuando tenga sentido estructuralmente o cuando se pretenda reutilizar. - Preferir pasar entradas pequeñas (datos, bindings, callbacks) en lugar de reutilizar todo el estado de la vista padre.
Ejemplo (extrayendo una sección):
var body: some View {
VStack(alignment: .leading, spacing: 16) {
HeaderSection(title: title, isPinned: isPinned)
DetailsSection(details: details)
ActionsSection(onSave: onSave, onCancel: onCancel)
}
}
Ejemplo (body largo → body más corto + vistas computadas en el mismo archivo):
var body: some View {
List {
header
filters
results
footer
}
}
private var header: some View {
VStack(alignment: .leading, spacing: 6) {
Text(title).font(.title2)
Text(subtitle).font(.subheadline)
}
}
private var filters: some View {
ScrollView(.horizontal, showsIndicators: false) {
HStack {
ForEach(filterOptions, id: \.self) { option in
FilterChip(option: option, isSelected: option == selectedFilter)
.onTapGesture { selectedFilter = option }
}
}
}
}
Ejemplo (extrayendo una vista computada compleja):
private var header: some View {
HeaderSection(title: title, subtitle: subtitle, status: status)
}
private struct HeaderSection: View {
let title: String
let subtitle: String?
let status: Status
var body: some View {
VStack(alignment: .leading, spacing: 4) {
Text(title).font(.headline)
if let subtitle { Text(subtitle).font(.subheadline) }
StatusBadge(status: status)
}
}
}
4) Manejo de view models (solo si ya existen)
- No introducir un view model a menos que la solicitud o el código existente claramente lo requiera.
- Si existe un view model, hacerlo no opcional cuando sea posible.
- Pasar dependencias a la vista mediante
init, luego pasarlas al view model en elinitde la vista. - Evitar patrones
bootstrapIfNeeded.
Ejemplo (basado en Observation):
@State private var viewModel: SomeViewModel
init(dependency: Dependency) {
_viewModel = State(initialValue: SomeViewModel(dependency: dependency))
}
5) Uso de Observation
- Para tipos de referencia
@Observable, almacenarlos como@Stateen la vista raíz. - Pasar observables hacia abajo explícitamente según sea necesario; evitar estado opcional a menos que sea obligatorio.
Flujo de trabajo
- Reordenar la vista para que coincida con las reglas de ordenamiento.
- Favorecer MV: mover orquestación ligera a la vista usando
@State,@Environment,@Query,taskyonChange. - Si existe un view model, reemplazar view models opcionales con un
@Stateview model no opcional inicializado eninitpasando dependencias desde la vista. - Confirmar uso de Observation:
@Statepara view models@Observableraíz, sin wrappers redundantes. - Mantener el comportamiento intacto: no cambiar diseño ni lógica de negocio a menos que se solicite.
Notas
- Preferir helpers pequeños y explícitos sobre bloques condicionales grandes.
- Mantener constructores de vista computados debajo de
bodyy vars computados que no sean de vista arriba deinit. - Para orientación y fundamentos de MV, consultar
references/mv-patterns.md.