PanModal

PanModal is a powerful and customizable modal presentation controller for iOS. It provides a simple and intuitive way to present modals in your iOS applications, with support for various presentation styles and customization options.

Pros

• Flexible Presentation Styles: PanModal supports a variety of presentation styles, including bottom sheet, top sheet, and custom presentation styles, allowing you to choose the best fit for your app's user experience.
• Smooth Interaction: The library provides a smooth and responsive user experience, with support for interactive dismissal and customizable gestures.
• Customization Options: PanModal offers a wide range of customization options, enabling you to tailor the modal's appearance and behavior to match your app's design and requirements.
• Accessibility Support: The library includes built-in accessibility features, ensuring that your modals are accessible to users with disabilities.

Cons

• Dependency on UIKit: PanModal is tightly coupled with Apple's UIKit framework, which may limit its compatibility with other iOS development frameworks or platforms.
• Learning Curve: While the library provides a straightforward API, developers may need to invest some time in understanding the various configuration options and customization possibilities.
• Potential Performance Impact: Depending on the complexity of your modal content, the library's animation and gesture handling features may have a slight performance impact on your app.
• Limited Third-Party Integration: PanModal may not integrate seamlessly with all third-party libraries or frameworks used in your iOS project.

Code Examples

Presenting a Bottom Sheet Modal

let modalViewController = MyModalViewController()
let panModalPresentationController = PanModalPresentationController(presentedViewController: modalViewController, presenting: self)
panModalPresentationController.delegate = self
present(modalViewController, animated: true, completion: nil)

Customizing the Modal Appearance

let panModalPresentationController = PanModalPresentationController(presentedViewController: modalViewController, presenting: self)
panModalPresentationController.shortFormHeight = 300
panModalPresentationController.longFormHeight = 500
panModalPresentationController.cornerRadius = 16
panModalPresentationController.springDamping = 0.8

Handling Dismissal Gestures

extension MyViewController: PanModalPresentationControllerDelegate {
    func shouldPanModalDismiss(_ panModalPresentationController: PanModalPresentationController) -> Bool {
        // Implement custom dismissal logic
        return true
    }
}

Implementing a Custom Presentation Style

class CustomPresentationController: PanModalPresentationController {
    override func presentationTransitionWillBegin() {
        // Implement custom presentation logic
    }

    override func dismissalTransitionWillBegin() {
        // Implement custom dismissal logic
    }
}

Getting Started

To get started with PanModal, follow these steps:

1. Add the PanModal library to your project using a package manager like CocoaPods or Carthage.

   # CocoaPods
   pod 'PanModal'
   

2. Import the PanModal framework in your Swift file.

   import PanModal
   

3. Create an instance of the modal view controller you want to present and configure the PanModalPresentationController.

   let modalViewController = MyModalViewController()
   let panModalPresentationController = PanModalPresentationController(presentedViewController: modalViewController, presenting: self)
   panModalPresentationController.delegate = self
   present(modalViewController, animated: true, completion: nil)
   

4. Customize the modal's appearance and behavior by adjusting the properties of the PanModalPresentationController.

   panModalPresentationController.shortFormHeight = 300
   panModalPresentationController.longFormHeight = 500
   panModalPresentationController.cornerRadius = 16
   panModalPresentationController.springDamping = 0.8
   

5. Implement the PanModalPresentationControllerDelegate protocol to handle custom dismissal logic or other events.

   extension My