SwiftUI Liquid Glass
Atribuição: copiado de Dimillian/Skills de @Dimillian (2025-12-31).
Visão Geral
Use esta skill para construir ou revisar recursos SwiftUI que estejam totalmente alinhados com a API Liquid Glass do iOS 26+. Priorize APIs nativas (glassEffect, GlassEffectContainer, estilos de botão vítreo) e as diretrizes de design da Apple. Mantenha o uso consistente, interativo quando necessário e com atenção ao desempenho.
Árvore de Decisão do Fluxo de Trabalho
Escolha o caminho que corresponde à solicitação:
1) Revisar um recurso existente
- Inspecione onde o Liquid Glass deve ser usado e onde não deve.
- Verifique a ordem correta dos modificadores, o uso de formas e o posicionamento dos contêineres.
- Verifique o tratamento de disponibilidade para iOS 26+ e fallbacks sensíveis.
2) Melhorar um recurso usando Liquid Glass
- Identifique componentes alvo para o tratamento vítreo (superfícies, chips, botões, cartões).
- Refatore para usar
GlassEffectContaineronde múltiplos elementos vítreos aparecem. - Introduza vidro interativo apenas para elementos tocáveis ou focáveis.
3) Implementar um novo recurso usando Liquid Glass
- Projete as superfícies vítreas e as interações primeiro (forma, proeminência, agrupamento).
- Adicione modificadores vítreos após os modificadores de layout e aparência.
- Adicione transições morfológicas apenas quando a hierarquia de visualização mudar com animação.
Diretrizes Principais
- Prefira APIs nativas do Liquid Glass em vez de desfoques customizados.
- Use
GlassEffectContainerquando múltiplos elementos vítreos coexistem. - Aplique
.glassEffect(...)após modificadores de layout e visuais. - Use
.interactive()para elementos que respondem ao toque/ponteiro. - Mantenha as formas consistentes entre os elementos relacionados para uma aparência coesa.
- Proteja com
#available(iOS 26, *)e forneça um fallback não vítreo.
Lista de Verificação de Revisão
- Disponibilidade:
#available(iOS 26, *)presente com UI de fallback. - Composição: Múltiplas visualizações vítreas envolvidas em
GlassEffectContainer. - Ordem dos modificadores:
glassEffectaplicado após modificadores de layout e aparência. - Interatividade:
interactive()apenas onde existe interação do usuário. - Transições:
glassEffectIDusado com@Namespacepara morfismo. - Consistência: Formas, matizes e espaçamento alinhados em todo o recurso.
Lista de Verificação de Implementação
- Defina os elementos alvo e a proeminência vítrea desejada.
- Envolva elementos vítreos 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 morfológicas 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 adapte formas, matizes 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("Confirm") { }
.buttonStyle(.glassProminent)
Recursos
- Guia de referência:
references/liquid-glass.md - Prefira a documentação da Apple para detalhes atualizados da API.