Liquid Glass 実装パターン
対象範囲
Xcode 27 でビルドする iOS 27 とネイティブの macOS 27 アプリを対象とし、各プラットフォームの最低対応 OS を 27.0 に設定する。SwiftUI を基本とし、独自の組み込みには iOS で UIKit、macOS で AppKit を使う。共有コードではプラットフォーム専用の API を分離する。API リファレンスを確認し、設計は Liquid Glass の設計に従う。
システムコンポーネントから始める
- 27 系 SDK が提供するシステムデザインを使う。標準のナビゲーション、タブバー、ツールバー、シート、メニューにはガラス背景を追加しない。
- 独自のバー背景、枠線、シートのスタイルでシステムのマテリアルを覆わない。設計上必要なカスタマイズだけを残し、結果を検証する。
ボタン
操作には Button とシステムのスタイルを優先する。破壊的な操作はロールで明示する。主要な操作を強調するスタイルは、破壊的な操作のロールを代替しない。
Button("Save", action: save)
.buttonStyle(.glassProminent)
Button("Cancel", action: cancel)
.buttonStyle(.glass)
Button("Delete", role: .destructive, action: delete)
.buttonStyle(.glass)
操作のクロージャはアプリ側で用意する。.glass(.clear) は設計文書の clear の使用条件を満たす場合に限る。UIKit の UIButton.Configuration には .glass()、.prominentGlass()、.clearGlass()、.prominentClearGlass() があり、AppKit ではボタンのベゼルに .glass を指定できる。
カスタムのガラス効果
サイズと外観を設定するモディファイアの後に glassEffect を適用する。標準は .regular のカプセル形状となる。コントロールの形状に必要な場合だけ、明示的に形状を指定する。
Text("3 selected")
.font(.headline)
.padding()
.glassEffect(in: .rect(cornerRadius: 16))
.interactive() が設定するのはマテリアルの反応である。操作、キーボードからの実行、アクセシビリティ特性は追加されない。操作可能な内容には Button を使う。macOS では SwiftUI の Glass.interactive(_:) または AppKit の effectIsInteractive を使い、マウス操作に適した反応を有効にする。
clear のガラス効果では背景も含めて設計する。Apple の例は効果の背後に不透明度 30% の黒を置く。実際の画像や動画に合わせて調整し、前景のコントラストを確認する。
Label("Flag", systemImage: "flag.fill")
.padding()
.glassEffect(.clear)
.background(.black.opacity(0.3))
コンテナー、モーフィング、結合
関連するカスタムのガラス効果を GlassEffectContainer にまとめ、システムが一緒に描画して形状を融合できるようにする。spacing は近接する形状が相互作用を始める距離を指定する。レイアウトの間隔より大きいと、静止時にも融合する場合がある。コンテナーは描画効率を改善するが、描画パス数を固定する保証はない。
要素の追加と削除には、同じ名前空間で安定した重複のない glassEffectID を使う。次のコントロールはボタンの意味を保ち、「視差効果を減らす」が有効な場合は独自のアニメーションを無効にする。
import SwiftUI
struct FloatingTools: View {
@Environment(\.accessibilityReduceMotion) private var reduceMotion
@Namespace private var namespace
@State private var isExpanded = false
let mark: () -> Void
var body: some View {
GlassEffectContainer(spacing: 24) {
HStack(spacing: 16) {
Button(isExpanded ? "Hide tools" : "Show tools",
systemImage: "slider.horizontal.3") {
withAnimation(reduceMotion ? nil : .smooth) {
isExpanded.toggle()
}
}
.glassEffectID("toggle", in: namespace)
if isExpanded {
Button("Mark", systemImage: "pencil", action: mark)
.glassEffectID("mark", in: namespace)
}
}
.buttonStyle(.glass)
.labelStyle(.iconOnly)
.controlSize(.large)
}
}
}
近い形状には .matchedGeometry、近くに適切な形状がない遷移には .materialize を使う。glassEffectTransition は glassEffect の後に置く。静的に結合する場合は、各効果の後に glassEffectUnion(id:namespace:) を適用する。結合用の識別子、名前空間、形状、ガラスのバリアントが一致する要素が 1 つの面になる。結合用の識別子はサーフェスのグループ分けに使い、モーフィングの ID は個々の要素の識別に使う。
タブバーとアクセサリビュー
- iPhone のレイアウトで最小化が有用な場合は、
TabViewに.tabBarMinimizeBehavior(.onScrollDown)を適用する。折りたたんだ後もナビゲーションを見つけやすくする。 - 再生操作などの常設コントロールには
.tabViewBottomAccessory { ... }を使う。アクセサリ内でtabViewBottomAccessoryPlacementを読み、.inline、.expanded、未定義のnilに応じて表示を変える。 - 検索の配置には
.searchableと検索タブのロールを使う。システムの外観を模倣するためだけに、独自の検索欄を重ねない。
ツールバーとナビゲーション
ToolbarSpacer(.fixed, placement:)で操作を機能別に分ける。伸縮する間隔には.flexibleを使う。独自の外観を持つツールバー項目にはsharedBackgroundVisibility(.hidden)を設定できる。- SwiftUI では条件分岐で
ToolbarItem自体を含めるかどうか決める。ラベルだけを隠すと、背景や空間が残る場合がある。UIKit ではUIBarButtonItem.isHiddenを使う。 - iOS 27 では
visibilityPriorityでオーバーフローの優先順位を指定し、常にメニューへ収める操作をToolbarOverflowMenuに置く。末尾に残す操作には.topBarPinnedTrailingを使う。後二者はネイティブの macOS では利用できない。プラットフォーム表を参照する。 - iOS 27 の
TabRole.prominentは末尾の独立したタブに使える。TabView内でラベルを備えたタブを定義する。ロールだけではタブの宣言は完成しない。
iOS ではナビゲーションバーの最小化 API を直接使う。以下の条件付きコンパイルは、iOS のナビゲーションバーの動作をネイティブ macOS のレイアウトから分離するためのものである。
#if os(iOS)
struct AdaptiveNavigation<Content: View>: View {
let content: Content
var body: some View {
NavigationStack {
content.toolbarMinimizationBehavior(
.onScrollDown, for: .navigationBar)
}
}
}
#endif
スクロール端と背景の延長
- スクロール端のスタイルは原則として自動のままにする。境界を明確にする必要がある場合だけ
.scrollEdgeEffectStyle(.hard, for: .top)を使う。nilで標準に戻る。自動スタイルは OS によって変わり得るため、新しい OS に対応する際は明示的な指定を見直す。 - UIKit では
UIScrollViewから各辺の効果を設定する。独自のオーバーレイはUIScrollEdgeElementContainerInteractionに登録し、別のぼかしを重ねない。 - 背景画像に
backgroundExtensionEffect()を適用してから、文字とコントロールをオーバーレイで追加する。操作部品を含むサイドバー全体には適用しない。UIKit と AppKit にはそれぞれUIBackgroundExtensionViewとNSBackgroundExtensionViewがある。
UIKit と AppKit への組み込み
UIKit のカスタムガラスでは、UIVisualEffectView.contentView に内容を追加し、効果のビューと内容の両方に制約を設ける。次の関数はサイズ制約を持つガラスラベルを作る。返されたビューの配置は呼び出し側で行う。
import UIKit
@MainActor
func makeGlassLabel() -> UIVisualEffectView {
let glass = UIVisualEffectView(effect: UIGlassEffect(style: .regular))
let label = UILabel()
label.text = "3 selected"
label.font = .preferredFont(forTextStyle: .headline)
label.adjustsFontForContentSizeCategory = true
label.translatesAutoresizingMaskIntoConstraints = false
glass.contentView.addSubview(label)
NSLayoutConstraint.activate([
label.leadingAnchor.constraint(equalTo: glass.contentView.leadingAnchor, constant: 16),
label.trailingAnchor.constraint(equalTo: glass.contentView.trailingAnchor, constant: -16),
label.topAnchor.constraint(equalTo: glass.contentView.topAnchor, constant: 12),
label.bottomAnchor.constraint(equalTo: glass.contentView.bottomAnchor, constant: -12)
])
return glass
}
- 隣接する複数の UIKit 効果は、
UIGlassContainerEffectを設定したUIVisualEffectViewのcontentView内に配置する。spacingが相互作用の距離を決める。 - macOS では
NSGlassEffectViewのcontentView、style、cornerRadiusと必要に応じてtintColorを設定する。関連するビューはNSGlassEffectContainerViewでまとめる。ボタンには.glassベゼルのNSButtonを優先する。 - マウス操作に反応する AppKit のガラスには
effectIsInteractive = trueを設定する。設計上の検証項目に沿って性能とアクセシビリティを確認する。