SelectableStackView

1.2.4

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

What's New

v1.2.4

2020-08-03T18:44:57Z
  • Logging is disabled by default
  • Tests code refactoring

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.

Description

  • Swift Tools 5.2.0
View More Packages from this Author

Dependencies

  • None
Last updated: Mon Oct 21 2024 16:01:59 GMT-0900 (Hawaii-Aleutian Daylight Time)