The CircularFloatingActionMenu is an Android library that provides a customizable circular floating action menu. It allows users to display a main floating action button (FAB) that, when clicked, expands to reveal a circular menu with additional action buttons.

Pros

• Customizable Appearance: The library offers a wide range of customization options, allowing developers to adjust the size, color, and animation of the circular menu and its buttons.
• Smooth Animations: The circular menu and its buttons are animated smoothly, providing a visually appealing user experience.
• Easy Integration: The library is easy to integrate into existing Android projects, with clear documentation and sample code provided.
• Flexible Layout: The circular menu can be positioned in various locations on the screen, making it suitable for different app designs.

Cons

• Limited Functionality: The library primarily focuses on the circular floating action menu and does not provide additional features or functionality beyond that.
• Dependency on External Libraries: The library relies on the com.nineoldandroids:library and com.daimajia.easing:library libraries, which may increase the overall project size.
• Potential Performance Issues: Depending on the number of buttons in the circular menu and the complexity of the animations, the library may have a negative impact on the app's performance, especially on older or less powerful devices.
• Lack of Customization for Individual Buttons: While the overall appearance of the circular menu can be customized, the individual buttons within the menu have limited customization options.

Code Examples

Initializing the Circular Floating Action Menu

CircularFloatingActionMenu circularMenu = (CircularFloatingActionMenu) findViewById(R.id.circular_menu);
circularMenu.setMainFabClosedBackgroundColor(Color.BLUE);
circularMenu.setMainFabOpenedBackgroundColor(Color.RED);
circularMenu.setMainFabClosedSrc(R.drawable.ic_add);
circularMenu.setMainFabOpenedSrc(R.drawable.ic_close);

This code initializes the CircularFloatingActionMenu and sets the background colors and icons for the main FAB in its closed and opened states.

Adding Buttons to the Circular Menu

circularMenu.addSubActionView(
    new SubActionButton.Builder(this)
        .setBackgroundDrawable(getResources().getDrawable(R.drawable.button_background))
        .setContentView(R.layout.sub_action_button)
        .build()
);

This code adds a new button to the circular menu, with a custom background drawable and a custom content view.

Handling Button Clicks

circularMenu.setStateChangeListener(new CircularMenuStateChangeListener() {
    @Override
    public void onMenuOpened() {
        // Handle menu opened event
    }

    @Override
    public void onMenuClosed() {
        // Handle menu closed event
    }

    @Override
    public void onButtonClicked(int index) {
        // Handle button click event
    }
});

This code sets a state change listener on the circular menu, allowing the app to respond to events such as the menu being opened or closed, and individual buttons being clicked.

Getting Started

To use the CircularFloatingActionMenu library in your Android project, follow these steps:

1. Add the library to your project's build.gradle file:

dependencies {
    implementation 'com.oguzdev:CircularFloatingActionMenu:1.0.2'
}

2. In your layout XML file, add the CircularFloatingActionMenu view:

<com.oguzdev.circularfloatingactionmenu.library.CircularFloatingActionMenu
    android:id="@+id/circular_menu"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_gravity="bottom|end"
    android:layout_marginEnd="16dp"
    android:layout_marginBottom="16dp" />

3. In your activity or fragment, initialize and configure the circular menu:

CircularFloatingActionMenu