Skip to content

sliding panel, expandable bottom sheet, resizable drawer, adaptive bottom sheet, collapsible panel, modal swiftui sheet, sliding sheet, swift botom sheet, ios bottom sheet BottomSheet macos Custom modal popup menu bottomsheet, bottom sheet with scrollview, bottom sheet for map, ios, macos, watchos, visionos, navigation

License

Notifications You must be signed in to change notification settings

swiftuiux/swiftui-bottomsheet-drawer

Repository files navigation

Multiplatform (iOS, macOS) SwiftUI bottom sheet drawer

Features

  • It does not re-render the background content while manipulating with the sheet
  • iOS and macOS support
  • dark and light scheme support
  • Observing sheet positions on change if you need to react on it
  • Responsive for any size change It's important for macOS while window size changing
  • Customize component with your own specs

Creation

Put the component into an absolute coordinate space like ZStack or GeometryReader and just pass a content that's it to start with sheet drawer.

        ZStack {
            BottomSheet(content: Color.clear.background(.thinMaterial))
        }

Builder

You can use builder methods to change some specs

  • hideDragButton - Hide drag button
  • withoutAnimation - Turn off animation
        ZStack {
            BottomSheet(content: Color.clear.background(.thinMaterial))
            .hideDragButton()
            .withoutAnimation()
        }

Optional

  • shift - Visible height of the sheet drawer

  • topIndentation - Space from the very top to the max height drawer can reach

  • draggerHeight - Space sensitive for dragging

  • dragThresholdToAct - Dragging length after which trigger move to the next level depending on the direction of moving

Observing sheet positions

Observe sheet positions on change if you need to react on it in the external context of the component. For example to update layout of the drawer content according a new size of the height. Position BottomSheetPosition is passed with height of the sheet. height - is enum associated with value of type CGFloat

    @State private var position: BottomSheetPosition
    
        BottomSheet(
            content: SheetContentView(position: $position)
        )
        .onPositionChanged{
            position = $0
        }
Position Description
up(CGFloat) At the top
middle(CGFloat) At the middle
down(CGFloat) At the bottom

SwiftUI example of using package

click to watch expected UI behavior for the example

click to watch expected UI behavior for the example

Documentation(API)

  • You need to have Xcode 13 installed in order to have access to Documentation Compiler (DocC)
  • Go to Product > Build Documentation or ⌃⇧⌘ D

About

sliding panel, expandable bottom sheet, resizable drawer, adaptive bottom sheet, collapsible panel, modal swiftui sheet, sliding sheet, swift botom sheet, ios bottom sheet BottomSheet macos Custom modal popup menu bottomsheet, bottom sheet with scrollview, bottom sheet for map, ios, macos, watchos, visionos, navigation

Topics

Resources

License

Stars

Watchers

Forks

Languages