This mostly SwiftUI-based customizable drawer component offers functionality similar to the standard sheet modifier, but with additional fixed positions and extensive customization options. Ideal for displaying expandable and scrollable content on top of a background view, akin to the drawer behavior seen in Apple's and Google's map applications.
This project is currently a work in progress, being developed sporadically. Future updates may include additional documentation and bug fixes.
You can add SwiftyDrawer to an Xcode project by adding it as a package dependency. The required minimum platform version is iOS 15.
From the File menu, select Add Package Dependencies... Enter "https://github.com/aswinter90/SwiftyDrawer" into the package repository URL text field.
Or add it to your Swift package by referencing it in your package manifest:
let package = Package(
name: "MyLibrary",
platforms: [.iOS(.v15)],
products: [
.library(
name: "MyLibrary",
targets: ["MyLibrary"]),
],
dependencies: [
.package(url: "https://github.com/aswinter90/SwiftyDrawer", from: "1.0.0")
],
targets: [
.target(
name: "MyLibrary",
dependencies: ["SwiftyDrawer"]
),
]
)
The project contains multiple demo applications with showcases for displaying the SwiftyDrawer in different usage scenarios.
import SwiftUI
import SwiftyDrawer
struct ContentView: View {
@State private var drawerState = DrawerState(case: .partiallyOpened)
var body: some View {
MySwiftLogo()
.drawerOverlay(
state: $drawerState,
content: {
VStack {
ForEach(0..<30) { index in
Text("Item \(index)")
.frame(maxWidth: .infinity, alignment: .leading)
.padding()
Divider()
}
}
.padding(.top, 8)
}
)
}
}
As shown in the video the drawer can be modified with a sticky header, which stays on top of the safe area or the tab bar when the drawer is closed. The default drag handle can also be replaced with any other given view.
Finally the DrawerState is mutable and changing it from the outside will update the drawer position automatically.
demo2.mov
This is a demonstration for how the drawer content can be updated by observing a ViewModel state.