🫧

Liquid Glass APIの実装 + 画面サンプル【オプション編1】

に公開

前回の記事では、iOS 26から導入されたLiquid Glassの基本的なAPIを紹介しました。

本記事では各APIに渡せるオプションをまとめます。

前回の記事

https://zenn.dev/1stscratch/articles/1cc82073574d51

オプション一覧

対象 オプション 内容
Glass .regular / .clear / .identity ガラスの種類(標準・高透明・無効)
Glass .tint(_:) ガラスに色を付ける
Glass .interactive() タップ・ドラッグに反応させる
.glassEffect() in: ガラスの形を指定する
ボタン .glassProminent 強調表示のガラスボタン
ボタン .buttonBorderShape(_:) / .controlSize(_:) ボタンの形・サイズ
コンテナ GlassEffectContainer(spacing:) ガラス同士が融合する距離
コンテナ .glassEffectUnion(id:namespace:) 離れた要素を1つのガラスにまとめる
トランジション .matchedGeometry / .materialize / .identity 出現・消滅のアニメーションの種類

1. Glass(ガラスの種類)

.glassEffect()の第1引数にはGlass型を渡せます。
引数を省略した場合は.regularが使われます。

種類 内容
.regular 標準のガラス。背景をぼかしつつ、文字やアイコンが読みやすいよう調整される
.clear 透明度の高いガラス。写真や動画など、背景を見せたい場面向け
.identity ガラスを適用しない(見た目上は何もしない)

.clear

.clearは背景がはっきり透けるぶん、アイコンが見づらくなることがあります。
Appleのガイドラインでも、.clearは背景がメディアコンテンツ(写真や動画、イラストなど)で、かつ上に載せる内容が太字・明るい色など視認性を確保できる場合に使うことが推奨されています。

ライトモード

タスク一覧 画像

ダークモード

タスク一覧 画像
TaskMenu.swift
import SwiftUI

struct TaskMenu: View {
    @State private var selectedTab: MenuItem = .list

    enum MenuItem: String, CaseIterable {
        case list = "list.bullet"
        case add = "plus"
        case search = "magnifyingglass"
        case settings = "gearshape"
    }

    var body: some View {
        HStack(spacing: 28) {
            ForEach(MenuItem.allCases, id: \.self) { item in
                Button {
                    selectedTab = item
                } label: {
                    Image(systemName: item.rawValue)
                        .frame(width: 45, height: 45)
                }
                .buttonStyle(.plain)
            }
        }
        .padding(.horizontal, 25)
        .padding(.vertical, 12)
        .glassEffect(.clear) // .clear
    }
}

.identity

.identityは「ガラスを付けない」指定です。
if文でモディファイアを付け外しするとViewの同一性が変わりアニメーションが崩れるため、条件によってガラスのON/OFFを切り替えたい場合に使います。

ライトモード

タスク一覧 画像

ダークモード

タスク一覧 画像
TaskMenu.swift(抜粋)
@State private var isGlassEnabled = false //コードに追記

// ...

.glassEffect(isGlassEnabled ? .regular : .identity) //コードを上書き

2. .tint(_:)(色を付ける)

Glassに.tint(_:)を付けると、ガラスに色味を付けられます。
単色で塗りつぶすのではなく、ガラスの質感を保ったまま色が乗るのが特徴です。

TaskMenu.swift(抜粋)
.glassEffect(.regular.tint(.blue))

// 不透明度を下げて、うっすら色を付ける
.glassEffect(.regular.tint(.orange.opacity(0.6)))

表示中の画面(タスク一覧)のボタンだけ色を付ける例です。

ライトモード

タスク一覧 画像

ダークモード

タスク一覧 画像
TaskMenu.swift
import SwiftUI

struct TaskMenu: View {
    @State private var selectedTab: MenuItem = .list

    enum MenuItem: String, CaseIterable {
        case list = "list.bullet"
        case add = "plus"
        case search = "magnifyingglass"
        case settings = "gearshape"
    }

