Android CircularFloatingActionMenu 使用教程

1. 项目介绍

CircularFloatingActionMenu 是一个灵感来源于Path应用的动画化可定制的圆形浮动菜单库，适用于Android平台。它允许你添加一个具有扇形展开效果的浮行动作按钮到你的应用中，提供了一种独特且吸引人的用户交互方式。

2. 项目快速启动

添加依赖

在你的 build.gradle 文件的 dependencies 部分添加以下依赖：

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

然后同步Gradle项目以获取最新依赖。

示例代码

在布局文件中添加 CircularFloatingActionMenu：

<com.oguzdev.circularfloatingactionmenu.library.CircleFlowMenu
    android:id="@+id/circular_menu"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:fab_size="normal"
    app:menu_color="#FF009688">

    <android.widget.FloatingActionButton
        android:id="@+id/action1"
        android:src="@drawable/ic_action1"
        app:borderWidth="0dp"
        app:elevation="6dp"
        app:fab_size="mini" />

    <!-- 更多子项... -->

</com.oguzdev.circularfloatingactionmenu.library.CircleFlowMenu>

在你的Activity或Fragment中初始化并设置监听器：

CircleFlowMenu menu = findViewById(R.id.circular_menu);
menu.setMenuButtonOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        // 当菜单按钮被点击时执行的操作
    }
});

动态添加子项

你也可以在运行时动态添加子项：

FloatingActionButton fab1 = new FloatingActionButton(context);
fab1.setImageResource(R.drawable.ic_action1);

menu.addButton(fab1);

3. 应用案例和最佳实践

• 将 CircularFloatingActionMenu 用于主要功能展示，保持界面简洁。
• 自定义颜色和大小以匹配你的应用主题。
• 适当使用动画过渡，提供流畅的用户体验。
• 给每个子项添加回调，以便当用户选择某项操作时处理相关逻辑。

4. 典型生态项目

• Path App: 此项目最初受到Path应用程序中类似菜单的启发。
• Material Design Components (MDC): Google的Material Design库提供了类似功能的BottomSheet和FabSpeedDial，虽然不是完全相同的扇形展开，但它们都是浮动动作按钮的扩展。

更多示例和自定义选项可以在项目的GitHub页面上查看，包括完整的API文档和示例代码。在实践中，你可以根据项目需求进行更深入的定制。