mat

MaterialActionSheetController

A Google like action sheet for iOS written in Swift.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

104

Maintenance

Last Commit

2yrs ago

Contributors

0

Package

Dependencies

0

License

MIT

Categories

Readme

MaterialActionSheetController

Lightweight and totally customizable. Create and present it the way you do with UIAlertController.

Version License Platform

Screenshots

  • Demo
Default light themeDark themeCustom header

Features

  • Using closures to configure actions
  • Action with optional icon and accessory view
  • Handling touch on accessory view
  • Separate long action list in sections
  • Using closures to callback when controller is about to dismiss
  • 2 built-in themes: light & dark
  • Customizable header
  • Swift 3 compliant

Todos

  • Present on iPad as a pop-up
  • Documenting

Requirements

  • iOS 8.0+
  • Xcode 8
  • Swift 3

Installation

CocoaPods

MaterialActionSheetController is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'MaterialActionSheetController'

Manually

Add MaterialActionSheetController.swift to your project

Usage

// Import MaterialActionSheetController if you're using CocoaPods
import MaterialActionSheetController
// Create an action
let lightBulbAction = MaterialAction(
        icon: UIImage(named: "lightbulb"),
        title: "Action with UISwitch as an accessory view", handler: { [unowned self] (accessoryView) in
            self.doSomething()
        }, 
        accessoryView: UISwitch(), 
        dismissOnAccessoryTouch: true, 
        accessoryHandler: { [unowned self] (accessoryView) in
            if let lightBulbSwitch = accessoryView as? UISwitch {
                if accessoryView.on {
                    print("Light is ON!")
                } else {
                    print("Light is OFF!")
                }
            }
            self.doSomeOtherThing()
    })
// Then create your MaterialActionSheetController
// parameter sections is a variadic which take a flexible list of section
let materialActionSheetController = MaterialActionSheetController(
        title: "A nice title",
        message: "A friendly message",
        actionSections: [aCoolAction, anotherCoolAction], [cancelAction])
// Or create 
let materialActionSheetController = MaterialActionSheetController()
materialActionSheetController.title = "A nice title"
materialActionSheetController.message = "A friendly message"
materialActionSheetController.actionSections.append([aCoolAction, anotherCoolAction])
materialActionSheetController.actionSections.append([cancelAction])
// Customize theme
materialActionSheetController.theme = MaterialActionSheetTheme.dark()

// Custom header view
let imageView = UIImageView(image: UIImage(named: "myimage"))
imageView.bounds = CGRect(origin: CGPoint.zero, size: CGSize(width: 300, height: 100))
materialActionSheetController.customHeaderView = imageView

// Handler on "will dismiss" and "did dismiss" event
materialActionSheetController.willDismiss = { [unowned self] in
    print("I will dismiss.")
    self.doSomething()
}

// Finally present it
materialActionSheetController.didDismiss = { [unowned self] in
    print("I did dismiss.")
    self.doSomething()
}

presentViewController(materialActionSheetController, animated: true, completion: nil)

See code in demo for more detailed examples.

Contribute

Feel free to make PR, contributions are warmly welcome and appreciated.

License

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

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100