Swift Package Index


SelectableStackView is a customizable and easy to use UI element for showing and managing selectable elements in a stack written in Swift


  • The latest stable release is v1.2.4. Released 5 months ago.
  • The last commit to master was 5 months ago.

Swift Version Compatibility

  • v1.2.4 and master
    5.3
    5.2
    5.1
    5.0
    4.2
Full build results

Platform Compatibility

  • v1.2.4 and master
    iOS
    macOS(Intel)
    macOS(ARM)
    Linux
    tvOS
    watchOS
Full build results

SelectableStackView

SelectableStackView is a customizable and easy to use UI element for showing and managing selectable elements in a stack written in Swift.

Preview

Features

  • Supports any number of elements
  • Supports any type of elements given that it should conform to SelectionObservableView protocol
  • Automatically manages elements
  • Allows to manually manage elements if needed
  • Supports single/multiple selection states
  • Can automatically handle no selection case
  • Use in code or from interface builder
  • Has a delegate to observe selection

Requirements

  • iOS 10.0+
  • Xcode 11+
  • Swift 5.2+

Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler.

Use Xcode’s new Swift Packages option, which is located within the File menu.

Usage example

ExampleApp

Add an arranged subview

import SelectableStackView

selectableStackView.addArrangedSubview(yourView) // make sure that your view conform to ObservableBySelectableStackView protocol

Select an view from code

import SelectableStackView

selectableStackView.select(true, at: someIndex) // if view at given index doesnt exist, nothing will happen

Receive selection events

import SelectableStackView

// 1. Conform to SelectableStackViewDelegate protocol
class SomeClass: SelectableStackViewDelegate {
    let selectableStackView = SelectableStackView()
    
    init() {
        // 2. Set delegate
        selectableStackView.delegate = self
    }
    
    // MARK: - SelectableStackViewDelegate
    func didSelect(_ select: Bool, at index: Index, on selectableStackView: SelectableStackView) {
        // handle selection
    }
}

Advanced

Turn on logging

selectableStackView.loggingEnabled = on // enable logging if needed

Turn off delegate notifications on self selection

import SelectableStackView

class SomeClass: SelectableStackViewDelegate {
    var shouldNotifyAboutSelfSelection: Bool { true }
}

License

SelectableStackView is released under the MIT license. See LICENSE for details.