SwiftUI Vidro Líquido

Visão Geral

Use esta habilidade para construir ou revisar recursos do SwiftUI que se alinham totalmente com a API de Vidro Líquido do iOS 26+. Priorize APIs nativas (glassEffect, GlassEffectContainer, estilos de botão de vidro) e as diretrizes de design da Apple. Mantenha o uso consistente, interativo quando necessário e atento ao desempenho.

Quando Usar

• Quando o usuário deseja adotar ou revisar o Vidro Líquido no SwiftUI UI.
• Quando você precisa do uso correto da API, tratamento de fallback ou ordem de modificadores para o Vidro Líquido.

Árvore de Decisão de Fluxo de Trabalho

Escolha o caminho que corresponde à solicitação:

1) Revisar um recurso existente

• Inspecione onde o Vidro Líquido deve ser usado e onde não deve.
• Verifique a ordem correta dos modificadores, o uso de formas e a colocação do contêiner.
• Verifique o tratamento da disponibilidade do iOS 26+ e fallbacks sensatos.

2) Melhorar um recurso usando Vidro Líquido

• Identifique componentes alvo para tratamento de vidro (superfícies, chips, botões, cartões).
• Refatore para usar GlassEffectContainer onde múltiplos elementos de vidro aparecem.
• Introduza vidro interativo apenas para elementos clicáveis ou focáveis.

3) Implementar um novo recurso usando Vidro Líquido

• Projete as superfícies de vidro e as interações primeiro (forma, proeminência, agrupamento).
• Adicione modificadores de vidro após os modificadores de layout/aparência.
• Adicione transições de morphing apenas quando a hierarquia de visualização muda com animação.

Diretrizes Principais

• Prefira APIs nativas de Vidro Líquido em vez de desfoques personalizados.
• Use GlassEffectContainer quando múltiplos elementos de vidro coexistirem.
• Aplique .glassEffect(...) após os modificadores de layout e visuais.
• Use .interactive() para elementos que respondem ao toque/ponteiro.
• Mantenha as formas consistentes entre elementos relacionados para um visual coeso.
• Controle com #available(iOS 26, *) e forneça um fallback sem vidro.

Checklist de Revisão

• Disponibilidade: #available(iOS 26, *) presente com UI de fallback.
• Composição: Múltiplas visualizações de vidro envolvidas em GlassEffectContainer.
• Ordem dos modificadores: glassEffect aplicado após modificadores de layout/aparência.
• Interatividade: interactive() apenas onde a interação do usuário existe.
• Transições: glassEffectID usado com @Namespace para morphing.
• Consistência: Formas, tingimento e espaçamento se alinham em todo o recurso.

Checklist de Implementação

• Defina os elementos alvo e a proeminência de vidro desejada.
• Envolva elementos de vidro agrupados em GlassEffectContainer e 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 de morphing com glassEffectID quando a hierarquia muda.
• Forneça materiais e visuais de fallback para versões anteriores do iOS.

Snippets Rápidos

Use esses padrões diretamente e adapte formas/tons/espaçamentos.

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 de API atualizados.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.