Refatoração de Views SwiftUI
Atribuição: copiado de @Dimillian's Dimillian/Skills (2025-12-31).
Visão Geral
Aplica uma estrutura consistente e um padrão de dependência a views SwiftUI, com foco em ordenação, padrões Model-View (MV), tratamento cuidadoso de view models e uso correto de Observation.
Diretrizes Principais
1) Ordenação da view (topo → base)
- Environment
private/publiclet@State/ outras propriedades armazenadasvarcomputada (não-view)initbody- construtores de view computados / outros helpers de view
- funções helper / assíncronas
2) Prefira padrões MV (Model-View)
- Padrão MV por padrão: Views são expressões de estado leves; models/services possuem a lógica de negócio.
- Favoreça
@State,@Environment,@Queryetask/onChangepara orquestração. - Injete serviços e models compartilhados via
@Environment; mantenha as views pequenas e componíveis. - Divida views grandes em subviews em vez de introduzir um view model.
3) Divida corpos grandes e propriedades de view
- Se
bodycrescer além de uma tela ou tiver várias seções lógicas, divida-o em subviews menores. - Extraia propriedades de view computadas grandes (
var header: some View { ... }) em tiposViewdedicados quando elas carregarem estado ou ramificação complexa. - É ok manter subviews relacionadas como propriedades de view computadas no mesmo arquivo; extraia para um struct
Viewautônomo apenas quando fizer sentido estruturalmente ou quando houver intenção de reuso. - Prefira passar pequenas entradas (dados, bindings, callbacks) em vez de reutilizar todo o estado da view pai.
Exemplo (extraindo uma seção):
var body: some View {
VStack(alignment: .leading, spacing: 16) {
HeaderSection(title: title, isPinned: isPinned)
DetailsSection(details: details)
ActionsSection(onSave: onSave, onCancel: onCancel)
}
}
Exemplo (body longo → body mais curto + views computadas no mesmo arquivo):
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 }
}
}
}
}
Exemplo (extraindo uma view computada complexa):
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) Tratamento de view model (apenas se já existir)
- Não introduza um view model a menos que a solicitação ou o código existente o exija claramente.
- Se um view model existir, torne-o não opcional quando possível.
- Passe dependências para a view via
inite depois passe-as para o view model noinitda view. - Evite padrões
bootstrapIfNeeded.
Exemplo (baseado em Observation):
@State private var viewModel: SomeViewModel
init(dependency: Dependency) {
_viewModel = State(initialValue: SomeViewModel(dependency: dependency))
}
5) Uso de Observation
- Para tipos de referência
@Observable, armazene-os como@Statena view raiz. - Passe observáveis explicitamente conforme necessário; evite estado opcional a menos que seja obrigatório.
Fluxo de Trabalho
- Reordene a view para corresponder às regras de ordenação.
- Favoreça MV: mova a orquestração leve para a view usando
@State,@Environment,@Query,taskeonChange. - Se um view model existir, substitua view models opcionais por um
@Stateview model não opcional inicializado noinitpassando dependências da view. - Confirme o uso de Observation:
@Statepara@Observableview models raiz, sem wrappers redundantes. - Mantenha o comportamento intacto: não altere layout ou lógica de negócio a menos que solicitado.
Notas
- Prefira helpers pequenos e explícitos a grandes blocos condicionais.
- Mantenha construtores de view computados abaixo de
bodye vars computadas não-view acima deinit. - Para orientação e fundamentação MV-first, consulte
references/mv-patterns.md.