Blur, vibrancy, and elevation materials for surfaces and components.
Visual materials with blur, vibrancy, and elevation specifications.
.ultraThinMaterial
Lightweight overlays, subtle layering, minimal visual weight
.thinMaterial
Subtle layering, light overlays, navigation elements
.regularMaterial
Standard overlays, modal backgrounds, sidebars
.thickMaterial
More separation from background, inspectors, panels
.ultraThickMaterial
Maximum separation, high contrast requirement, alerts
.bar
Navigation bars, tab bars, toolbars, system UI
.chromeless
Backgrounds without visible blur edge, seamless integration
.systemBackground
Primary view backgrounds, main content areas
.secondarySystemBackground
Grouped content backgrounds, secondary areas
.tertiarySystemBackground
Nested content within grouped areas
.systemGroupedBackground
Settings-style grouped table backgrounds
.secondarySystemGroupedBackground
Table cells in grouped style
.tertiarySystemGroupedBackground
Nested elements within grouped cells
.label
Primary text on materials, highest contrast
.secondaryLabel
Secondary text, captions, descriptions
.tertiaryLabel
Tertiary text, disabled states, hints
.quaternaryLabel
Lowest priority text, watermarks, placeholder text
.fill
Fills and backgrounds on materials, selection highlights
.secondaryFill
Secondary fill areas, backgrounds for controls
.tertiaryFill
Tertiary fill, subtle backgrounds
.quaternaryFill
Lowest opacity fills, hover states
.separator
Dividers between content, list separators
.opaqueSeparator
Full-opacity separators, section dividers
0
Base layer, deepest content, root backgrounds
1
Cards, grouped backgrounds, first level of lift
2
Popovers, sheets, second level of lift
3
Modals, alerts, highest priority surfaces
4
Nested elevated content, menus on sheets
5
Highest elevation, tooltips, contextual UI
NSVisualEffectView.Material.windowBackground
Main window backgrounds on macOS
NSVisualEffectView.Material.contentBackground
Content areas within windows
NSVisualEffectView.Material.underWindowBackground
Behind-window overlays, sheets
NSVisualEffectView.Material.underPageBackground
Under page content, utility panels
NSVisualEffectView.Material.sidebar
Sidebar backgrounds in macOS apps
NSVisualEffectView.Material.headerView
Table/outline view headers
NSVisualEffectView.Material.sheet
Modal sheet backgrounds
NSVisualEffectView.Material.popover
Popover backgrounds
NSVisualEffectView.Material.menu
Menu backgrounds
NSVisualEffectView.Material.tooltip
Tooltip backgrounds
NSVisualEffectView.Material.hudWindow
Heads-up display overlays, media controls
NSVisualEffectView.Material.fullScreenUI
Full-screen presentation mode UI
NSVisualEffectView.Material.selection
Selected row/item backgrounds
.glass
Window backgrounds in visionOS, primary surfaces
.glassRegular
Standard glass surfaces
.glassThin
Lighter glass for overlays
.glassUltraThin
Minimal glass for subtle layering
.passthrough
Shows real-world environment through surface
.specular
Metallic/reflective accents on glass
.behindWindow
Content behind main window on tvOS
UIBlurEffect.Style.extraLight
Legacy extra light blur style (iOS 8+)
UIBlurEffect.Style.light
Legacy light blur style (iOS 8+)
UIBlurEffect.Style.dark
Legacy dark blur style (iOS 8+)
UIBlurEffect.Style.prominent
Legacy prominent blur for alerts
solid-fallback
Solid color fallback when Reduce Transparency is on
solid-secondary-fallback
Secondary solid fallback
solid-tertiary-fallback
Tertiary solid fallback