    var body: some View {
        GlassEffectContainer(spacing: 20) {
            HStack(spacing: 20) {
                ForEach(MenuItem.allCases, id: \.self) { item in
                    Button {
                        withAnimation {
                            selectedTab = item
                        }
                    } label: {
                        Image(systemName: item.rawValue)
                            .frame(width: 45, height: 45)
                    }
                    .buttonStyle(.plain)
                    .glassEffect(
                        selectedTab == item
                            ? .regular.tint(.blue) // 選択中のみ色付き
                            : .regular
                    )
                }
            }
        }
    }
}

3. .interactive()(タップに反応させる)

.interactive()を付けると、タップやドラッグに対してガラスが押し込まれる・光る・揺れるといったリアクションをするようになります。
.buttonStyle(.glass)のボタンには最初からこの動きが入っていますが、.glassEffect()を付けた任意のViewにも同じ動きを付けられます。

TaskMenu.swift(抜粋)
.glassEffect(.regular.interactive())

.tint()と組み合わせることもできます。

TaskMenu.swift(抜粋)
.glassEffect(.regular.tint(.blue).interactive())

ButtonではなくonTapGestureでタップを検知しているViewでも、タッチ時のリアクションが表示されます。

ライトモード

タスク一覧 画像

ダークモード

タスク一覧 画像
TaskMenu.swift
import SwiftUI

struct TaskMenu: View {
    @State private var count = 0

    var body: some View {
        Text("タップ回数: \(count)")
            .font(.headline)
            .padding(.horizontal, 24)
            .padding(.vertical, 14)
            .glassEffect(.regular.interactive()) // .interactive()
            .onTapGesture {
                count += 1
            }
    }
}

4. in:(ガラスの形)

.glassEffect()のin:引数にShapeを渡すと、ガラスの形を変更できます。
デフォルトはカプセル型です。

指定 形
省略 カプセル型
.capsule カプセル型
.circle 円
.ellipse 楕円
.rect(cornerRadius:) 角丸四角
RoundedRectangle(cornerRadius:style:) 角丸四角(styleで角の丸め方を指定)

ライトモード

タスク一覧 画像

ダークモード

タスク一覧 画像
TaskMenu.swift
import SwiftUI

struct TaskMenu: View {
    var body: some View {
        HStack(spacing: 20) {
            Image(systemName: "capsule")
                .frame(width: 70, height: 45)
                .glassEffect() // デフォルト(カプセル)

            Image(systemName: "circle")
                .frame(width: 50, height: 50)
                .glassEffect(in: .circle) // 円

            Image(systemName: "square")
                .frame(width: 50, height: 50)
                .glassEffect(in: .rect(cornerRadius: 12)) // 角丸四角

            Image(systemName: "square.dashed")
                .frame(width: 50, height: 50)
                .glassEffect(
                    .regular.tint(.pink),
                    in: RoundedRectangle(cornerRadius: 16, style: .continuous)
                ) // 種類 + 形の組み合わせ
        }
    }
}

5. ボタンのオプション

.glassProminent

.buttonStyle(.glass)のほかに、より目立つ.glassProminentがあります。
.glassProminentは色付きの不透明に近いガラスになり、「保存」「完了」など画面の主要なアクションに向いています。
色は.tint(_:)で変更できます(未指定の場合はアプリのアクセントカラー)。

.buttonBorderShape(:) / .controlSize(:)

ボタンの形は.buttonBorderShape(_:)、サイズは.controlSize(_:)で調整できます。

ライトモード

タスク一覧 画像

ダークモード

タスク一覧 画像
オプション 指定できる値
.buttonBorderShape(_:) .automatic / .capsule / .circle / .roundedRectangle / .roundedRectangle(radius:)
.controlSize(_:) .mini / .small / .regular / .large / .extraLarge
TaskMenu.swift
import SwiftUI

struct TaskMenu: View {
    @State private var selectedTab: MenuItem = .list

    enum MenuItem: String, CaseIterable {
        case list = "list.bullet"
        case add = "plus"
        case search = "magnifyingglass"
        case settings = "gearshape"
    }

