FUISegmentedControlCollectionViewCell

@MainActor
open class FUISegmentedControlCollectionViewCell : FUIInlineValidationDrawingCollectionViewCell<FUISegmentedControlFormView>, FUIFormCell

A UICollectionViewCell subclass that allows a user to view or select from a list of strings using a Fiori-styled segmented control.

The value property of the cell is equal to the selectedSegmentIndex in the segmented control.

Specify segment heights by setting the segmentHeight API. By default this is set to nil, which means a segment will adjust its height to fit the content.

Color setting:

Setting the text color of buttons in the cell for a state using the setButtonAttributes(_:for:) API. The supported states are: disabled, normal, and selected.

let attributes = FUISegmentedControlButtonAttributes()
attributes.titleAttributes = ...
attributes.borderColor = ...
cell.setButtonAttributes(attributes, for: .normal)

Code Usage

// Optionally, create an array of value options to localized string mappings.
let buttonTitles: [[String: String]] = [["LO": "Low"], ["MED": "Medium"], ["HI": "High"]]

// Register `FUISegmentedControlCollectionViewCell` in the `viewDidLoad()` method in the controller.
override func viewDidLoad() {
super.viewDidLoad()
self.collectionView.register(FUISegmentedControlCollectionViewCell.self, forCellReuseIdentifier: FUISegmentedControlCollectionViewCell.reuseIdentifier)
}

func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
let cell = collectionView.dequeueReusableCell(withReuseIdentifier: FUISegmentedControlCollectionViewCell.reuseIdentifier, for: indexPath) as! FUISegmentedControlCollectionViewCell

cell.valueOptions = buttonTitles.flatMap { $0.map { $0.value } }
cell.keyName = "Priority"
cell.value = myObject.priority  // String value in the valid options set: ["LO", "MED", "HI"]

// MARK: implement `onChangeHandler`.
cell.onChangeHandler = { newValue in
myObject.priority = buttonTitles[newValue].first!.key  // lookup valid String value, from the buttonTitles array
}

return cell
}

Theming

Supported style classes

fdlFUISegmentedControlCollectionViewCell
fdlFUISegmentedControlCollectionViewCell_keyLabel