RapidFloatingActionButton标签列表实战:10行代码复刻Google Inbox风格悬浮菜单
RapidFloatingActionButton标签列表实战:10行代码复刻Google Inbox风格悬浮菜单
RapidFloatingActionButton(简称 RFAB)是一款轻量级 Android 悬浮按钮组件库,提供"快速方案(Quick solutions)":点击右下角的圆形按钮,即可展开一个仿 Google Inbox 的标签列表菜单。本文带你了解 RFAB 标签列表的原理与用法,10 行左右的代码就能在项目里跑起来。🚀
先看效果:Google Inbox 风格是什么样子?
RFAB 的核心卖点是 RapidFloatingActionContentLabelList(RFAC Label List,标签列表内容)。每个条目由"文字标签 + 圆形图标"组成,从按钮处向上依次弹出,还带半透明遮罩和回弹动画,和当年 Google Inbox 的 FAB 菜单如出一辙:
除了标签列表,库还内置了分组按钮(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'
最小步骤清单:
- XML 中声明
RapidFloatingActionLayout包裹RapidFloatingActionButton new RapidFloatingActionContentLabelList(context)创建内容- 构造
RFACLabelItem列表并setItems() new RapidFloatingActionHelper(context, layout, button, content).build()- 实现监听接口,处理
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 菜单就完成了。✅
