https://github.com/pimcoumans/panelpresenter

Very simple swipe-to-dismiss, supporting Auto Layout and dynamic heights
https://github.com/pimcoumans/panelpresenter

Last synced: 9 days ago
JSON representation

Very simple swipe-to-dismiss, supporting Auto Layout and dynamic heights

• Host: GitHub
• URL: https://github.com/pimcoumans/panelpresenter
• Owner: PimCoumans
• License: apache-2.0
• Created: 2022-08-19T16:30:39.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-02-19T19:06:44.000Z (9 months ago)
• Last Synced: 2024-10-31T05:51:41.328Z (16 days ago)
• Language: Swift
• Size: 61.5 KB
• Stars: 6
• Watchers: 3
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# PanelPresenter

Add swipe-dismiss logic to your view controller, supporting Auto Layout and dynamic heights.



## Installation

Add this SPM package to your project by searching `https://github.com/PimCoumans/PanelPresenter`.

## Usage

To make use of the behavior that `PanelPresenter` provides, make sure your view controller conforms to `PanelPresentable` and set the presenter’s `viewController` property to `self` in your initializer. Doing this at a later stage will result in weird stuff.

```swift

class SimpleViewController: UIViewController, PanelPresentable {

    

    let panelPresenter = PanelPresenter()

    

    init() {

        super.init(nibName: nil, bundle: nil)

        panelPresenter.viewController = self

    }

}

```

Just add your views to your `view`, which will be added to `panelPresenter`’s scroll view. And any navigation-type views can be placed in the `headerView` which will be displayed above your content and will stick to the top of the screen when scrolling.

```swift

private lazy var simpleView: UIView = {

    let view = UIView()

    view.backgroundColor = .systemMint

    return view

}()

private lazy var cancelButton: UIButton = {

    let button = UIButton(type: .system)

    button.setTitle("Cancel", for: .normal)

    button.addAction(UIAction { [unowned self] _ in

        self.presentingViewController?.dismiss(animated: true)

    }, for: .touchUpInside)

    return button

}()

override func viewDidLoad() {

    super.viewDidLoad()

    view.tintColor = .black

    

    view.addSubview(simpleView)

    simpleView.translatesAutoresizingMaskIntoConstraints = false

    

    NSLayoutConstraint.activate([

        simpleView.leadingAnchor.constraint(equalTo: view.leadingAnchor),

        simpleView.trailingAnchor.constraint(equalTo: view.trailingAnchor),

        simpleView.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),

        simpleView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),

        simpleView.heightAnchor.constraint(equalToConstant: 200),

    ])

    // Use the `panelPresentationController` property to access and configure the presentation controller

    panelPresentationController?.showsHeaderView = true

    if let headerView = panelPresentationController?.headerView {

	    headerView.addSubview(cancelButton)

        cancelButton.translatesAutoresizingMaskIntoConstraints = false

        NSLayoutConstraint.activate([

            cancelButton.leadingAnchor.constraint(equalTo: headerView.layoutMarginsGuide.leadingAnchor),

            cancelButton.centerYAnchor.constraint(equalTo: headerView.layoutMarginsGuide.centerYAnchor)

        ])

    }

}

```

### Presenting any view controller

The presented view controller doesn‘t necessarily need to opt in to the panel behavior. The presenter can also use the following example

```swift

let viewController = SomeViewController()

let presenter = PanelPresenter(viewController: viewController)

presenter.present(from: self, animated: true)

```

## Example code

Check the sample app in the repository to see multiple supported scenarios for presenting your view as a panel, the simplest being comparable to the example shown above.

A more complex example is `StackViewController` where a bunch of random, multiline labels are dynamically added to a `UIStackView`. The height animates whenever the a label is added or removed. In the `animateChanges()` method an example is shown how to animate the height using the presentation controller’s method of the same name.

## Questions?

Look me up on [mastodon](https://mastodon.social/@pimc)! ✌🏻