SwiftUI Liquid Glass
概要
このスキルは、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 - 最新のAPI詳細についてはAppleのドキュメントを推奨します。