Contents

backgroundConfiguration

The current background configuration of the view.

Declaration

@MainActor @preconcurrency var backgroundConfiguration: UIBackgroundConfiguration? { get set }

Discussion

Using a background configuration, you can obtain system default background styling for a variety of different view states. Create a background configuration with one of the default system styles, customize the configuration to match your view’s style as necessary, and assign the configuration to this property.

var backgroundConfig = UIBackgroundConfiguration.listPlainHeaderFooter()
backgroundConfig.backgroundColor = .systemGray
header.backgroundConfiguration = backgroundConfig

A background configuration is mutually exclusive with background views, so you must use one approach or the other. Setting a non-nil value for this property resets the following APIs to nil:

See Also

Configuring the background