// // BaseButton.swift // VDS // // Created by Matt Bruce on 11/22/22. // import Foundation import UIKit import VDSColorTokens import VDSFormControlsTokens import Combine public protocol Buttonable: UIControl, Surfaceable, Enabling { /// The ButtonSize available to this type of Buttonable. var availableSizes: [ButtonSize] { get } /// The Text that will show up in the TitleLabel for this Buttonable. var text: String? { get set } /// The natural size for the receiving view, considering only properties of the view itself. var intrinsicContentSize: CGSize { get } } /// Base class used for UIButton type classes. @objc(VDSButtonBase) open class ButtonBase: UIButton, ViewProtocol, UserInfoable, Clickable { //-------------------------------------------------- // MARK: - Initializers //-------------------------------------------------- required public init() { super.init(frame: .zero) initialSetup() } public override init(frame: CGRect) { super.init(frame: .zero) initialSetup() } public required init?(coder: NSCoder) { super.init(coder: coder) initialSetup() } //-------------------------------------------------- // MARK: - Configuration Properties //-------------------------------------------------- private let hitAreaHeight = 44.0 //-------------------------------------------------- // MARK: - Combine Properties //-------------------------------------------------- /// Set of Subscribers for any Publishers for this Control. open var subscribers = Set() open var onClickSubscriber: AnyCancellable? { willSet { if let onClickSubscriber { onClickSubscriber.cancel() } } } //-------------------------------------------------- // MARK: - Private Properties //-------------------------------------------------- private var initialSetupPerformed = false //-------------------------------------------------- // MARK: - Properties //-------------------------------------------------- /// Key of whether or not updateView() is called in setNeedsUpdate() open var shouldUpdateView: Bool = true /// The ButtonSize available to this type of Buttonable. open var availableSizes: [ButtonSize] { [] } open var surface: Surface = .light { didSet { if oldValue != surface { setNeedsUpdate() } } } /// Text that will be used in the titleLabel. open var text: String? { didSet { if oldValue != text { setNeedsUpdate() } } } /// Array of LabelAttributeModel objects used in rendering the text. open var textAttributes: [any LabelAttributeModel]? { nil } /// TextStyle used on the titleLabel. open var textStyle: TextStyle { .defaultStyle } /// UIColor used on the titleLabel text. open var textColor: UIColor { .black } /// Will determine if a scaled font should be used for the titleLabel font. open var useScaledFont: Bool = false { didSet { if oldValue != useScaledFont { setNeedsUpdate() } } } open var userInfo = [String: Primitive]() open var touchUpInsideCount: Int = 0 internal var isHighlightAnimating = false /// Whether the Control is highlighted or not. open override var isHighlighted: Bool { didSet { if isHighlightAnimating == false && touchUpInsideCount > 0 { isHighlightAnimating = true UIView.animate(withDuration: 0.1, animations: { [weak self] in self?.setNeedsUpdate() }) { [weak self] _ in //you update the view since this is typically a quick change UIView.animate(withDuration: 0.1, animations: { [weak self] in self?.setNeedsUpdate() self?.isHighlightAnimating = false }) } } } } /// Whether the Control is enabled or not. open override var isEnabled: Bool { didSet { if oldValue != isEnabled { setNeedsUpdate() } } } //-------------------------------------------------- // MARK: - Lifecycle //-------------------------------------------------- open func initialSetup() { if !initialSetupPerformed { backgroundColor = .clear translatesAutoresizingMaskIntoConstraints = false accessibilityCustomActions = [] setup() setNeedsUpdate() } } open func setup() { translatesAutoresizingMaskIntoConstraints = false titleLabel?.adjustsFontSizeToFitWidth = false titleLabel?.lineBreakMode = .byTruncatingTail } open func updateView() { updateLabel() } open func updateAccessibility() { if isEnabled { accessibilityTraits.remove(.notEnabled) } else { accessibilityTraits.insert(.notEnabled) } } open func reset() { shouldUpdateView = false surface = .light isEnabled = true text = nil accessibilityCustomActions = [] shouldUpdateView = true setNeedsUpdate() } //-------------------------------------------------- // MARK: - Overrides //-------------------------------------------------- override open var intrinsicContentSize: CGSize { let intrinsicContentSize = super.intrinsicContentSize let adjustedWidth = intrinsicContentSize.width + titleEdgeInsets.left + titleEdgeInsets.right let adjustedHeight = intrinsicContentSize.height + titleEdgeInsets.top + titleEdgeInsets.bottom return CGSize(width: adjustedWidth, height: adjustedHeight) } //-------------------------------------------------- // MARK: - Private Methods //-------------------------------------------------- private func updateLabel() { //clear the arrays holding actions accessibilityCustomActions = [] //create the primary string let mutableText = NSMutableAttributedString.mutableText(for: text ?? "No Text", textStyle: textStyle, useScaledFont: useScaledFont, textColor: textColor, alignment: titleLabel?.textAlignment ?? .center, lineBreakMode: titleLabel?.lineBreakMode ?? .byTruncatingTail) if let attributes = textAttributes { //loop through the models attributes for attribute in attributes { //add attribute on the string attribute.setAttribute(on: mutableText) } } //set the attributed text setAttributedTitle(mutableText, for: .normal) setAttributedTitle(mutableText, for: .highlighted) } } // MARK: AppleGuidelinesTouchable extension ButtonBase: AppleGuidelinesTouchable { /// Overrides to ensure that the touch point meets a minimum of the minimumTappableArea. override open func point(inside point: CGPoint, with event: UIEvent?) -> Bool { Self.acceptablyOutsideBounds(point: point, bounds: bounds) } }