Communitygithub.com

steipete/swiftui-liquid-glass

SwiftUI Liquid Glass:实现、采用、重构,审查正确性/性能/设计。

swiftui-liquid-glass 是什么?

该技能专为在iOS 26+项目中高效构建或审查基于Liquid Glass API的SwiftUI界面而设计。它帮助开发者优先使用原生API(如glassEffect、GlassEffectContainer和玻璃按钮样式),而非自定义模糊效果,确保与Apple的设计指南高度一致。技能提供了一套结构化的工作流决策树,涵盖审查现有功能、改进现有功能以及全新实现三种场景,并给出了清晰的实施步骤。核心指南强调了修饰符的正确顺序(布局/外观修饰符在前,glassEffect在后)、形状一致性以及可用性处理(必须使用#available(iOS 26, *)并准备非玻璃后备方案)。此外,技能还包含了详细的审查清单(检查可用性、组合、修饰符顺序、交互性、过渡和一致性)以及可直接复制使用的代码片段示例,帮助开发者快速上手并保持代码的高质量与性能。该技能适用于Claude Code、Cursor、Codex等AI辅助开发工具。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/swiftui-liquid-glass

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

SwiftUI Liquid Glass

Attribution: 从@Dimillian的Dimillian/Skills复制(2025-12-31)。

概述

使用此技能来构建或审查完全符合iOS 26+ Liquid Glass API的SwiftUI功能。优先使用原生API(glassEffect、GlassEffectContainer、玻璃按钮样式)和Apple的设计指南。保持用法一致性,必要时添加交互,并关注性能。

工作流决策树

根据请求选择匹配的路径:

1) 审查现有功能

  • 检查应在何处使用Liquid Glass以及何处不应使用。
  • 验证正确的修饰符顺序、形状用法和容器放置。
  • 检查iOS 26+的可用性处理并确保有合理的后备方案。

2) 使用Liquid Glass改进现有功能

  • 确定需要玻璃效果的目标组件(表面、标签、按钮、卡片)。
  • 当出现多个玻璃元素时,重构为使用GlassEffectContainer。
  • 仅为可点按或可聚焦的元素引入交互式玻璃效果。

3) 使用Liquid Glass实现新功能

  • 首先设计玻璃表面和交互(形状、突出程度、分组)。
  • 在布局/外观修饰符之后添加玻璃修饰符。
  • 仅在视图层次结构随动画变化时添加变形过渡。

核心指南

  • 优先使用原生Liquid Glass API而非自定义模糊。
  • 当多个玻璃元素共存时使用GlassEffectContainer。
  • 在布局和视觉修饰符之后应用.glassEffect(...)。
  • 对响应触摸/指针的元素使用.interactive()。
  • 保持相关元素之间的形状一致,以获得统一的外观。
  • 使用#available(iOS 26, *)进行门控,并提供非玻璃后备方案。

审查清单

  • 可用性: 存在#available(iOS 26, *)并带有后备UI。
  • 组合: 多个玻璃视图包裹在GlassEffectContainer中。
  • 修饰符顺序: glassEffect在布局/外观修饰符之后应用。
  • 交互性: 仅在存在用户交互的地方使用interactive()。
  • 过渡: 使用glassEffectID配合@Namespace实现变形效果。
  • 一致性: 整个功能中形状、色调和间距保持一致。

实现清单

  • 定义目标元素和期望的玻璃突出程度。
  • 将分组的玻璃元素包裹在GlassEffectContainer中并调整间距。
  • 根据需要使用.glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...))。
  • 为操作按钮使用.buttonStyle(.glass) / .buttonStyle(.glassProminent)。
  • 当层级变化时,使用glassEffectID添加变形过渡。
  • 为较旧的iOS版本提供后备材质和视觉样式。

快速代码片段

直接使用这些模式,并根据需要调整形状、色调和间距。

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)

资源

  • 参考指南:references/liquid-glass.md
  • 优先使用Apple文档获取最新的API详情。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

相关技能