danielsaidi/Sheeeeeeeeet

Sheeeeeeeeet is a Swift library for creating menus, custom action sheets, context menus etc.


Keywords
actionsheet, carthage, cocoapods, context-menu, ios, popover, spm, swift, uialertcontroller
License
MIT

Documentation

Sheeeeeeeeet

Version Platform Swift 5.1 MIT License Twitter: @danielsaidi

About Sheeeeeeeeet

Sheeeeeeeeet lets you create menus that can be presented as iOS 13 context menus, custom action sheets, alert controllers or in any way you like.

Sheeeeeeeeet comes with many item types (standard items, buttons, titles, toggles etc.) and can be extended with your own custom item types.

Sheeeeeeeeet's custom action sheets can be styled to look just like a UIAlertController or completely different. You can also customize how they are presented and dismissed.

Installation

Swift Package Manager

https://github.com/danielsaidi/Sheeeeeeeeet.git

CocoaPods

pod "Sheeeeeeeeet"

Creating a menu

With Sheeeeeeeeet, you start with creating a menu, like this:

let item1 = MenuItem(title: "Int", value: 1)
let item2 = MenuItem(title: "Car", value: Car())
let button = OkButton(title: "OK")
let items = [item1, item2, button]
let menu = Menu(title: "Select a type", items: items)

Sheeeeeeeeet has many built-in item types, e.g. buttons, select items, links etc. A complete list can be found here.

You can also create your own custom item types by inheriting any of the existing ones. For instance, if you build a car rental app, you can create a car-specific item that takes a Car model.

You can even create your own menu types by subclassing Menu. This makes it possible to create app-specific menus that provide specific functionality, handle specific tasks etc.

Present a menu as an action sheet

You can present menus as custom action sheets:

let sheet = menu.toActionSheet(...) { sheet, item in ... }
sheet.present(in: vc, from: view) { sheet, item in ...
    print("You selected \(item.title)")
}

You can find more information in this action sheet guide.

Add a menu as a context menu

You can add menus as iOS 13 context menus to any view you like:

menu.addAsContextMenu(to: view) { sheet, item in ...
    print("You selected \(item.title)")
}

You can find more information in this context menu guide.

Present the menu as an alert controller

You can present menus as UIAlertControllers:

let delegate = menu.presentAsAlertController(in: self, from: view) { sheet, item in ...
    print("You selected \(item.title)")
}

You can find more information in this alert controller guide.

Demo App

This repository contains a demo app that demonstrates different menus and menu items, including subclassing and appearance adjustments.

To try it out, open and run the Sheeeeeeeeet.xcodeproj project.

Contact me

Feel free to reach out if you have questions or if you want to contribute to this project in any way:

Sponsor my work

You can support my work by becoming a GitHub Sponsor.

License

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