RapidFloatingActionButton标签列表实战:10行代码复刻Google Inbox风格悬浮菜单

原创2026-10-18 10:20:491,949 阅读

RapidFloatingActionButton标签列表实战:10行代码复刻Google Inbox风格悬浮菜单

RapidFloatingActionButton(简称 RFAB)是一款轻量级 Android 悬浮按钮组件库,提供"快速方案(Quick solutions)":点击右下角的圆形按钮,即可展开一个仿 Google Inbox 的标签列表菜单。本文带你了解 RFAB 标签列表的原理与用法,10 行左右的代码就能在项目里跑起来。🚀

先看效果:Google Inbox 风格是什么样子?

RFAB 的核心卖点是 RapidFloatingActionContentLabelList(RFAC Label List,标签列表内容)。每个条目由"文字标签 + 圆形图标"组成,从按钮处向上依次弹出,还带半透明遮罩和回弹动画,和当年 Google Inbox 的 FAB 菜单如出一辙:

RapidFloatingActionButton标签列表:仿Google Inbox风格的RFAB悬浮菜单展开动效

除了标签列表,库还内置了分组按钮(RFAB Group)和卡片列表两种内容形态,完整效果可以在 screenshot/ 目录的官方演示动图中看到。

三大核心组件:理解 RFAB 标签列表的架构

在使用前,先建立心智模型。RFAB 的标签列表由 4 个角色协作完成,源码都在 library/ 模块中:

组件 职责 源码位置
RapidFloatingActionLayout 最外层容器,负责展开/收起动画与遮罩 RapidFloatingActionLayout.java
RapidFloatingActionButton 屏幕右下角的圆形悬浮按钮 RapidFloatingActionButton.java
RapidFloatingActionContentLabelList 标签列表内容,即菜单本体 RapidFloatingActionContentLabelList.java
RapidFloatingActionHelper "粘合剂",把三者组装并自动绑定点击事件 RapidFloatingActionHelper.java

关键设计在于:布局 XML 只声明容器 + 按钮,菜单内容由代码注入。RapidFloatingActionHelper 在 build() 时会自动把 Layout、Button、Content 三方的监听器互相绑定——这就是为什么你几乎不用写事件代码。

一键添加标签列表:XML 布局只需这样写

打开示例工程,标签列表的布局只有两个核心节点,完整文件见 label_list_sample.xml:

<com.wangjie.rapidfloatingactionbutton.RapidFloatingActionLayout
        xmlns:rfal="http://schemas.android.com/apk/res-auto"
        android:id="@+id/label_list_sample_rfal"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        rfal:rfal_frame_color="#ffffff"
        rfal:rfal_frame_alpha="0.7">

    <com.wangjie.rapidfloatingactionbutton.RapidFloatingActionButton
            xmlns:rfab="http://schemas.android.com/apk/res-auto"
            android:id="@+id/label_list_sample_rfab"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentRight="true"
            android:layout_alignParentBottom="true"
            android:layout_marginRight="15dp"
            android:layout_marginBottom="15dp"
            rfab:rfab_size="normal"
            rfab:rfab_color_normal="#37474f"
            rfab:rfab_color_pressed="#263238"
            rfab:rfab_shadow_radius="7dp"
            rfab:rfab_shadow_color="#999999"
            rfab:rfab_shadow_dy="5dp"
            />
</com.wangjie.rapidfloatingactionbutton.RapidFloatingActionLayout>

常用属性说明(完整定义见 attrs.xml):

  • rfal_frame_color / rfal_frame_alpha:菜单展开时背景遮罩的颜色和透明度(0 ~ 1)
  • rfab_size:按钮尺寸,支持 normal(56dp)和 mini(40dp)两种 Material Design 规格
  • rfab_color_normal / rfab_color_pressed:按钮常态与按压态颜色
  • rfab_shadow_radius / shadow_color / shadow_dx / shadow_dy:按钮投影的半径、颜色与偏移量

10行代码创建标签列表菜单

接下来是重头戏。在 LabelListSampleActivity.java 中,创建菜单只需这几步:

RapidFloatingActionContentLabelList rfaContent = new RapidFloatingActionContentLabelList(this);
rfaContent.setOnRapidFloatingActionContentLabelListListener(this);

List<RFACLabelItem> items = new ArrayList<>();
items.add(new RFACLabelItem<Integer>()
                .setLabel("Compose")
                .setResId(R.mipmap.ico_test_a)
                .setIconNormalColor(0xff283593)
                .setIconPressedColor(0xff1a237e)
                .setLabelColor(0xff283593)
                .setWrapper(3)
);
rfaContent.setItems(items);

