Liquid Glass APIの実装 + 画面サンプル【オプション編1】
前回の記事では、iOS 26から導入されたLiquid Glassの基本的なAPIを紹介しました。
本記事では各APIに渡せるオプションをまとめます。
前回の記事
オプション一覧
| 対象 | オプション | 内容 |
|---|---|---|
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は背景がメディアコンテンツ(写真や動画、イラストなど)で、かつ上に載せる内容が太字・明るい色など視認性を確保できる場合に使うことが推奨されています。
ライトモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
ダークモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
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を切り替えたい場合に使います。
ライトモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
ダークモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
@State private var isGlassEnabled = false //コードに追記
// ...
.glassEffect(isGlassEnabled ? .regular : .identity) //コードを上書き
2. .tint(_:)(色を付ける)
Glassに.tint(_:)を付けると、ガラスに色味を付けられます。
単色で塗りつぶすのではなく、ガラスの質感を保ったまま色が乗るのが特徴です。
.glassEffect(.regular.tint(.blue))
// 不透明度を下げて、うっすら色を付ける
.glassEffect(.regular.tint(.orange.opacity(0.6)))
表示中の画面(タスク一覧)のボタンだけ色を付ける例です。
ライトモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
ダークモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
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にも同じ動きを付けられます。
.glassEffect(.regular.interactive())
.tint()と組み合わせることもできます。
.glassEffect(.regular.tint(.blue).interactive())
ButtonではなくonTapGestureでタップを検知しているViewでも、タッチ時のリアクションが表示されます。
ライトモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
ダークモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
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で角の丸め方を指定) |
ライトモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
ダークモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
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
|
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
|
ガラス同士がくっついて表示される |
// HStackの間隔(20)よりコンテナのspacing(40)が大きい → ガラスが融合して見える
GlassEffectContainer(spacing: 40) {
HStack(spacing: 20) {
// ...
}
}
.glassEffectUnion(id:namespace:)
離れた位置にある要素同士を、1つのガラスとしてまとめて表示します。
コードで同じidとnamespaceを指定した要素が、1つのガラスで繋がります。
ライトモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
ダークモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
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 |
アニメーションなし |
ライトモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
ダークモード
| タスク一覧 | 画像 |
|---|---|
![]() |
![]() |
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の「ヒューマンインターフェイスガイドライン」に注意する必要があります。
今回紹介した他にもタブやツールバーになどに適用できるオプションがあるので、次回はそちらの紹介をしたいと思います。
































Discussion