SFBottomSheet 0.0.11

SFBottomSheet 0.0.11

×

Maintained by Dimitar Petrov, Aleksandar Gyuzelov, dimitar.petrov, Kostadin Zamanov.

SFBottomSheet 0.0.11

  • By
  • scalefocus

SFBottomSheet

Version Platform License

SFBottomSheet is an implementation of custom modal presentation style for thumb-friendly interactive views anchored to the bottom of the screen

How to Install

pod 'SFBottomSheet'
import SFBottomSheet

For developers

Each SFBottomSheet accepts a child view controller that must conform to SFBottomSheetChildControllerProtocol. Through this protocol each child view controller describes how to be represented.

public protocol SFBottomSheetChildControllerProtocol: UIViewController {
    
    var delegate: SFBottomSheetChildDelegate? { get set }
    var defaultContainerHeight: CGFloat { get set }
    var minimumAvailableContainerHeight: CGFloat { get }
    var maximumAvailableHeightCoefficient: CGFloat { get }
    var childContainerLeadingDefaultConstraint: CGFloat { get }
    
    func getContainerHeight(_ maximumAvailableContainerHeight: CGFloat) -> CGFloat

}

public protocol SFBottomSheetChildDelegate: class {
    
    func childDidChangeHeight(with height: CGFloat)
    func childDidRequestClose()

}

SFBottomSheet also accepts a custom configuration that must conform to SFBottomSheetConfigurable

public protocol SFBottomSheetConfigurable {
    
    // MARK: Content
    
    var contentViewBackgroundColor: UIColor { get }
    
    // MARK: Container
    
    var containerViewCornerRadius: CGFloat { get }
    
    // MARK: Draggable
    
    var draggableContainerHeightConstraint: CGFloat { get }
    var draggableContainerBottomConstraint: CGFloat { get }
    var draggableHeightConstraint : CGFloat { get }
    var draggableWidthConstraint: CGFloat { get }
    var draggableBackgroundColor: UIColor { get }
    var draggableAlpha: CGFloat { get }
    var draggableCornerRadius: CGFloat { get }
    var draggableMaskedCorners: CACornerMask { get }
    
}

Attention: If is not provided, the default one will be used.

struct SFBottomSheetConfigurator: SFBottomSheetConfigurable {
    
    // MARK: Content
    
    var contentViewBackgroundColor: UIColor = UIColor(red: 0, green: 0, blue: 0, alpha: 0.4)
    
    // MARK: Container
    
    var containerViewCornerRadius: CGFloat = 16
        
    // MARK: Draggable
    
    var draggableContainerHeightConstraint: CGFloat = 30
    var draggableContainerBottomConstraint: CGFloat = 0
    var draggableHeightConstraint: CGFloat = 5
    var draggableWidthConstraint: CGFloat = 40
    var draggableBackgroundColor: UIColor = .white
    var draggableAlpha: CGFloat = 1
    var draggableCornerRadius: CGFloat = 2
    var draggableMaskedCorners: CACornerMask = [.layerMinXMinYCorner, .layerMaxXMinYCorner, .layerMaxXMaxYCorner, .layerMinXMaxYCorner]

}

How to Use

  • With default configuration:
let childViewController: SFBottomSheetChildControllerProtocol = SFBottomSheetChildViewController()
guard let bottomSheetViewController = SFBottomSheetViewController.createScene(child: childViewController,
                                                                        didFinishWithoutSelection: nil) else { return }
bottomSheetViewController.modalPresentationStyle = .overFullScreen
bottomSheetViewController.modalTransitionStyle = .crossDissolve
present(bottomSheetViewController, animated: true)
  • With custom configuration:
let childViewController: SFBottomSheetChildControllerProtocol = SFBottomSheetChildViewController()
var let configuration: SFBottomSheetConfigurable = CustomConfiguration()
configuration.draggableAlpha = 0.7
configuration.contentViewBackgroundColor = UIColor(red: 0, green: 0, blue: 0, alpha: 0.8)
guard let bottomSheetViewController = SFBottomSheetViewController.createScene(child: childViewController,
                                                                        configuration: configuration,
                                                                        didFinishWithoutSelection: nil) else { return }
bottomSheetViewController.modalPresentationStyle = .overFullScreen
bottomSheetViewController.modalTransitionStyle = .crossDissolve
present(bottomSheetViewController, animated: true)

For more examples and usage, please refer to the Wiki.

Extra Informations

  • If you have any trouble open a Issue
  • If you want to contribute to the project, make a Pull Request and explain what your change does.

Release History

  • 0.0.1
    • Initial setup
  • 0.0.2
    • Updated .podspec source_files
  • 0.0.3
    • Updated SFBottomSheetViewController createScene func protection level
  • 0.0.4
    • Updated .podspec resource_bundles and fix SFBottomSheetViewController instantiation
  • 0.0.6
    • Updated .podspec and provide SFBottomSheetConfigurable public init
  • 0.0.7
    • Fixing child trailing constraint by updating SFBottomSheetChildControllerProtocol

Meta

Aleksandar Gyuzelov – @ScaleFocus – [email protected]

Distributed under the MIT license. See LICENSE for more information.

Contributing

  1. Fork it (https://github.com/scalefocus/SFBottomSheet/fork)
  2. Create your feature branch (git checkout -b feature/branch-name)
  3. Commit your changes (git commit -am 'Descriptive commit message')
  4. Push to the branch (git push origin feature/branch-name)
  5. Create a new Pull Request

Contributors