How do I change the animation speed in FanMenu?

Set the 'duration' property to a Double value, such as 0.35 for a 0.35-second animation, as demonstrated in the configuration section of the README. This controls the opening and closing animation timing.

FanMenu vs Ramotion circle-menu: which is better for iOS?

FanMenu leverages Macaw for vector-based smooth animations and allows deep source customization in a single file. Ramotion circle-menu might offer different styling or integration approaches, so choose based on your need for Macaw dependency or pre-built features.

Does FanMenu work with SwiftUI?

FanMenu is a UIKit-based component, so it doesn't natively support SwiftUI. You would need to wrap it in a UIViewRepresentable to use it in SwiftUI projects, which adds extra boilerplate code.

How can I install FanMenu without CocoaPods?

Use Carthage by adding 'github Exyte/fan-menu' to your Cartfile, or manually copy the FanMenu.swift file into your Xcode project. The README provides detailed steps for both Carthage and manual installation.

What iOS and macOS versions does FanMenu support?

FanMenu requires iOS 9.0+ or macOS 10.12+, and Xcode 10.2+ as per the requirements. This ensures compatibility with older systems but may limit use on newer Swift-only projects.

How do I customize the menu background color in FanMenu?

Set the 'menuBackground' property to a Color value, like Color.red, as shown in the configuration examples. This allows you to match the menu's appearance to your app's design theme.

Open-Awesome

FanMenu

MITSwift

A customizable floating circular menu for iOS/macOS built with the Macaw vector graphics library.

GitHub

724 stars54 forks0 contributors

What is FanMenu?

FanMenu is a Swift library that provides a floating circular menu with a radial layout for iOS and macOS applications. It enables developers to create visually appealing, fan-style menus that expand from a central button to enhance user interface navigation and actions. Built using the Macaw vector graphics library, it offers smooth animations and deep customization.

Target Audience

iOS and macOS developers looking to implement interactive, circular floating menus in their applications, particularly those who value visual design and need a customizable radial navigation component.

Value Proposition

Developers choose FanMenu for its easy integration and high customizability through simple Swift properties, along with its foundation on Macaw for vector-based graphics enabling smooth animations and visual fidelity. It provides precise event handling and programmatic control over menu states.

Overview

Menu with a circular layout based on Macaw

Use Cases

Best For

Implementing floating action buttons with radial menu options in iOS/macOS apps
Creating visually engaging navigation menus with fan-style circular layouts
Adding customizable interactive menus with smooth animations using vector graphics
Building finance or task management apps with stylish circular action selectors
Developing apps that require programmatic control over menu open/close states and event handling
Integrating a lightweight, single-file menu component that can be easily modified via Macaw

Not Ideal For

Projects that must minimize third-party dependencies, as FanMenu relies on the Macaw vector graphics library
Applications requiring non-circular menu layouts, such as linear or grid-based navigation
Teams needing out-of-the-box accessible UI components without additional customization work

Pros & Cons

Pros

Easy Customization

Colors, images, animation duration, radius, and background can be configured through simple Swift properties, as shown in the usage examples with menuRadius and duration settings.

Precise Event Handling

Supports onItemDidClick and onItemWillClick callbacks, allowing developers to control user interactions before and after animations for fine-grained response.

Programmatic State Control

Methods like open(), close(), and the isOpen property enable dynamic management of the menu's open/close state directly in code.

Vector Graphics Foundation

Built with the Macaw library, ensuring smooth animations and high visual fidelity, with the entire source in one file for easy modification.

Cons

Macaw Dependency

Requires the Macaw library, which adds an external dependency and can increase app size or complexity if not already integrated.

Layout Inflexibility

Designed exclusively for circular fan menus, making it unsuitable for other menu styles like linear or dropdown without significant source code changes.

Accessibility Oversight

The README does not address built-in accessibility features, so developers must manually implement accessibility support for screen readers and other assistive technologies.

Frequently Asked Questions

Related Projects

RESideMenu

iOS 7/8 style side menu with parallax effect.

Stars7,049

Forks1,325

Last commit8 years ago

XLPagerTabStrip

Android PagerTabStrip for iOS.

Stars7,003

Forks1,316

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,826

Forks695

Last commit3 years ago

ViewDeck

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

Stars5,271

Forks956