// // Copyright 2021-2024 New Vector Ltd. // // SPDX-License-Identifier: AGPL-3.0-only // Please see LICENSE in the repository root for full details. // import UIKit import Reusable /// A subclass of `UITableViewHeaderFooterView` that conforms to `Themable` /// to create a consistent looking custom footer inside of the app. If using gesture /// recognizers on the view, be aware that these will be automatically removed on reuse. @objcMembers class SectionFooterView: UITableViewHeaderFooterView, NibLoadable, Themable { // MARK: - Properties static var defaultReuseIdentifier: String { String(describing: Self.self) } static var nib: UINib { // Copy paste from NibReusable in order to expose to ObjC UINib(nibName: String(describing: self), bundle: Bundle(for: self)) } /// The amount to inset the footer label on its leading side, relative to the safe area insets. var leadingInset: CGFloat { get { footerLabelLeadingConstraint.constant } set { footerLabelLeadingConstraint.constant = newValue } } /// The text label added in the xib file. Using our own label was necessary due to the behaviour /// on iOS 12-14 where any customisation to the existing text label is wiped out after being /// set in `tableView:viewForFooterInSection`. This behaviour is fixed in iOS 15. @IBOutlet private weak var footerLabel: UILabel! /// The label's leading constraint, relative to the safe area insets. @IBOutlet private weak var footerLabelLeadingConstraint: NSLayoutConstraint! // MARK: - Public override func prepareForReuse() { super.prepareForReuse() for recognizer in gestureRecognizers ?? [] { removeGestureRecognizer(recognizer) } } func update(theme: Theme) { footerLabel.textColor = theme.colors.secondaryContent footerLabel.font = theme.fonts.subheadline footerLabel.numberOfLines = 0 } /// Update the footer with new text. func update(withText text: String) { footerLabel.text = text } /// Update the footer with attributed text. Be sure to call this after calling `update(theme:)` /// otherwise any color or font attributes will be wiped out by the theme. func update(withAttributedText attributedText: NSAttributedString) { footerLabel.attributedText = attributedText } }