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("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 のドキュメントを推奨します。