• 文档
• 知识库

本文以 AndroidLibs 仓库中 按钮Button/README.md 为主线，系统梳理其中收录的 60 个按钮类开源组件库，涵盖复选框、单选按钮、开关、滑动按钮、FloatingActionButton、加载进度按钮与圆角/圆形按钮等全部细分方向。读完本文，你将获得一张按功能分类的"按钮开源库速查表"，并理解各类按钮增强库背后的 Android 自定义控件实现思路，从而在实际项目中快速完成选型。

一、专题背景：AndroidLibs 与"按钮 Button"目录

AndroidLibs 是一个面向 Android 开发的优秀开源组件库汇总仓库，根目录 README.md 将其定位为"收集 Android 开发中优秀的开源组件库，方便大家查询"，并按功能划分为列表、动画、图标、图片框架、布局、开发框架、弹框、按钮、文本、特效、网络框架、自定义控件、菜单、辅助工具、进度条等二十余个专题目录，同时欢迎开发者通过 PR 持续补充内容；仓库整体以 Apache-2.0 协议发布（见 LICENSE）。

"按钮 Button"目录（按钮Button/README.md）的收录范围由文件首行明确界定：

包含：Button、FloatingActionButton……

也就是说，它不只是收录狭义的Button，而是把整个"按钮家族"都纳入了进来——从复选/单选类（CheckBox、RadioButton、RadioGroup）、开关类（ToggleButton、Switch）、滑动类，到 Material 风格的 FloatingActionButton，以及各种带加载、进度、液态、果冻动画的定制按钮，共 60 个开源项目。每个项目在文档中以"库名 + 项目地址 + 一句功能定位 + 效果图"的条目形式呈现；本文在此基础上按功能重新归类、逐条解读，并补充 Android 自定义控件层面的原理分析，帮助读者更快地对号入座。各库的原始项目主页地址与演示效果图均完整保留在上述文档条目中，可直接前往查阅与体验。

二、认识 Android 原生按钮家族（理解增强库的基础）

在逐个解读开源库之前，先建立原生控件的坐标系。Android 平台上的"按钮"其实是一个庞大的家族，核心成员包括：

这一家族关系解释了为什么"按钮"目录下会同时出现 CheckBox、RadioGroup、ToggleButton、Switch 与 FAB 类库——它们都属于按钮的语义范畴。理解了原生控件的分工，再看增强库就一目了然：绝大多数开源按钮库都是在原生控件之上做三件事——改样式（圆角、扁平、阴影）、加动画（勾选动画、加载动画、液态/果冻动画）、改行为（滑动、移动、命中区域、展开菜单）。

也正因如此，几乎所有增强库都沿用CompoundButton的setChecked()与setOnCheckedChangeListener()回调契约，接入时可以用统一的 API 思维去理解：

