Communitygithub.com

steipete/swiftui-liquid-glass

SwiftUI Liquid Glass:實作、採用、重構,審查正確性/效能/設計。

swiftui-liquid-glass 是什麼?

此技能用於開發或審查完全符合 iOS 26+ Liquid Glass API 的 SwiftUI 功能。它優先使用原生 API(如 `glassEffect`、`GlassEffectContainer` 及玻璃按鈕樣式),並遵循 Apple 的設計指引。技能提供明確的工作流程決策樹,涵蓋審查現有功能、改進既有功能以及實作全新功能三種情境。透過詳細的檢查清單和實作清單,確保正確的修飾器順序、視覺一致性、效能最佳化,並妥善處理 iOS 版本相容性與降級方案。此技能特別適合開發者在使用如 Claude Code、Cursor 或 Codex 等 AI 代理工具時,快速生成或驗證 Liquid Glass 相關的 SwiftUI 程式碼。

相容平台~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

歸因:複製自 @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()。
  • 轉場:使用搭配 @Namespace 的 glassEffectID 實現變形效果。
  • 一致性:形狀、色調和間距在功能中保持一致。

實作檢查清單

  • 定義目標元素及所需的玻璃突顯程度。
  • 將分組的玻璃元素包裹在 GlassEffectContainer 中並調整間距。
  • 根據需要使用 .glassEffect(.regular.tint(...).interactive(), in: .rect(cornerRadius: ...))。
  • 對操作使用 .buttonStyle(.glass) / .buttonStyle(.glassProminent)。
  • 當視圖層級變化時,使用 glassEffectID 添加變形轉場。
  • 為較早的 iOS 版本提供降級材質和視覺效果。

快速範例程式碼

直接使用這些模式,並根據需要調整形狀、色調和間距。

if #available(iOS 26, *) {
    Text("你好")
        .padding()
        .glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
    Text("你好")
        .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("確認") { }
    .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.

相關技能