FUIObjectCollectionViewCell

@MainActor
open class FUIObjectCollectionViewCell : FUITableViewAccessoryDrawingCollectionViewCell<FUIObjectView>, FUIContentCopyable

FUIObjectCollectionViewCell is the default UICollectionView subclass for presenting business object data in the Fiori Design Language.

Usage

Data Binding:

cell.detailImage = UIImage(named: "image.png")
cell.headlineText = "Business Object Title"
cell.subheadlineText = "Business Object Subtitle"
cell.footnoteText = "Business Object Footnote"
cell.statusImageView.image = FUIIconLibrary.indicator.veryHighPriority.withRenderingMode(.alwaysTemplate)
cell.substatusText = "Status Description"
cell.descriptionText = "Business Object Description (long)"
cell.iconImages = ["1"]
cell.tags = [FUITag(title: "Tag - 1"), FUITag(title: "Tag - 2")]
cell.accessoryType = .disclosureIndicator
cell.footnoteIcons = [UIImage(systemName: "person")!, "XY"]
cell.footnoteIconsText.text = "Description text for footnote icons."
cell.footnoteIconsText.numberOfLines = 0
cell.footnoteIconsTextPosition = .leading
cell.actionButton.isHidden = false
cell.actionButton.setTitle("Button", for: .normal)

Icons layout:

Icons may be supplied to the iconImages property which conform to the FUIGlyphImage protocol. These include: UIImage, FUIAttributedGlyphImage, and String. It is recommended when supplying image types, to ensure that the rendering mode is alwaysTemplate, so that the default tint color will be applied.

The default dimensions of the icon images are 12 x 12pts. It is possible to increase the width allocated to the icons by increasing the value of the iconsColumnWidth: CGFloat property, though this is generally discouraged, unless it is necessary to support multiple digits of a String type (for example: iconImages = ["24"] may require iconsColumnWidth = 20.0).

The preserveIconStackSpacing: Bool property may be used to ensure that the insertion point of the view to the right of the icons layout (detailImageView, or headlineLabel) has a consistent x-coordinate, regardless of whether a particular cell contains icons. This property is ignored, if the icons are displayed within the margins, as the insertion point of the subsequent view will always be directionalLayoutMargins.left.

AccessoryView and EditingAccessoryView

Standard UITableViewCell accessoryView, accessoryType are supported.

The actionAccessoryView is a specialized view that takes the place of the usual accessoryView. This view is a FUISingleActionAccessoryView that shows an interactable button or progressView. Changing the actionAccessoryType changes the view that is shown. By default, the actionAccessoryType is set to .none.

cell.actionAccessoryType = .button
cell.actionAccessoryView?.button.style = .fuiRounded
cell.actionAccessoryView?.button.titleLabel?.preferredMaxLayoutWidth = 75
cell.actionAccessoryView?.button.setTitle("Follow", for: .normal)
cell.actionAccessoryView?.button.setTitle("Unfollow", for: .selected)
cell.actionAccessoryView?.button.isPersistentSelection = true
cell.actionAccessoryView?.button.isPreservingPreferredMaxLayoutWidth = true
cell.actionAccessoryView?.button.didSelectHandler = { button in <#selection handler#> }

Theming

Supported CollectionViewCell class paths:

fdlFUIObjectCollectionViewCell {}

Supported CollectionViewCell attributes:

tint-color (Color)
background-color (Color)
background-color-selected (Color)

Supported Text class paths:

fdlFUIObjectCollectionViewCell_headlineLabel {}
fdlFUIObjectCollectionViewCell_subheadlineLabel {}
fdlFUIObjectCollectionViewCell_footnoteLabel {}
fdlFUIObjectCollectionViewCell_statusLabel {}
fdlFUIObjectCollectionViewCell_substatusLabel {}
fdlFUIObjectCollectionViewCell_descriptionLabel {}

Supported Text attributes:

font-color (Color)
font-name (FontName)
font-style (UIFontTextStyle)
font-size (Number)
text-align (TextAlign)
text-line-clamp (Integer)

Supported ImageView class paths:

fdlFUIObjectCollectionViewCell_detailImageView {}
fdlFUIObjectCollectionViewCell_statusImageView {}
fdlFUIObjectCollectionViewCell_substatusImageView {}

Supported ImageView attributes:

image-name (Image)
tint-color (Color)

Supported BUTTON class paths:

fdlFUIObjectCollectionViewCell_actionButton {}

Supported BUTTON properties:

image: Image;
tint-color: Color;