BottomHalfModal - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #typescript #llm #golang #machine-learning #rust #deep-learning #windows #awesome-list #mcp #open-source

BottomHalfModal

(★ 94)

A customizable bottom half modal used in merpay

파일 탐색기

최종 버전 다운로드 (.zip)

- PULL_REQUEST_TEMPLATE.md
- BottomHalfModal.h
- BottomHalfModalNavigationController.swift
- Info.plist
- SheetAnimationController.swift
- SheetContentHeight.swift
- SheetContentHeightModifiable.swift
- SheetControllerContentSizing.swift
- SheetPresentationController.swift
- SheetPresentationDelegate.swift
- SheetPresenter.swift
- - contents.xcworkspacedata
- project.pbxproj
- - Contents.json
- - LaunchScreen.storyboard
  - Main.storyboard
- - BasicViewController.swift
  - BasicViewController.xib
- - InputViewController.swift
  - InputViewController.xib
- - NavigationViewController.swift
  - NavigationViewController.xib
- - StickyButtonViewController.swift
  - StickyButtonViewController.xib
- - TableViewController.swift
- AppDelegate.swift
- DemoViewController.swift
- Info.plist
- basic.gif
- input.gif
- navigation.gif
- stickybutton.gif
- tableview.gif
.gitignore
BottomHalfModal.podspec
CONTRIBUTING.md
LICENSE
Package.swift
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# BottomHalfModal  ![Platform iOS11+](https://img.shields.io/badge/platform-ios11%2B-red) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

BottomHalfModal is a customizable half modal UI used in merpay.

![BottomHaflModal](https://github.com/mercari/BottomHalfModal/raw/master/Screenshots/basic.gif)

## 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`.

```swift
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.

```swift
    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.

```swift
    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.

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

## Demo

|Basic|
|---|
|![Basic](https://github.com/mercari/BottomHalfModal/raw/master/Screenshots/basic.gif)|

|TableView|
|---|
|![TableView](https://github.com/mercari/BottomHalfModal/raw/master/Screenshots/tableview.gif)|

|Navigation|
|---|
|![Navigation](https://github.com/mercari/BottomHalfModal/raw/master/Screenshots/navigation.gif)|

|StickyButton|
|---|
|![StickyButton](https://github.com/mercari/BottomHalfModal/raw/master/Screenshots/stickybutton.gif)|

|Input|
|---|
|![Input](https://github.com/mercari/BottomHalfModal/raw/master/Screenshots/input.gif)|

## 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/](https://www.mercari.com/cla/)

## License

Copyright 2019 Mercari, Inc.

Licensed under the MIT License.