¿Qué hace Refactorización de Vistas SwiftUI?
Resumen
Aplica una estructura y un patrón de dependencias consistentes a las vistas SwiftUI, centrándose en el orden, los patrones Modelo-Vista (MV), el manejo cuidadoso de los modelos de vista y el uso correcto de Observation.
Directrices Principales
1) Orden de la vista (de arriba a abajo)
- Environment
private/publiclet@State/ otras propiedades almacenadasvarcomputada (no vista)initbody- constructores de vista computados / otros ayudantes de vista
- funciones auxiliares / asíncronas
2) Preferir patrones MV (Modelo-Vista)
- Por defecto, usar MV: las vistas son expresiones de estado ligeras; los modelos/servicios son dueños de la lógica de negocio.
- Favorecer
@State,@Environment,@Query, ytask/onChangepara la orquestación. - Inyectar servicios y modelos compartidos a través de
@Environment; mantener las vistas pequeñas y componibles. - Dividir vistas grandes en subvistas en lugar de introducir un modelo de vista.
3) Dividir cuerpos grandes y propiedades de vista
- Si el
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 estas contengan estado o ramificaciones complejas. - Está bien mantener subvistas relacionadas como propiedades de vista computadas en el mismo archivo; extraer a un
structViewindependiente 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 del modelo de vista (solo si ya existe)
- No introducir un modelo de vista a menos que la solicitud o el código existente lo requieran claramente.
- Si existe un modelo de vista, hacerlo no opcional cuando sea posible.
- Pasar las dependencias a la vista a través de
init, luego pasarlas al modelo de vista en elinitde la vista. - Evitar los 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 los observables explícitamente según sea necesario; evitar el estado opcional a menos que sea requerido.
Flujo de trabajo
- Reordenar la vista para que coincida con las reglas de orden.
- Favorecer MV: mover la orquestación ligera a la vista usando
@State,@Environment,@Query,taskyonChange. - Si existe un modelo de vista, reemplazar los modelos de vista opcionales con un modelo de vista
@Stateno opcional inicializado eninitpasando las dependencias desde la vista. - Confirmar el uso de Observation:
@Statepara modelos de vista raíz@Observable, sin envoltorios redundantes. - Mantener el comportamiento intacto: no cambiar el diseño ni la lógica de negocio a menos que se solicite.
Notas
- Preferir ayudantes pequeños y explícitos sobre bloques condicionales grandes.
- Mantener los constructores de vista computados debajo de
bodyy las vars computadas que no son de vista arriba deinit. - Para orientación y fundamentos de MV primero, consultar
references/mv-patterns.md.
Manejo de vistas grandes
- Cuando un archivo de vista SwiftUI supere las ~300 líneas, dividirlo usando extensiones para agrupar ayudantes relacionados. Mover funciones asíncronas y funciones auxiliares a extensiones
privatededicadas, separadas con comentarios// MARK: -que describan su propósito (por ejemplo,// MARK: - Actions,// MARK: - Subviews,// MARK: - Helpers). Mantener elstructprincipal enfocado en propiedades almacenadas, init ybody, con vars computadas de construcción de vista también agrupadas mediante marcas cuando el archivo sea largo.