Material

A background material type.

StructureiOS 15.0+macOS 12.0+tvOS 15.0+watchOS 8.0+Material in SwiftUI

Declaration

React
type Material =
  | 'bar'
  | 'regular'
  | 'regularMaterial'
  | 'thick'
  | 'thickMaterial'
  | 'thin'
  | 'thinMaterial'
  | 'ultraThick'
  | 'ultraThickMaterial'
  | 'ultraThin'
  | 'ultraThinMaterial';
Swift
struct Material

Pass a literal, or build one with SwiftUI.Material from import { SwiftUI } from 'swiftui-react-native'.

Type properties

Overview

You can apply a blur effect to a view that appears behind another view by adding a material with the View.background(_:ignoresSafeAreaEdges:) modifier:

ZStack {
    Color.teal
    Label("Flag", systemImage: "flag.fill")
        .padding()
        .background(.regularMaterial)
}

In the example above, the ZStack layers a Label on top of the color ShapeStyle.teal. The background modifier inserts the regular material below the label, blurring the part of the background that the label --- including its padding --- covers:

A material isn't a view, but adding a material is like inserting a translucent layer between the modified view and its background:

The blurring effect provided by the material isn't simple opacity. Instead, it uses a platform-specific blending that produces an effect that resembles heavily frosted glass. You can see this more easily with a complex background, like an image:

ZStack {
    Image("chili_peppers")
        .resizable()
        .aspectRatio(contentMode: .fit)
    Label("Flag", systemImage: "flag.fill")
        .padding()
        .background(.regularMaterial)
}

For physical materials, the degree to which the background colors pass through depends on the thickness. The effect also varies with light and dark appearance:

If you need a material to have a particular shape, you can use the View.background(_:in:fillStyle:) modifier. For example, you can create a material with rounded corners:

ZStack {
    Color.teal
    Label("Flag", systemImage: "flag.fill")
        .padding()
        .background(.regularMaterial, in: RoundedRectangle(cornerRadius: 8))
}

When you add a material, foreground elements exhibit vibrancy, a context-specific blend of the foreground and background colors that improves contrast. However using View.foregroundStyle(_:) to set a custom foreground style --- excluding the hierarchical styles, like ShapeStyle.secondary-swift.type.property --- disables vibrancy.

what appears behind your app on the screen. For example, the content on the Home Screen doesn't affect the appearance of a widget.

From Apple’s SwiftUI documentation. Code samples there are Swift.

See also

More in Drawing and shapes.