    var body: some View {
        HStack(spacing: 16) {
            ForEach(MenuItem.allCases, id: \.self) { item in
                if item == .add {
                    // 追加ボタンのみ強調表示
                    Button {
                        selectedTab = item
                    } label: {
                        Image(systemName: item.rawValue)
                            .frame(width: 45, height: 45)
                    }
                    .buttonStyle(.glassProminent) // .glassProminent
                    .tint(.orange)
                } else {
                    Button {
                        selectedTab = item
                    } label: {
                        Image(systemName: item.rawValue)
                            .frame(width: 45, height: 45)
                    }
                    .buttonStyle(.glass)
                }
            }
        }
        .buttonBorderShape(.circle) // 全ボタンを円形に
        .controlSize(.large)        // 全ボタンを大きめに
    }
}

.buttonBorderShapeや.controlSizeは親Viewに付けると、中のボタン全てに適用されます。


6. GlassEffectContainerのオプション

spacing:

GlassEffectContainer(spacing:)のspacingは、ガラス同士が融合し始める距離です。
HStackのspacing(実際の配置の間隔)とは別物なので注意してください。

状態 見え方
要素の間隔 > コンテナのspacing ガラスは分離して表示される
要素の間隔 ≦ コンテナのspacing ガラス同士がくっついて表示される
TaskMenu.swift(抜粋)
// HStackの間隔(20)よりコンテナのspacing(40)が大きい → ガラスが融合して見える
GlassEffectContainer(spacing: 40) {
    HStack(spacing: 20) {
        // ...
    }
}

.glassEffectUnion(id:namespace:)

離れた位置にある要素同士を、1つのガラスとしてまとめて表示します。
コードで同じidとnamespaceを指定した要素が、1つのガラスで繋がります。

ライトモード

タスク一覧 画像

ダークモード

タスク一覧 画像
TaskMenu.swift
import SwiftUI

struct TaskMenu: View {
    @Namespace private var glassNamespace

    enum MenuItem: String, CaseIterable {
        case list = "list.bullet"
        case add = "plus"
        case search = "magnifyingglass"
        case settings = "gearshape"
    }

    var body: some View {
        GlassEffectContainer(spacing: 20) {
            HStack(spacing: 20) {
                ForEach(MenuItem.allCases, id: \.self) { item in
                    Image(systemName: item.rawValue)
                        .frame(width: 45, height: 45)
                        .glassEffect()
                        .glassEffectUnion(
                            // list / add と search / settings を別々のガラスにまとめる
                            id: (item == .list || item == .add) ? "group1" : "group2",
                            namespace: glassNamespace
                        ) // .glassEffectUnion(id:namespace:)
                }
            }
        }
    }
}

.glassEffectUnionでまとめる要素は、同じGlassの種類・同じ形である必要があります。


7. .glassEffectTransition(_:)の種類

前回の記事では.matchedGeometryを使いましたが、ほかにも種類があります。

種類 内容
.matchedGeometry 近くのガラスから分離・融合するように出現・消滅する
.materialize その場でガラスが浮かび上がる・溶けるように出現・消滅する
.identity アニメーションなし

ライトモード

タスク一覧 画像

ダークモード

タスク一覧 画像
TaskMenu.swift
import SwiftUI

struct TaskMenu: View {
    @State private var showExtraItem = false

    var body: some View {
        VStack(spacing: 16) {
            Button("要素を追加/削除") {
                withAnimation {
                    showExtraItem.toggle()
                }
            }

            GlassEffectContainer(spacing: 20) {
                HStack(spacing: 20) {
                    Image(systemName: "star.fill")
                        .frame(width: 45, height: 45)
                        .glassEffect()

                    if showExtraItem {
                        Image(systemName: "heart.fill")
                            .frame(width: 45, height: 45)
                            .glassEffect()
                            .glassEffectTransition(.materialize) // .matchedGeometry / .materialize / .identity
                    }
                }
            }
        }
    }
}

.matchedGeometryは近くにあるガラスから「生える」ような動き、.materializeは離れた位置に単独で出現させたい場合に向いています。

まとめ

Liquid Glassのオプションは既存のUIをある程度自由にカスタマイズできますが、その分Appleの「ヒューマンインターフェイスガイドライン」に注意する必要があります。

今回紹介した他にもタブやツールバーになどに適用できるオプションがあるので、次回はそちらの紹介をしたいと思います。

参考

ファースト・スクラッチTech Blog

Discussion