O que SwiftUI Liquid Glass faz?
Visão Geral
Use esta skill para construir ou revisar funcionalidades SwiftUI que estejam totalmente alinhadas com a API Liquid Glass do iOS 26+. Priorize APIs nativas (glassEffect, GlassEffectContainer, estilos de botão glass) e as diretrizes de design da Apple. Mantenha o uso consistente, interativo quando necessário e consciente do desempenho.
Árvore de Decisão do Fluxo de Trabalho
Escolha o caminho que corresponde à solicitação:
1) Revisar uma funcionalidade existente
- Inspecione onde o Liquid Glass deve ser usado e onde não deve.
- Verifique a ordem correta dos modificadores, uso de formas e posicionamento dos contêineres.
- Verifique o tratamento de disponibilidade para iOS 26+ e fallbacks sensatos.
2) Melhorar uma funcionalidade usando Liquid Glass
- Identifique componentes alvo para tratamento glass (superfícies, chips, botões, cards).
- Refatore para usar
GlassEffectContaineronde vários elementos glass aparecem. - Introduza glass interativo apenas para elementos tocáveis ou focalizáveis.
3) Implementar uma nova funcionalidade usando Liquid Glass
- Projete as superfícies e interações glass primeiro (forma, destaque, agrupamento).
- Adicione modificadores glass após modificadores de layout/appearance.
- Adicione transições morphing apenas quando a hierarquia de visualização mudar com animação.
Diretrizes Principais
- Prefira APIs nativas de Liquid Glass em vez de desfoques personalizados.
- Use
GlassEffectContainerquando vários elementos glass coexistem. - Aplique
.glassEffect(...)após modificadores de layout e visuais. - Use
.interactive()para elementos que respondem a toque/pointer. - Mantenha formas consistentes em elementos relacionados para um visual coeso.
- Proteja com
#available(iOS 26, *)e forneça um fallback sem glass.
Lista de Verificação de Revisão
- Disponibilidade:
#available(iOS 26, *)presente com UI de fallback. - Composição: Várias visualizações glass encapsuladas em
GlassEffectContainer. - Ordem dos modificadores:
glassEffectaplicado após modificadores de layout/appearance. - Interatividade:
interactive()apenas onde existe interação do usuário. - Transições: Use
glassEffectIDcom@Namespacepara morphing. - Consistência: Formas, coloração e espaçamento alinhados em toda a funcionalidade.
Lista de Verificação de Implementação
- Defina os elementos alvo e o destaque desejado do glass.
- Encapsule elementos glass agrupados em
GlassEffectContainere ajuste o espaçamento. - Use
.glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...))conforme necessário. - Use
.buttonStyle(.glass)/.buttonStyle(.glassProminent)para ações. - Adicione transições morphing com
glassEffectIDquando a hierarquia mudar. - Forneça materiais e visuais de fallback para versões anteriores do iOS.
Snippets Rápidos
Use estes padrões diretamente e ajuste formas, cores e espaçamento.
if #available(iOS 26, *) {
Text("Hello")
.padding()
.glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
Text("Hello")
.padding()
.background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 16))
}
GlassEffectContainer(spacing: 24) {
HStack(spacing: 24) {
Image(systemName: "scribble.variable")
.frame(width: 72, height: 72)
.font(.system(size: 32))
.glassEffect()
Image(systemName: "eraser.fill")
.frame(width: 72, height: 72)
.font(.system(size: 32))
.glassEffect()
}
}
Button("Confirmar") { }
.buttonStyle(.glassProminent)
Recursos
- Guia de referência:
references/liquid-glass.md - Prefira a documentação da Apple para detalhes atualizados da API.