How to add GuillotineMenu to an iOS app with Swift?

Install via CocoaPods by adding 'pod "GuillotineMenu"' to your Podfile, or manually add "GuillotineMenuTransitionAnimation.swift" to your project. Then, follow the Usage steps to set up the transitioning delegate and animator properties for presentation.

GuillotineMenu vs standard iOS modal presentation

GuillotineMenu offers a unique, custom animation for menu transitions, while standard modal presentations use built-in iOS animations with less visual flair. Choose GuillotineMenu for eye-catching UI effects, but expect more setup work compared to native modals.

Can I change the speed of the guillotine animation?

Yes, adjust the "duration" property on the animator to control animation timing, allowing fine-tuning for better user experience, as mentioned in the Customisation section of the README.

What iOS versions does GuillotineMenu support?

It requires iOS 8.0 or later, and is compatible with Swift 5.0 (v4.1+) or Swift 4.2 (v4.0), making it suitable for modern iOS projects but not for apps targeting older versions.

How to handle button taps in GuillotineMenu?

Set the "presentButton" property on the animator to the button triggering the menu, and use delegate methods or standard UIViewController actions to manage interactions, as outlined in the Usage and Customisation sections.

Is GuillotineMenu accessible for VoiceOver?

The README doesn't mention accessibility features; you'll need to manually ensure elements are labeled and focusable, as custom transitions can interfere with native accessibility if not handled carefully.

Open-Awesome

GuillotineMenu

MITSwift3.0.2

A Swift library implementing a guillotine-style menu transition animation for iOS apps.

Visit Website GitHub

2.9k stars249 forks0 contributors

What is GuillotineMenu?

GuillotineMenu is a Swift library that provides a custom transitioning animation for presenting and dismissing menus in iOS applications. It animates the menu like a guillotine blade dropping from a specified anchor point, such as a navigation bar button, creating a distinctive and engaging user interface effect.

Target Audience

iOS developers building apps with custom navigation or menu interfaces who want to implement a unique, eye-catching transition animation.

Value Proposition

It offers a ready-to-use, visually striking animation that is easy to integrate via CocoaPods or manual file addition, with customizable anchor points and animation timing, saving development time compared to building a custom transition from scratch.

Overview

Our Guillotine Menu Transitioning Animation implemented in Swift reminds a bit of a notorious killing machine.

Use Cases

Best For

Adding a unique menu reveal animation to iOS apps
Creating custom navigation transitions from a navigation bar button
Implementing side or top bar menus with engaging animations
Enhancing UI/UX with distinctive visual feedback for menu interactions
Prototyping or building apps with non-standard navigation patterns
Learning about custom UIViewController transitioning in Swift

Not Ideal For

Apps relying on standard iOS navigation patterns like tab bars or simple modal sheets
Projects needing complex, multi-level menu systems with nested animations
Teams prioritizing accessibility out-of-the-box for screen readers or voice control
Applications with strict performance budgets where custom transitions could cause jank

Pros & Cons

Pros

Unique Visual Appeal

The guillotine blade animation is distinctive and engaging, as shown in the example GIF, providing a memorable user experience that stands out from standard iOS transitions.

Easy CocoaPods Integration

It supports installation via CocoaPods with a simple pod command, or manual file addition, saving time compared to building custom transitions from scratch.

Customizable Anchor Points

Developers can specify the support view (like a navigation bar) and button for the animation, allowing flexibility in UI design, as detailed in the Usage section.

Delegate Lifecycle Hooks

Provides delegate methods to hook into animation start and finish events, enabling custom actions during transitions without interfering with the core animation.

Cons

Limited Animation Variety

It only implements the guillotine blade animation, lacking support for other transition styles, which reduces versatility for projects needing diverse menu effects.

Manual Setup Boilerplate

Requires implementing UIViewControllerTransitioningDelegate and configuring animator properties, adding complexity and code overhead, as seen in the Usage steps.

Sparse Documentation Depth

The README is brief and assumes prior knowledge of custom transitions, offering minimal troubleshooting guidance or advanced customization examples.

Frequently Asked Questions

Related Projects

RESideMenu

iOS 7/8 style side menu with parallax effect.

Stars7,043

Forks1,318

Last commit8 years ago

XLPagerTabStrip

Android PagerTabStrip for iOS.

Stars6,999

Forks1,312

Last commit2 years ago

SideMenu

Simple side/slide menu control for iOS, no code necessary! Lots of customization. Add it to your project in 5 minutes or less.

Stars5,814

Forks694

Last commit3 years ago

ViewDeck

An implementation of the sliding menu found in various iOS apps.

Stars5,266

Forks956

Last commit4 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub