O que Padrões de UI em SwiftUI faz?
Início rápido
Escolha uma trilha baseada no seu objetivo:
Projeto existente
- Identifique a funcionalidade ou tela e o modelo de interação principal (lista, detalhe, editor, configurações, abas).
- Encontre um exemplo próximo no repositório com
rg "TabView\("ou similar, depois leia a view SwiftUI mais próxima. - Aplique as convenções locais: prefira estado nativo do SwiftUI, mantenha o estado local quando possível e use injeção de ambiente para dependências compartilhadas.
- Escolha a referência de componente relevante em
references/components-index.mde siga suas orientações. - Construa a view com subviews pequenas e focadas e fluxo de dados nativo do SwiftUI.
Scaffolding de novo projeto
- Comece com
references/app-scaffolding-wiring.mdpara configurar TabView + NavigationStack + sheets. - Adicione um
AppTabeRouterPathmínimos baseados nos esqueletos fornecidos. - Escolha a próxima referência de componente com base na UI que você precisa primeiro (TabView, NavigationStack, Sheets).
- Expanda os enums de rota e sheet conforme novas telas são adicionadas.
Regras gerais a seguir
- Use estado moderno do SwiftUI (
@State,@Binding,@Observable,@Environment) e evite view models desnecessários. - Prefira composição; mantenha as views pequenas e focadas.
- Use async/await com
.taske estados explícitos de carregamento/erro. - Mantenha os padrões legados existentes apenas ao editar arquivos legados.
- Siga o formatador e guia de estilo do projeto.
- Sheets: Prefira
.sheet(item:)em vez de.sheet(isPresented:)quando o estado representar um modelo selecionado. Eviteif letdentro do corpo de uma sheet. As sheets devem ser donas de suas ações e chamardismiss()internamente em vez de encaminhar closuresonCancel/onConfirm.
Fluxo de trabalho para uma nova view SwiftUI
- Defina o estado da view e sua localização de propriedade.
- Identifique dependências a serem injetadas via
@Environment. - Esboce a hierarquia da view e extraia partes repetidas em subviews.
- Implemente carregamento assíncrono com
.taske enum de estado explícito se necessário. - Adicione rótulos ou identificadores de acessibilidade quando a UI for interativa.
- Valide com uma compilação e atualize os locais de uso se necessário.
Referências de componentes
Use references/components-index.md como ponto de entrada. Cada referência de componente deve incluir:
- Intenção e cenários de melhor ajuste.
- Padrão de uso mínimo com convenções locais.
- Armadilhas e notas de desempenho.
- Caminhos para exemplos existentes no repositório atual.
Padrões de sheet
Sheet orientada por item (preferida)
@State private var selectedItem: Item?
.sheet(item: $selectedItem) { item in
EditItemSheet(item: item)
}
Sheet é dona de suas ações
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 ? "Salvando…" : "Salvar") {
Task { await save() }
}
}
}
private func save() async {
isSaving = true
await store.save(item)
dismiss()
}
}
Adicionando uma nova referência de componente
- Crie
references/<componente>.md. - Mantenha curto e acionável; vincule a arquivos concretos no repositório atual.
- Atualize
references/components-index.mdcom a nova entrada.