BottomHalfModal

A customizable bottom half modal used in merpay

Showing:

Popularity

Downloads/wk

0

GitHub Stars

94

Maintenance

Last Commit

1yr ago

Contributors

3

Package

Dependencies

0

License

MIT

Categories

Readme

BottomHalfModal Platform iOS11+ License: MIT

BottomHalfModal is a customizable half modal UI used in merpay.

BottomHaflModal

Installation

Carthage

github "mercari/BottomHalfModal"

CocoaPods

pod "BottomHalfModal"

Usage

BottomHalfModal can present any type of UIVIewController as content. The presented view controller needs to confirm to SheetContentHeightModifiable and define sheetContentHeightToModify that is the height of the half modal. Then call adjustFrameToSheetContentHeightIfNeeded() in viewDidAppear.

import BottomHalfModal

class XXXXViewController: SheetContentHeightModifiable {
    var sheetContentHeightToModify: CGFloat = 320
    
    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        adjustFrameToSheetContentHeightIfNeeded()
    }
}

Then, call presentBottomHalfModal(_ viewControllerToPresent: UIViewController, animated: Bool, completion: (() -> Void)?) to show the content.

    let vc = XXXXViewController()
    presentBottomHalfModal(vc, animated: true, completion: nil)

If you want to use UINavigationController in BottomHalfModal, use BottomHalfModalNavigationController. It handles content height update while push and pop navigations.

    let vc = XXXXViewController()
    let nav = BottomHalfModalNavigationController(rootViewController: vc)
    presentBottomHalfModal(nav, animated: true, completion: nil)

If you support multiple device orientation, please call adjustFrameToSheetContentHeightIfNeeded() in viewWillTransition(to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator) too.

override func viewWillTransition(to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator) {
    super.viewWillTransition(to: size, with: coordinator)
    adjustFrameToSheetContentHeightIfNeeded(with: coordinator)
}

Demo

Basic
Basic
TableView
TableView
Navigation
Navigation
StickyButton
StickyButton
Input
Input

Contribution

Please read the CLA carefully before submitting your contribution to Mercari. Under any circumstances, by submitting your contribution, you are deemed to accept and agree to be bound by the terms and conditions of the CLA.

https://www.mercari.com/cla/

License

Copyright 2019 Mercari, Inc.

Licensed under the MIT License.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100