MaterialActionSheetController

A Google like action sheet for iOS written in Swift.

Code Quality Rank: L5

Programming language: Swift

License: MIT License

Tags: UI     Alerts    

Latest version: v2.0

README

MaterialActionSheetController

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

<!---->

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.