RapidFloatingActionHelper rfabHelper = new RapidFloatingActionHelper(
        this, rfaLayout, rfaButton, rfaContent
).build();

setItems() 塞入条目、Helper.build() 完成组装,菜单就跑起来了——这就是"10 行代码"的由来。🎉

定制每个标签:RFACLabelItem 链式配置详解

菜单条目 RFACLabelItem 是标签列表的"最小单元",采用 Builder 式链式 API(全部配置方法见 RFACLabelItem.java):

  • setResId(int) / setDrawable(Drawable):图标二选一,前者用资源 ID,后者直接传入 Drawable 对象
  • setLabel(String):标签文字
  • setIconNormalColor / setIconPressedColor:图标的常态与按压态颜色(会作用于圆形背景)
  • setLabelColor / setLabelSizeSp:标签文字的颜色与字号
  • setLabelBackgroundDrawable(Drawable):自定义标签背景,例如用 RFABShape.java 生成圆角半透明背景
  • setWrapper(T):任意自定义数据载体,点击回调时会原样带回,方便你在 Activity 中做路由判断

在内容层面,还能统一设置所有图标的投影(LabelListSampleActivity.java 中的 setIconShadowRadius 等三个方法)。

💡 小提示:RapidFloatingActionContentLabelList 内部会把 items 逐条 inflate 成 rfab__content_label_list_item.xml(一行 = TextView + ImageView),并且要求 items 不能为空,否则会直接抛出运行时异常。条目数量建议控制在 4~6 个以内,屏幕空间有限。

响应点击事件:监听器回调怎么写?

标签列表的点击分两种:点了文字标签和点了圆形图标,分别对应两个回调(接口定义见 RapidFloatingActionContentLabelList.java):

@Override
public void onRFACItemLabelClick(int position, RFACLabelItem item) {
    Toast.makeText(this, "clicked label: " + position, Toast.LENGTH_SHORT).show();
    rfabHelper.toggleContent();   // 点击后收起菜单
}

@Override
public void onRFACItemIconClick(int position, RFACLabelItem item) {
    Toast.makeText(this, "clicked icon: " + position, Toast.LENGTH_SHORT).show();
    rfabHelper.toggleContent();
}

position 是条目下标,item.getWrapper() 则能取回你之前用 setWrapper() 存入的数据。菜单操作 API 也很直白,都由 RapidFloatingActionHelper 代理(见 RapidFloatingActionHelper.java):

  • toggleContent():展开/收起切换
  • expandContent():强制展开
  • collapseContent():强制收起

进阶玩法:自定义展开内容与动画

如果标签列表不满足需求,RFAB 提供了扩展点:继承 RapidFloatingActionContent.java,自己初始化任意布局后调用 setRootView(xxx) 即可替换菜单内容(官方自定义示例见 CardItem.java 所在的 cardtest 目录,效果为卡片式列表)。

想加自己的进出场动画?重写这两个方法,把动画追加到 AnimatorSet 中即可:

public void onExpandAnimator(AnimatorSet animatorSet);
public void onCollapseAnimator(AnimatorSet animatorSet);

此外,库还提供了两个开箱即用的其他形态,示例入口在 RFABGroupSampleActivity.java(按钮组)与 RapidFloatingActionContentCardListView.java(卡片列表)。

快速上手与常见问题清单

依赖接入:Gradle 添加一行即可(版本号以 Maven Central 上 com.github.wangjiegulu:rfab 的最新版本为准):

compile 'com.github.wangjiegulu:rfab:x.x.x'

最小步骤清单:

  1. XML 中声明 RapidFloatingActionLayout 包裹 RapidFloatingActionButton
  2. new RapidFloatingActionContentLabelList(context) 创建内容
  3. 构造 RFACLabelItem 列表并 setItems()
  4. new RapidFloatingActionHelper(context, layout, button, content).build()
  5. 实现监听接口,处理 onRFACItemLabelClick / onRFACItemIconClick

FAQ:

  • 展开菜单时背景没有变暗? 检查 rfal:rfal_frame_alpha,默认 0.7,设为 0 则无遮罩。
  • 图标没有投影? 投影需同时满足 rfab_shadow_radius > 0 且设置了 rfab_shadow_color,二者缺一不生效。
  • 点击条目后想保留菜单? 回调里不调用 rfabHelper.toggleContent() 即可。

从 XML 到 Helper,RFAB 把 Google Inbox 风格悬浮菜单拆成了"声明 + 组装"两步,标签列表内容全部由数据驱动。上手示例工程 LabelListSampleActivity.java 跑通后,再按需求替换图标、配色与回调逻辑,一个高还原度的 FAB 菜单就完成了。✅

登录后查看全文
RapidFloatingActionButton