Bottom Sheet

Bottom Sheet component is designed to handle any content, including a scrolling one.

• ✅ use any content size, and it will adapt
• ✅ use scrollable content: UICollectionView, UITableView or UIScrollView
• ✅ dismiss interactively by swipe-down or just tapping on an empty space
• ✅ build flows inside using BottomSheetNavigationController
  • ✅ supports all system transitions: push and (interactive) pop
  • ✅ transition animated between different content sizes
• ✅ Customize appearance:
  • pull bar visibility
  • corner radius
  • shadow background color

How it looks like

NavigationController inside Bottom Sheet

Installation

Swift Package Manager

To integrate Bottom Sheet into your Xcode project using Swift Package Manager, add it to the dependencies value of your Package.swift:

dependencies: [
    .package(url: "https://github.com/joomcode/BottomSheet", from: "2.0.0")
]

Getting started

This repo contains demo, which can be a great start for understanding Bottom Sheet usage, but here are simple steps to follow:

1. Create UIViewController to present and set content’s size by preferredContentSize property
2. (optional) Conform to ScrollableBottomSheetPresentedController if your view controller is list-based
3. Present by using presentBottomSheet(viewController:configuration:)

If you want to build flows, use BottomSheetNavigationController

presentBottomSheetInsideNavigationController(
    viewController: viewControllerToPresent,
    configuration: .default
)

You can customize appearance passing configuration parameter

presentBottomSheet(
    viewController: viewControllerToPresent,
    configuration: BottomSheetConfiguration(
        cornerRadius: 10,
        pullBarConfiguration: .visible(.init(height: 20)),
        shadowConfiguration: .init(backgroundColor: UIColor.black.withAlphaComponent(0.6))
    )
)

Resources

Read the article on Medium for betting understanding of how it works under the hood

GitHub

View Github