Applications using PanelKit can be seen in the showcase.

About

PanelKit is a UI framework that enables panels on iOS. A panel can be presented in the following ways:

• Modally
• As a popover
• Floating (drag the panel around)
• Pinned (either left or right)

This framework does all the heavy lifting for dragging panels, pinning them and even moving/resizing them when a keyboard is shown/dismissed.

Implementing

A lot of effort has gone into making the API simple for a basic implementation, yet very customizable if needed. Since PanelKit is protocol based, you don't need to subclass anything in order to use it. There a two basic principles PanelKit entails:

and a

.

Panels

A panel is created using the

initializer, which expects a

,

and

.

PanelContentDelegate

is a protocol that defines the appearance of a panel. Typically the

protocol is implemented for each panel on its

.

Example:

class MyPanelContentViewController: UIViewController, PanelContentDelegate {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        self.title = "Panel title"	
    }
    
    var preferredPanelContentSize: CGSize {
        return CGSize(width: 320, height: 500)
    }	
}

A panel is explicitly (without your action) shown in a

, but the top bar can be hidden or styled as with any

.

PanelManager

is a protocol that in its most basic form expects the following:

// The view in which the panels may be dragged around
var panelContentWrapperView: UIView {
    return contentWrapperView
}
// The content view, which will be moved/resized when panels pin var panelContentView: UIView {     return contentView }
// An array of PanelViewController objects var panels: [PanelViewController] {     return [] }

Typically the

protocol is implemented on a

.

Advanced features

PanelKit has some advanced opt-in features:

• Multi-pinning
• Panel resizing
• State restoration
• Exposé

Installation

CocoaPods

To install, add the following line to your

:

pod 'PanelKit', '~> 2.0'

Carthage

To install, add the following line to your

:

github "louisdh/panelkit" ~> 2.0

Run

update

to build the framework and drag the built

.framework

into your Xcode project.

Requirements

• iOS 10.0+
• Xcode 9.0+

Todo

Long term:

• [ ] Top/down pinning

License

This project is available under the MIT license. See the LICENSE file for more info.