BottomSheet
  • November 4, 2023

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

  •  use any content size, and it will adapt
  •  use scrollable content: UICollectionViewUITableView 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


Adapts to content size Interactive dismissal
adapt-to-content-size interactive-dismissal

 

NavigationController inside Bottom Sheet

Push and pop transitions Interactive pop transition
system-push-pop interactive-pop

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”)
]

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ bundle install

To integrate BottomSheet into your Xcode project using CocoaPods, specify it in your Podfile:

source ‘https://github.com/CocoaPods/Specs.git’
use_frameworks!

target ‘<Your Target Name>’ do
pod ‘BottomSheet’, :git => ‘https://github.com/joomcode/BottomSheet’
end

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))
),
canBeDismissed: {
// return `true` or `false` based on your business logic
true
},
dismissCompletion: {
// handle dismiss completion if user closed bottom sheet by a gesture
}
)

Resources


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

GitHub


View Github

#bottomsheet #ios #swift #swiftpackagemanager
YOU MIGHT ALSO LIKE...
SwiftUICam

If you want to have a custom camera using SwiftUI and not using the UIPickerController that will display the original ...

CameraView for SwiftUI 📷

CameraView allows you to have a SnapChat-style screen on your SwiftUI app that gives a realtime view of the iPhone ...

Camera-SwiftUI

SwiftUI has proven to be a really awesome new framework to build and design apps in a quick and reliable ...

ECWeekView

See the swiftui branch for updates. An iOS calendar library for displaying calendar events in a week view.