浮动菜单(FloatingMenu)开源项目教程

骆宜鸣King

于 2024-09-01 08:14:00 发布

阅读量503

点赞数 8

本文链接：https://blog.csdn.net/gitblog_00146/article/details/141769959

版权

浮动菜单(FloatingMenu)开源项目教程

floatingMenuAn orbit-like action button项目地址:https://gitcode.com/gh_mirrors/fl/floatingMenu

1. 项目介绍

浮动菜单(FloatingMenu)是一款专为Android平台设计的UI组件库，它提供了优雅的动画效果以及灵活的自定义能力，用于实现一个从主按钮扩展出多个子按钮的交互式浮动菜单。此组件支持通过XML布局及程序代码两种方式来配置其外观和行为，包括动画类型、展开角度、运动风格等，允许开发者轻松集成并高度定制以匹配不同应用的需求。

2. 项目快速启动

添加依赖

首先，在你的Android项目的build.gradle(Module)文件中添加FloatingMenu的依赖。由于提供的链接指向的是GitHub仓库而非直接的依赖源，你需要先将该项目下载或将其作为子模块加入到你的项目中，然后本地引用。这里假设你已经下载了项目，并知道如何把它作为库引入。

如果你是直接复制到了项目内，确保项目结构允许访问，然后在你的app的build.gradle文件中添加相应的模块依赖路径（此步骤基于假设，实际操作可能需调整）：

dependencies {
    implementation project(':floatingMenuLib')
}

示例代码

接下来，为了快速启动，你需要在你的Activity或者Fragment中初始化FloatingMenuButton，并设置基本属性：

import com.rjsvieira.floatingmenu.FloatingMenuButton;
import com.rjsvieira.floatingmenu.FloatingSubButton;

// 在onCreate方法中
FloatingMenuButton floatingButton = (FloatingMenuButton) findViewById(R.id.my_floating_button);
floatingButton.setStartAngle(0); // 设置起始展开角度
floatingButton.setEndAngle(360); // 设置结束展开角度
floatingButton.setAnimationType(AnimationType.EXPAND); // 动画类型
floatingButton.addFloatingSubButton(new FloatingSubButton(this)); // 添加子按钮示例

// 响应按钮状态变化
floatingButton.setStateChangeListener(new FloatingMenuButtonStateChangeListener() {
    @Override
    public void onMenuOpened(FloatingMenuButton menu) {
        // 菜单打开时的操作
    }

    @Override
    public void onMenuClosed(FloatingMenuButton menu) {
        // 菜单关闭时的操作
    }
});

记得在你的XML布局文件中添加FloatingMenuButton:

<FloatingMenuButton
    android:id="@+id/my_floating_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:layout_constraintBottom_toBottomOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent"
    floatingMenuActionButton:animationType="radial" />