[iOS - swift] adjustsImageWhenHighlighted 개념 (UIButton 이미지 딤드 효과)

adjustsImageWhenHighlighted 개념

• iOS 16에서 deprecated되었지만, 해당 옵션 사용하면 적용됨

https://developer.apple.com/documentation/uikit/uibutton/1624031-adjustsimagewhenhighlighted

• UIButton에 이미지를 set해주고 탭하 면 아래처럼 dimmed효과가 적용되는데 adjustsImageWhenHighlighted 옵션이 디폴트 true로 잡혀있기 때문

private let button = {
    let button = UIButton()
    let image = UIImage(named: "circleButton")
    button.setImage(image, for: .normal)
    button.addTarget(self, action: #selector(handleDidTapButton), for: .touchUpInside)
    button.translatesAutoresizingMaskIntoConstraints = false
    return button
}()

• adjustsImageWhenHighlighted = false로 설정하면 dimmed 효과 적용 x

button.adjustsImageWhenHighlighted = false

• 만약 highlighted 상태에서의 이미지를 set해주면 자동으로 adjustsImageWhenHighlighted 옵션이 비활성화됨

let image = UIImage(named: "circleButton")
button.setImage(image, for: .normal)
button.setImage(image, for: .highlighted) // <-

(결과 - highlighted 상태의 이미지를 지정해주었으므로 adjustsImageWhenHighlighted 값은 false로 고정)

주의사항) tintAdjustmentMode

• adjustsImageWhenHighlighted는 iOS15까지이지만 제공하여 아래처럼 사용하라는 글이 있지만, 이렇게 사용하면 iOS17.0.1에서 이미지 사이즈를 고정하려면 UIImage자체의 크기를 조절해야하는 번거로움이 있는 등의 이슈가 존재하여 configurationUpdateHandler는 iOS17.0.1이후에서 테스트해보고 사용해볼 것

btn.configurationUpdateHandler = { button in
        switch button.state {
            case .disabled:
                button.imageView?.tintAdjustmentMode = .dimmed
            default:
                button.imageView?.tintAdjustmentMode = .normal
        }
    }

* 참고 

https://stackoverflow.com/questions/74429141/adjustsimagewhendisabled-was-deprecated-in-ios-15-0

https://developer.apple.com/documentation/uikit/uiview/1622555-tintadjustmentmode

https://developer.apple.com/documentation/uikit/uibutton/1624031-adjustsimagewhenhighlighted