​

Apple UI Documentation Index

​

Quick Navigation

​

Liquid Glass Design

• Overview - Core concepts, platform availability
• AppKit Implementation - NSGlassEffectView usage
• SwiftUI Implementation - glassEffect() modifier
• Common Patterns - Reusable components & techniques

​

Toolbar Features

• SwiftUI Toolbar Features - Customization, search, transitions

​

API Quick Lookup

​

Liquid Glass APIs

​

Toolbar APIs

​

Decision Trees

​

When to Use Liquid Glass

Need glass effect?
├─ Single view → .glassEffect() / NSGlassEffectView
└─ Multiple views
   ├─ Need merging → Use Container
   └─ Independent → Individual glass effects

​

Choosing Framework

Platform target?
├─ iOS only → SwiftUI
├─ macOS only
│  ├─ Need AppKit integration → NSGlassEffectView
│  └─ Pure SwiftUI app → .glassEffect()
└─ Cross-platform → SwiftUI with platform checks

​

Performance Guidelines

​

Common Tasks

​

Create Glass Button

• SwiftUI: Button("Click").buttonStyle(.glass)
• AppKit: See Glass Button Pattern

​

Animate Glass Tint

• SwiftUI: .glassEffect(.regular.tint(condition ? .blue : .clear))
• AppKit: NSAnimationContext with animator().tintColor

​

Merge Glass Effects

• SwiftUI: Wrap in GlassEffectContainer(spacing: 40)
• AppKit: Use NSGlassEffectContainerView with spacing

​

Custom Toolbar

• SwiftUI: .toolbar(id: "main") with ToolbarItem(id: "item")

​

Platform Requirements

​

Migration Guide

​

AppKit → SwiftUI

// AppKit
let glass = NSGlassEffectView()
glass.cornerRadius = 16
glass.tintColor = NSColor.blue

// SwiftUI equivalent
View()
    .glassEffect(.regular.tint(.blue), in: .rect(cornerRadius: 16))

​

Old Toolbar → New Toolbar

// Old
.toolbar {
    Button("Save") { }
}

// New (customizable)
.toolbar(id: "main") {
    ToolbarItem(id: "save") {
        Button("Save") { }
    }
}

​

Resources

​

Apple Documentation

• NSGlassEffectView
• View.glassEffect
• CustomizableToolbarContent

​

Sample Projects

• Landmarks: Liquid Glass

​

WWDC Sessions

• Liquid Glass design principles
• Toolbar customization in SwiftUI