Recursos do SwiftUI 26
Visão Geral
Guia abrangente sobre os novos recursos do SwiftUI no iOS 26, iPadOS 26, macOS Tahoe, watchOS 26 e visionOS 26. Do sistema de design Liquid Glass à edição de texto rico, essas melhorias tornam o SwiftUI mais poderoso em todas as plataformas Apple.
Princípio central Desde melhorias de desempenho de baixo nível até os botões na sua interface de usuário, há grandes melhorias em todo o sistema.
Quando Usar Este Skill
- Adotando o sistema de design Liquid Glass
- Implementando edição de texto rico com AttributedString
- Incorporando conteúdo web com WebView
- Otimizando desempenho de lista e rolagem
- Usando a macro @Animatable para animações customizadas
- Construindo layouts espaciais 3D no visionOS
- Fazendo ponte de cenas SwiftUI para UIKit/AppKit
- Implementando arrastar e soltar com múltiplos itens
- Criando gráficos 3D com Chart3D
- Adicionando widgets ao visionOS ou CarPlay
- Adicionando marcas de escala personalizadas a controles deslizantes (marcadores de capítulo, indicadores de valor)
- Restringindo intervalos de seleção de controles deslizantes com
enabledBounds - Personalizando a aparência de controles deslizantes (visibilidade do polegar, rótulos de valor atual)
- Criando barras de área segura adesivas com efeitos de desfoque
- Abrindo URLs no navegador do aplicativo
- Usando botões de fechar e confirmar com estilo do sistema
- Aplicando estilos de botão vítreo (iOS 26.1+)
- Controlando o comportamento de dimensionamento de botões
- Implementando barras de ferramentas de pesquisa compactas
- Ajustando altura da linha ou espaçamento entre linhas base para texto
Requisitos de Sistema
iOS 26+, iPadOS 26+, macOS Tahoe+, watchOS 26+, visionOS 26+
Sistema de Design Liquid Glass
Para cobertura abrangente, veja axiom-liquid-glass (princípios de design, variantes, revisão de pressão) e axiom-liquid-glass-ref (guia de adoção em todo o aplicativo). Esta seção cobre apenas APIs específicas da WWDC 256.
Adoção Automática
Recompile com o SDK do iOS 26 — contêineres de navegação, barras de guias, barras de ferramentas, alternadores, seletores segmentados e controles deslizantes adotam automaticamente o novo design. Botões com borda assumem formato de cápsula por padrão. As planilhas ganham fundo Liquid Glass (remova qualquer personalização presentationBackground).
APIs de Barra de Ferramentas (iOS 26)
ToolbarSpacer
.toolbar {
ToolbarItem(placement: .bottomBar) { Button("Arquivar", systemImage: "archivebox") { } }
ToolbarSpacer(.flexible, placement: .bottomBar) // Empurra itens para os lados
ToolbarItem(placement: .bottomBar) { Button("Compor", systemImage: "square.and.pencil") { } }
}
// .fixed separa grupos visualmente; .flexible empurra para os lados (como Spacer em HStack)
ToolbarItemGroup (Agrupamento Visual)
Itens em um ToolbarItemGroup compartilham um único fundo vítreo "pill". ToolbarItemPlacement controla a aparência visual: confirmationAction → estilo glassProminent, cancellationAction → vidro padrão. Use .sharedBackgroundVisibility(.hidden) para excluir itens (por exemplo, avatares) do fundo do grupo.
Transformação de Barra de Ferramentas
Anexe .toolbar {} a visualizações individuais dentro de NavigationStack (não ao próprio NavigationStack). O iOS 26 transforma entre barras de ferramentas por visualização durante push/pop. Use toolbar(id:) com ToolbarItem(id:) correspondente entre telas para itens que devem permanecer estáveis (sem salto):
// MailboxList
.toolbar(id: "main") {
ToolbarItem(id: "filter", placement: .bottomBar) { Button("Filtrar") { } }
ToolbarSpacer(.flexible, placement: .bottomBar)
ToolbarItem(id: "compose", placement: .bottomBar) { Button("Nova Mensagem") { } }
}
// MessageList — "filter" ausente (anima para fora), "compose" permanece estável
.toolbar(id: "main") {
ToolbarSpacer(.flexible, placement: .bottomBar)
ToolbarItem(id: "compose", placement: .bottomBar) { Button("Nova Mensagem") { } }
}
#1 pegadinha: Barra de ferramentas em NavigationStack = nada para transformar.
DefaultToolbarItem
Reposicione itens fornecidos pelo sistema (como pesquisa) dentro do layout da sua barra de ferramentas:
DefaultToolbarItem(kind: .search, placement: .bottomBar)
// Substitui o posicionamento padrão do sistema do tipo correspondente
Use em uma barra lateral NavigationSplitView recolhida para especificar qual coluna mostra a pesquisa no iPhone. Envolva em if #available(iOS 26.0, *) para compatibilidade reversa.
Barras de Ferramentas Personalizáveis pelo Usuário
toolbar(id:) permite personalização pelo usuário (reorganizar, mostrar/ocultar). Apenas itens .secondaryAction suportam personalização no iPadOS. Use showsByDefault: false para itens opcionais. Adicione ToolbarCommands() para item de menu no macOS.
Outros Recursos de Barra de Ferramentas
.navigationSubtitle("3 não lidas")— Linha secundária abaixo do título.badge(3)em itens da barra de ferramentas — Contagens de notificação- Renderização de ícone monocromático — Reduz ruído visual; use matiz para significado, não para decoração
- Desfoque de borda de rolagem — Automático, sem código necessário
Pesquisa Alinhada na Parte Inferior
APIs de pesquisa fundamentais: Veja axiom-swiftui-search-ref. Esta seção cobre apenas refinamentos do iOS 26.
NavigationSplitView {
List { }.searchable(text: $searchText)
}
// Alinhado na parte inferior no iPhone, no topo à direita no iPad (automático)
// Use placement: .sidebar para restaurar a pesquisa incorporada na barra lateral no iPad
searchToolbarBehavior(.minimize)— Pesquisa compacta que expande ao tocarTab(role: .search)— Guia de pesquisa dedicada; campo de pesquisa substitui a barra de guias. Veja swiftui-nav-ref Seção 5.7
Efeito Vítreo para Visualizações Personalizadas
Button("Para o Topo", systemImage: "chevron.up") { scrollToTop() }
.padding()
.glassEffect() // Adicione .interactive para controles personalizados no iOS
GlassEffectContainer— Necessário quando vários elementos vítreos estão próximos (vidro não pode amostrar vidro)glassEffectID(_:in:)— Transições de transformação fluidas entre elementos vítreos usando um namespace- Transformação de planilha — Use
.matchedTransitionSource+.navigationTransition(.zoom(...))para transformar planilhas a partir de botões
Alterações em Botões e Controles
- Forma de cápsula padrão para botões com borda (substitua com
.buttonBorderShape(.roundedRectangle)) .controlSize(.extraLarge)— Novo tamanho de botão extra-grande.controlSize(.small)em contêineres — Preserva densidade pré-iOS 26GlassButtonStyle(.clear/.glass/.tint)— Variantes de botão vítreo (iOS 26.1+).buttonSizing(.fit/.stretch/.flexible)— Controla comportamento de layout do botãoButton(role: .close)/Button(role: .confirm)— Botões de fechar/confirmar com estilo do sistema.clipShape(.rect(cornerRadius: 12, style: .containerConcentric))— Concentricidade de canto- Menus: ícones na borda esquerda, consistente iOS/macOS
Melhorias em Controles Deslizantes
O iOS 26 adiciona marcas de escala personalizadas, intervalos de seleção restritos, rótulos de valor atual e controle de visibilidade do polegar.
Marcas de Escala em Controles Deslizantes
Tipos principais: SliderTick<V>, SliderTickContentForEach, SliderTickBuilder
// Marcas estáticas com rótulos
Slider(value: $value, in: 0...10) {
Text("Avaliação")
} ticks: {
SliderTick(0) { Text("Mín") }
SliderTick(5) { Text("Méd") }
SliderTick(10) { Text("Máx") }
}
// Marcas dinâmicas de uma coleção
SliderTickContentForEach(stops, id: \.self) { value in
SliderTick(value) { Text("\(Int(value))°").font(.caption2) }
}
// Marcas baseadas em passo (chamado para cada valor de passo)
Slider(value: $volume, in: 0...10, step: 2, label: { Text("Volume") }, tick: { value in
SliderTick(value) { Text("\(Int(value))") }
})
Restrição da API: SliderTickContentForEach requer que Data.Element corresponda ao tipo de valor SliderTick<V>. Para structs personalizadas, extraia valores numéricos: chapters.map(\.time) e depois procure rótulos via chapters.first(where: { $0.time == time }).
Controle Deslizante Completo
Slider(
value: $rating, in: 0...100,
neutralValue: 50, // Ponto inicial / valor central
enabledBounds: 20...80, // Restringir intervalo selecionável
label: { Text("Avaliação") },
currentValueLabel: { Text("\(Int(rating))") },
minimumValueLabel: { Text("0") },
maximumValueLabel: { Text("100") },
ticks: { SliderTick(50) { Text("Méd") } },
onEditingChanged: { editing in print(editing ? "Iniciado" : "Finalizado") }
)
sliderThumbVisibility
.sliderThumbVisibility(.hidden) — Ocultar polegar para indicadores de progresso de mídia e UI mínima. Opções: .automatic, .visible, .hidden. Sempre visível no watchOS.
Novos Modificadores de Visualização
safeAreaBar
Barras adesivas com desfoque progressivo integrado:
List { ForEach(1...20, id: \.self) { Text("\($0). Item") } }
.safeAreaBar(edge: .bottom) {
Text("Barra de Ação Inferior").padding(.vertical, 15)
}
.scrollEdgeEffectStyle(.soft, for: .bottom) // ou .hard
Funciona como safeAreaInset mas com desfoque. A barra permanece fixa enquanto o conteúdo rola abaixo.
Melhoria em onOpenURL
@Environment(\.openURL) var openURL
// openURL(url, prefersInApp: true) — Abre em navegador no aplicativo estilo SFSafariViewController
// Link padrão abre no Safari; prefersInApp mantém os usuários no seu aplicativo
searchToolbarBehavior
Veja axiom-swiftui-search-ref para APIs .searchable fundamentais. O iOS 26 adiciona:
.searchable(text: $searchText)
.searchToolbarBehavior(.minimize) // Botão compacto, expande ao tocar
Também: .searchPresentationToolbarBehavior(.avoidHidingContent) (iOS 17.1+) mantém o título visível durante a pesquisa.
Wrapper compatível reversamente para aplicativos que visam iOS 18+26:
extension View {
@ViewBuilder func minimizedSearch() -> some View {
if #available(iOS 26.0, *) {
self.searchToolbarBehavior(.minimize)
} else { self }
}
}
// Uso
.searchable(text: $searchText)
.minimizedSearch()
Padrão de disponibilidade para itens de barra de ferramentas:
.toolbar {
if #available(iOS 26.0, *) {
DefaultToolbarItem(kind: .search, placement: .bottomBar)
ToolbarSpacer(.flexible, placement: .bottomBar)
}
ToolbarItem(placement: .bottomBar) {
NewNoteButton()
}
}
.searchable(text: $searchText)
Funções de botão, GlassButtonStyle, buttonSizing — Veja a seção Sistema de Design Liquid Glass acima.
lineHeight (iOS 26)
Define a distância entre linhas de base do texto. Mais intuitivo que .lineSpacing() que mede do final de uma linha ao início da próxima.
Predefinições
Text("Lorem ipsum...")
.lineHeight(.loose) // Espaçamento aumentado para layouts abertos
.lineHeight(.tight) // Espaçamento reduzido para layouts compactos
.lineHeight(.normal) // Altura constante baseada em múltiplo do tamanho do ponto
.lineHeight(.variable) // Usa métricas de fonte para cálculo de altura
Controle Preciso
// Escala proporcionalmente ao tamanho da fonte
Text("Escala com tamanho do texto")
.lineHeight(.multiple(factor: 2))
// Relativo ao tamanho do ponto com aumento fixo
Text("Relativo ao tamanho do ponto")
.lineHeight(.leading(increase: 30))
// Valor fixo absoluto — NÃO escala com Dynamic Type
Text("Altura fixa")
.lineHeight(.exact(points: 30))
Suporte a AttributedString
var s = AttributedString("Parágrafo\ncom várias\nlinhas.")
s.lineHeight = .exact(points: 32)
s.lineHeight = .multiple(factor: 2.5)
s.lineHeight = .loose
Comparação com APIs Existentes
| API | Mede | Disponível |
|---|---|---|
.lineHeight() | Linha de base a linha de base | iOS 26+ |
.lineSpacing() | Final da linha ao início da próxima | iOS 13+ |
.font(.body.leading(.tight)) | Predefinição de entrelinhamento no nível da fonte | iOS 14+ |
Referência cruzada axiom-typography-ref — Sistema de tipografia completo incluindo Dynamic Type, tracking e internacionalização
Melhorias no iPad
Barra de Menu
Acesse ações comuns via menu deslizante para baixo
.commands {
TextEditingCommands() // Mesma API da barra de menu do macOS
CommandGroup(after: .newItem) {
Button("Adicionar Nota") {
addNote()
}
.keyboardShortcut("n", modifiers: [.command, .shift])
}
}
// Cria barra de menu no iPad quando as pessoas deslizam para baixo
Janelas Redimensionáveis
Redimensionamento fluido no iPad
// MIGRAÇÃO NECESSÁRIA:
// Remova a chave de lista de propriedades obsoleta no iPadOS 26:
// UIRequiresFullscreen (chave inteira obsoleta, todos os valores)
// Para navegação em visualização dividida, o sistema mostra/oculta colunas automaticamente
// com base no espaço disponível durante o redimensionamento
NavigationSplitView {
Sidebar()
} detail: {
Detail()
}
// Adapta-se ao redimensionamento automaticamente
Referência "Eleve o design do seu aplicativo para iPad" (WWDC 2025)
Melhorias em Janelas no macOS
Animações de Redimensionamento de Janela Sincronizadas
.windowResizeAnchor(.topLeading) // Personalize onde a animação se origina
// O SwiftUI agora sincroniza a animação entre mudanças de tamanho da visualização de conteúdo
// e redimensionamento da janela - ótimo para preservar continuidade ao alternar guias
Melhorias de Desempenho
Desempenho de Lista (Foco no macOS)
Ganhos massivos para listas grandes
- Carregamento 6x mais rápido para listas de 100.000+ itens no macOS
- Atualizações 16x mais rápidas para listas grandes
- Ganhos ainda maiores para listas maiores
- Melhorias beneficiam todas as plataformas (iOS, iPadOS, watchOS)
List(trips) { trip in // 100k+ itens
TripRow(trip: trip)
}
// Carrega 6x mais rápido, atualiza 16x mais rápido no macOS (iOS 26+)
Desempenho de Rolagem
Quadros perdidos reduzidos
O SwiftUI melhorou o agendamento de atualizações de interface do usuário no iOS e macOS. Isso melhora a capacidade de resposta e permite que o SwiftUI faça ainda mais trabalho para se preparar para quadros futuros. No geral, reduz a chance de seu aplicativo perder um quadro ao rolar rapidamente em altas taxas de quadros.
ScrollViews Aninhadas com Stacks Preguiçosos
Carrosséis de fotos e rolagem multieixo
ScrollView(.horizontal) {
LazyHStack {
ForEach(photoSets) { photoSet in
ScrollView(.vertical) {
LazyVStack {
ForEach(photoSet.photos) { photo in
PhotoView(photo: photo)
}
}
}
}
}
}
// ScrollViews aninhadas agora atrasam corretamente o carregamento com stacks preguiçosos
// Ótimo para construir carrosséis de fotos
Instrumento de Desempenho do SwiftUI
Nova ferramenta de perfilagem no Xcode
Faixas disponíveis:
- Atualizações longas de corpo de visualização — Identifique cálculos caros de corpo
- Atualizações de visualização da plataforma — Rastreie...