checkBox.setOnCheckedChangeListener((buttonView, isChecked) -> { // 统一处理勾选/开关状态变化 });

三、复选框与多选：CheckBox 系列增强库

3.1 多选管理与复合选择

这一组解决"如何管理多个复选框/复合按钮"的问题：

这三者本质上是对复合选择状态的组织与封装：原生层面对多选的管理需要开发者自己在容器中遍历子 View 并维护选中集合，而这些库把这个过程收敛为声明式的"组"，让业务代码只关心"哪些项被选中"。

3.2 带动画的 CheckBox

这一组是最能体现"自定义 View"功力的方向——把勾选动作本身做成动画：

从功能定位可以推断，这类库的通用实现路径是：继承 View（或 CompoundButton）→ 重写 onDraw 用 Canvas/Paint/Path 绘制勾选图形 → 用 ValueAnimator/AnimatorSet 驱动状态变化的中间帧 → 在 setChecked 回调中启动动画。选型时主要关注动画的插值曲线与时长是否契合产品气质，以及是否支持自定义颜色与尺寸。

3.3 圆形与特殊形态的多选按钮

CircularImageClick 尤其值得注意：它解决的是一个非常具体的交互细节——按钮视觉是圆的、点击热区却是矩形的"违和感"。实现上需要在分发触摸事件时先做圆形区域判定，再决定是否触发点击回调，这一类"命中测试（hit-test）"思路也适用于任意不规则形状的点击控件。

四、单选按钮：RadioButton 与 RadioGroup 增强

单选组的关键约束是"互斥"：原生 RadioGroup 通过 RadioButton 的setChecked回调自动管理互斥关系；增强库（如 MultiLineRadioGroup）的工作重心是在保持互斥逻辑的前提下重写布局算法，让选项既能换行又不破坏"单选"语义。

五、开关切换：ToggleButton / Switch 系列

开关类控件的技术要点集中在两点：一是状态管理（多态场景需要在setChecked之外扩展第三态枚举与回调）；二是状态切换动画（图形形变、弹性缩放、表情替换等）。由于原生 ToggleButton 基于 CompoundButton 的 checked 机制，增强库基本都沿用同一套回调契约，接入时仍可复用setOnCheckedChangeListener。

六、滑动与移动式按钮

这一类按钮的共同点是打破"点击即触发"的默认交互，把"滑动"或"移动"作为触发手段或反馈方式。实现上离不开onTouchEvent手势解析、View.animate()/ 属性动画位移以及边界判定，接入时尤其要注意与 ScrollView、RecyclerView 等可滚动容器的手势冲突，必要时通过事件拦截策略区分滑动方向。

七、FloatingActionButton（FAB）系列

FAB 是 Material Design 的核心组件之一，通常以 56dp 圆形悬浮按钮承载页面主操作。本目录收录的 FAB 类库覆盖面很全：

FAB 系列的两大扩展方向非常清晰：形态扩展（方形、带文字、带计数角标）与交互扩展（展开菜单、进场动画、转场）。其中"展开菜单"类（FABsMenu、faboptions）在实现上通常会让主 FAB 触发一组子按钮的"扇形/线性扩散动画"，同时覆盖半透明蒙层并处理返回手势以关闭菜单。

八、加载与进度按钮

"按钮 + 加载进度"是业务中最常见的诉求之一：点击提交 → 按钮进入 loading 状态 → 成功/失败后复位。本目录在这一方向收录了大量实现：

这类库的通用设计是"状态机驱动 + 形态动画"：把按钮抽象为normal → loading → success/failure等多个状态，状态切换时对按钮的宽高、圆角、文案、背景 Drawable 做属性动画过渡（例如按钮变圆并露出环形进度，完成后恢复原状）。接入时建议优先选择对外暴露startLoading()/stopLoading()/ 结果回传等状态接口的库，方便与网络请求的生命周期解耦。

九、形状、圆角与按压反馈

（注：圆形/形态类中的 MultiChoicesCircleButton、CircularImageClick、Cuboid-Circle-Button 已在第三、四节覆盖，此处不重复。）形状类按钮的实现主干是：背景 Drawable 定制（shape / StateListDrawable / RippleDrawable）+ 状态切换（pressed/checked）反馈。RaiflatButton 给出的思路尤其符合现代 Material 规范——用elevation/translationZ而非静态阴影图来表现按压层级变化。

十、目录中顺带收录的相邻组件

按钮目录还顺带收录了两个与"点击交互"强相关的相邻组件：

这两个条目说明该目录的收录口径较宽——与按钮的"触发行为"（弹窗、跳转）相关的组件也会一并收入，读者在查阅时留意即可。

十一、选型建议：按场景对号入座

综合上文，把 60 个库按业务场景浓缩成一张速查表：

选型时再叠加三条通用原则：

1. 先看交互是否符合产品：动画类库（液态、果冻、3D 视差）风格鲜明，先确认视觉效果契合产品气质再引入；
2. 关注接入成本：优先选择暴露清晰状态接口（如 loading 状态、checked 状态回调）的库，便于与业务生命周期解耦；
3. 注意版本兼容：涉及 elevation、Ripple、FAB 的库通常要求 minSdk 21+，需结合项目实际最低版本评估后再决定是否引入。

十二、结语：从按钮目录延伸出去

按钮是 Android 界面交互的最小单元，却衍生出"样式、动画、行为"三大扩展维度。本文以 按钮Button/README.md 为索引，将 60 个开源库归入复选、单选、开关、滑动、FAB、加载进度、形状反馈与相邻组件八大类，并逐类补充了背后的自定义 View 实现思路与选型要点；每个库的原始项目地址与演示效果图都保留在原文档条目中，可随时前往查阅。

若按钮需求与进度、弹窗、动画等其他方向联动，还可继续翻阅仓库中的 进度条Progressbar、弹框Dialog、动画Animation 等专题目录，或回到 README.md 查看完整分类总览。

• 文档
• 知识库