fanmenu - SwiftGit

UI Components

fanmenu

November 25, 2023

Easily customizable floating circle menu created with Macaw

Usage

Create UIView in your storyboard or programatically.
Set FanMenu as UIView class.
Set the button


                                              
                                                fanMenu.button = FanMenuButton(

id: “main”,

image: “plus”,

color: Color(val: 0x7C93FE)

)

Set menu items


                                              
                                                fanMenu.items = [

FanMenuButton(

id: “exchange_id”,

image: “exchange”,

color: Color(val: 0x9F85FF)

),

…

FanMenuButton(

id: “visa_id”,

image: “visa”,

color: Color(val: 0xF55B58)

)

]

Add an event handler


                                              
                                                // call before animation

fanMenu.onItemDidClick = { button in

print(“ItemDidClick: \(button.id)”)

}

// call after animation

fanMenu.onItemWillClick = { button in

print(“ItemWillClick: \(button.id)”)

}

Configure optional parameters


                                              
                                                // distance between button and items

fanMenu.menuRadius = 90.0
// animation duration

fanMenu.duration = 0.35
// menu opening delay

fanMenu.delay = 0.05
// interval for buttons in radians

fanMenu.interval = (0, 2.0 * M_PI)
// menu background color

fanMenu.menuBackground = Color.red

Useful methods


                                              
                                                fanMenu.isOpen

fanMenu.open()

fanMenu.close()

Customization

FanMenu is created with Macaw, our vector graphics Swift library. Thanks to that, it can be easily modified and improved for your purposes.

All source code is located in one single file called FanMenu.swift. To modify the menu simply copy this file and apply necessary changes.

Examples

To try out the FanMenu examples:

Clone the repo git clone git@github.com:exyte/fan-menu.git
Open terminal and run cd <FanMenuRepo>/Example
Run pod install to install all dependencies
Run xed . to open project in the Xcode
Try it!

We have the following examples:

FinanceViewController.swift Accounting & Financial Management. Inspired by Yingfang Xie.
TaskViewController.swift Color Coding Microinteraction. Insipred by Filippos Protogeridis.
ShopViewController.swift Inspired by Tice.
CustomViewController.swift Inspired by awesome Ramotion control circle-menu

Installation

CocoaPods


                                              
                                                pod ‘FanMenu’

Carthage


                                              
                                                github ‘Exyte/fan-menu’

Manually

Drop FanMenu.swift into your project.

Requirements

iOS 9.0+ / macOS 10.12+
Xcode 10.2+

GitHub

View Github

#animation #ios #menu #swift #ui

YOU MIGHT ALSO LIKE...

July 26, 2025
SwiftUI

🧭 NavigationKit

NavigationKit is a lightweight library which makes SwiftUI navigation super easy to use. 💻 Installation 📦 Swift Package Manager Using Swift Package Manager, add ...

July 26, 2025
SwiftUI

swiftui-navigation-stack

An alternative SwiftUI NavigationView implementing classic stack-based navigation giving also some more control on animations and programmatic navigation. NavigationStack Installation ...