Refatoração de Visualização SwiftUI
Visão Geral
Aplica uma estrutura consistente e padrão de dependência a visualizações SwiftUI, com foco em ordenação, padrões Modelo-Visualização (MV), tratamento cuidadoso de modelos de visualização e uso correto de Observation.
Diretrizes Principais
1) Ordenação da visualização (de cima para baixo)
- Environment
private/publiclet@State/ outras propriedades armazenadasvarcomputada (não-visualização)initbody- construtores de visualização computados / outros auxiliares de visualização
- funções auxiliares / assíncronas
2) Prefira padrões MV (Modelo-Visualização)
- Padrão MV: visualizações são expressões de estado leves; modelos/serviços possuem a lógica de negócio.
- Favoreça
@State,@Environment,@Query, etask/onChangepara orquestração. - Injete serviços e modelos compartilhados via
@Environment; mantenha as visualizações pequenas e combináveis. - Divida visualizações grandes em subvisualizações em vez de introduzir um modelo de visualização.
3) Divida corpos grandes e propriedades de visualização
- Se
bodycrescer além de uma tela ou tiver várias seções lógicas, divida-o em subvisualizações menores. - Extraia propriedades de visualização computadas grandes (
var header: some View { ... }) para tiposViewdedicados quando eles carregam estado ou ramificações complexas. - É aceitável manter subvisualizações relacionadas como propriedades de visualização computadas no mesmo arquivo; extraia para uma struct
Viewindependente apenas quando fizer sentido estruturalmente ou quando a reutilização for pretendida. - Prefira passar entradas pequenas (dados, bindings, callbacks) em vez de reutilizar todo o estado da visualização 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 + visualizações 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 visualização 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 do modelo de visualização (apenas se já presente)
- Não introduza um modelo de visualização a menos que a solicitação ou o código existente claramente exija um.
- Se um modelo de visualização existir, torne-o não opcional quando possível.
- Passe dependências para a visualização via
init, depois passe-as para o modelo de visualização noinitda visualização. - 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 visualização raiz. - Passe observáveis explicitamente para baixo conforme necessário; evite estado opcional a menos que seja exigido.
Fluxo de Trabalho
- Reordenar a visualização para corresponder às regras de ordenação.
- Favorecer MV: mover orquestração leve para a visualização usando
@State,@Environment,@Query,taskeonChange. - Se um modelo de visualização existir, substituir modelos de visualização opcionais por um modelo de visualização
@Statenão opcional inicializado noinitpassando dependências da visualização. - Confirmar o uso de Observation:
@Statepara modelos de visualização@Observableraiz, sem wrappers redundantes. - Manter o comportamento intacto: não alterar layout ou lógica de negócio a menos que solicitado.
Notas
- Prefira auxiliares pequenos e explícitos em vez de grandes blocos condicionais.
- Mantenha construtores de visualização computados abaixo de
bodye vars computadas não-visualização acima deinit. - Para orientação e justificativa de padrões MV-first, consulte
references/mv-patterns.md.
Tratamento de Visualizações Grandes
- Quando um arquivo de visualização SwiftUI exceder ~300 linhas, divida-o usando extensões para agrupar auxiliares relacionados. Mova funções assíncronas e funções auxiliares para extensões
privatededicadas, separadas com comentários// MARK: -que descrevem seu propósito (por exemplo,// MARK: - Ações,// MARK: - Subvisualizações,// MARK: - Auxiliares). Mantenha astructprincipal focada em propriedades armazenadas, init ebody, com vars computadas de construção de visualização também agrupadas via marcas quando o arquivo for longo.