Popularity
2.3
Growing
Activity
3.5
-
99
6
9

Code Quality Rank: L5
Monthly Downloads: 0
Programming language: Swift
License: MIT License
Tags: UI     Alerts    
Latest version: v2.0

MaterialActionSheetController alternatives and similar libraries

Based on the "Alerts" category

Do you think we are missing an alternative of MaterialActionSheetController or a related project?

Add another 'Alerts' Library

README

MaterialActionSheetController

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

<!--CI Status--> Version License Platform

Screenshots

  • Demo
Default light theme Dark theme Custom header

Features

  • [x] Using closures to configure actions
  • [x] Action with optional icon and accessory view
  • [x] Handling touch on accessory view
  • [x] Separate long action list in sections
  • [x] Using closures to callback when controller is about to dismiss
  • [x] 2 built-in themes: light & dark
  • [x] Customizable header
  • [x] 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.


*Note that all licence references and agreements mentioned in the MaterialActionSheetController README section above are relevant to that project's source code only.