# UIBackgroundConfiguration
특정 background appearance를 표현하는 configuration
**(deployment iOS 14.0+)**

</br>

## Declaration

struct UIBackgroundConfiguration

</br>

## Overview
Background configuration은 뷰의 배경을 만드는 간단한 방법을 제공한다. Background configuration을 사용하면 다양한 뷰의 상태에 대한 시스템 기본 배경 스타일을 얻을 수 있다. Background configuration을 `UICollectionView` 및 `UITableView`의 cell, header 및 footer 또는 `UIButton`에 직접 적용한다.

**Background Configuration 사용하기**
1. 기본 시스템 스타일 중 하나로 background configuration을 만든다.
2. 추가 customizing이 필요한 경우 뷰의 스타일과 일치하도록 configuration을 수정한다.
3. 뷰의 현재 background configuration을 수정한 configuration으로 설정한다.

var backgroundConfig = UIBackgroundConfiguration.listPlainCell()

// Set a nil background color to use the view's tint color. 
backgroundConfig.backgroundColor = nil 

cell.backgroundConfiguration = backgroundConfig

투명한 배경을 생성하는 `clear()`를 사용하여 빈 background configuration을 생성하여 시작할 수도 있다.

각 시스템 background 스타일은 다양한 configuration 상태([UIConfigurationState](https://developer.apple.com/documentation/uikit/uiconfigurationstate))에 대한 시스템 기본값을 제공한다. `automaticallyUpdatesBackgroundConfiguration` 프로퍼티가 true인 뷰에 background configuration을 적용하면 뷰의 상태가 변경될 때 시스템이 자동으로 background configuration을 업데이트한다.

시스템 기본값 이외의 추가 customizing을 원하는 경우 뷰의 `updateConfiguration(using:)`메서드를 override하여 background configuration을 수동으로 업데이트 하도록 선택할 수 있다.

override func updateConfiguration(using state: UIConfigurationState) {
    // Get the system default background configuration for a plain style list cell in the current state. 
    var backgroundConfig = UIBackgroundConfiguration.listPlainCell().updated(for: state) 

    // Customize the background color to use the tint color when the cell is highlighted or selected. 
     if state.isHighlighted || state.isSelected { 
        backgroundConfig.backgroundColor = nil 
     } 

    // Apply the background configuration to the cell. 
    self.backgroundConfiguration = backgroundConfig 
} 

뷰에 configuration을 적용하면 UIKit이 background의 실제 그리기 및 렌더링을 수행한다. 자체 배경을 렌더링하는 대신 background configuration을 사용하는 경우 시스템은 자동 뷰 계층구조 관리, 상호작용 및 중단 가능한 애니메이션/전환에 대한 지원, 성능 최적화를 제공한다.

</br>

## Topics
### Creating cell background configurations
* static func `listPlainCell()`
* plain list cell 스타일의 default configuration 생성.

* static func `listGroupedCell()`
* grouped list cell 스타일의 default configuration 생성.

* static func `listSidebarCell()`
* sidebar list cell 스타일의 default configuration 생성.

### Creating an empty background configuration
* static func `clear()`
* 투명한 배경, default styling이 없는 빈 background configuration 생성.

### Customizing the background
* var `customView`
* 배경의 custom view

* var `cornerRadius`
* 배경과 테두리의 corner 커브를 사용하기 위한 preferred corner radius

* var `backgroundInsets`
* 갖고있는 뷰의 가장자리에 상대적인 배경 및 테두리의 inset(음수인 경우 outset)

* var `backgroundColor`
* 배경 색

* var `strokeColor`
* 테두리 색

* var `strokeWidth`
* 테두리 너비

* var `strokeOutset`
* 셀과 테두리 사이 outset(음수일 경우 inset)

### Updating background configurations
* func `updated(for:)`
* 해당 셀의 state에 대한 configuration의 기본값을 customizing하지 않은 모든 프로퍼티에 적용하여 지정된 state에 대한 configuration을 생성한다.

</br>

[참고 문헌]
* [zedd blog - SwiftUI) List Style 종류](https://zeddios.tistory.com/1111)