下拉展开动画的秘密:DropDownMenu中top_in/top_out与alpha动画实现全解析
下拉展开动画的秘密:DropDownMenu中top_in/top_out与alpha动画实现全解析
📌 一句话先说清楚:DropDownMenu 是一款 Android 下拉菜单(筛选器)组件库,它通过 top_in / top_out 位移动画配合 alpha 渐隐渐显动画,实现了"菜单面板从顶部滑出、同时背景遮罩淡入淡出"的经典下拉展开效果。下面这篇文章带你逐个文件看懂这套下拉展开动画的完整实现。
一、整体效果:一次"下拉展开"里发生了什么?
在常见的 App 筛选页(如电商列表页的"筛选"入口)中,点击顶部的筛选标签后:
- 🗂️ 下方的筛选面板从顶部向上滑出(位移动画)
- 🌫️ 内容区域上覆盖一层半透明黑色遮罩,由透明逐渐变深(alpha 动画)
- 🔙 再次点击或点按遮罩时,两者反向播放,面板收回、遮罩淡出
DropDownMenu 正是用两条并行的动画线来完成这个过程。核心实现全部集中在主类 DropDownMenu.java 的 initAnimation() 方法中。
二、四段动画资源:top_in、top_out 与两个 alpha 文件
动画资源位于 filter-lib/src/main/res/anim/ 目录下,共 4 个文件:
| 文件 | 类型 | 作用 |
|---|---|---|
| top_in.xml | translate(位移) | 面板展开:从屏幕上方滑入 |
| top_out.xml | translate(位移) | 面板收起:向上滑出屏幕 |
| alpha_to_one.xml | alpha(透明度) | 遮罩淡入:0.0 → 1.0 |
| alpha_to_zero.xml | alpha(透明度) | 遮罩淡出:1.0 → 0.0 |
top_in:展开动画的关键参数
top_in.xml 的内容非常简单,但每个参数都有讲究:
<translate xmlns:android="http://schemas.android.com/apk/res/android"
android:duration="300"
android:fromYDelta="-100%"
android:interpolator="@android:interpolator/decelerate_cubic"
android:toYDelta="0%" />
逐个解读:
fromYDelta="-100%"→toYDelta="0%":以视图自身高度为基准,起点在"自身上方一个屏幕高度"处,终点回到 0 位置。百分比是相对控件自身尺寸的,所以无论面板多高,动画都能完整地把面板从屏幕外"拉"进来。duration="300":动画时长 300 毫秒,这是下拉菜单的黄金时长——太短显得生硬,太长会拖沓。interpolator使用decelerate_cubic:减速曲线,先快后慢,模拟"面板被快速抛出后平滑停靠"的手感。
top_out:收起动画是展开的"镜像"
top_out.xml 与 top_in 恰好相反:
<translate xmlns:android="http://schemas.android.com/apk/res/android"
android:duration="300"
android:fromYDelta="0%"
android:interpolator="@android:interpolator/accelerate_cubic"
android:toYDelta="-100%" />
注意插值器换成了 accelerate_cubic(加速曲线)——收起过程先慢后快,像是"松手后迅速弹走"。一进一出使用相反的缓动曲线,是 Android 动画的常见细节,能让开合动作看起来更符合物理直觉。
三、initAnimation():把四段动画"装配"到一起
打开 DropDownMenu.java,核心方法 initAnimation()(约第 219 行)做了四件事:
private void initAnimation() {
occurAnimation = AnimationUtils.loadAnimation(getContext(), R.anim.top_in);
SimpleAnimationListener listener = new SimpleAnimationListener() {
@Override
public void onAnimationEnd(Animation animation) {
frameLayoutContainer.setVisibility(GONE);
}
};
dismissAnimation = AnimationUtils.loadAnimation(getContext(), R.anim.top_out);
dismissAnimation.setAnimationListener(listener);
alphaDismissAnimation = AnimationUtils.loadAnimation(getContext(), R.anim.alpha_to_zero);
alphaDismissAnimation.setDuration(300);
alphaDismissAnimation.setAnimationListener(listener);
alphaOccurAnimation = AnimationUtils.loadAnimation(getContext(), R.anim.alpha_to_one);
alphaOccurAnimation.setDuration(300);
}
对应关系一目了然:
| 成员变量 | 动画文件 | 施加对象 |
|---|---|---|
occurAnimation |
top_in | 当前筛选面板 |
dismissAnimation |
top_out | 当前筛选面板 |
alphaOccurAnimation |
alpha_to_one | 遮罩容器 |
alphaDismissAnimation |
alpha_to_zero | 遮罩容器 |
两个值得注意的细节
细节 1:代码里的 300ms 覆盖了 XML 里的 1000ms。
alpha_to_one.xml 中 alpha 动画的 duration 写的是 1000,但代码中调用 alphaOccurAnimation.setDuration(300) 将其改为 300ms。程序设置会覆盖 XML 定义,最终淡入淡出与位移动画同时长(300ms),保证"面板滑动"与"遮罩变深"完全同步,观感才协调。
细节 2:动画结束监听器负责"善后"。
Android 的 startAnimation() 只改视觉表现,不会改变视图的真实状态。因此在收起动画(top_out、alpha_to_zero)上挂了同一个监听器——它来自 SimpleAnimationListener.java,一个只需重写部分方法的基类。动画一结束,就把遮罩容器 setVisibility(GONE) 隐藏掉,避免它继续拦截用户点击。
四、触发时机:展开与收起分别在何时启动?
展开:onItemClick 中启动"双动画"
用户点击顶部标签后,进入 onItemClick()(约第 189 行):
if (isClosed()) {
frameLayoutContainer.setVisibility(VISIBLE);
frameLayoutContainer.startAnimation(alphaOccurAnimation);
// 可移出去, 进行每次展出
currentView.startAnimation(occurAnimation);
}
顺序是:先让遮罩容器变为 VISIBLE(此时它还是透明的,因为 alpha 动画刚从 0 开始),再同时启动遮罩淡入与面板滑入两条动画。由于两者时长一致,用户看到的就是"面板滑落、背景渐暗"的完整一步到位效果。
收起:close() 方法反向回放
close()(约第 151 行)负责收起,有两个入口会触发它:
- 再次点击顶部标签(
onItemClick中open为 true 时) - 点击遮罩区域(
onClick中判断isShowing()后调用)
public void close() {
if (isClosed()) {
return;
}
frameLayoutContainer.startAnimation(alphaDismissAnimation);
fixedTabIndicator.resetCurrentPos();
if (currentView != null) {
currentView.startAnimation(dismissAnimation);
}
}
注意这里的防御性判断:isClosed() 提前返回,避免重复收起时动画被二次触发;同时 isShowing() / isClosed()(第 142–149 行)通过遮罩容器的可见性来判断菜单状态,是整个组件状态机的核心。
五、动画与视图结构的关系
理解这套动画,还要知道 DropDownMenu 内部的三层结构(见 setContentView(),约第 60 行):
- FixedTabIndicator:顶部 50dp 高的筛选标签条,实现于 FixedTabIndicator.java
- contentView:外部传入的内容视图(如列表)
- frameLayoutContainer:动态创建的 FrameLayout,黑色半透明背景(
black_p50),专门承载各筛选面板并充当"遮罩"
top_in / top_out 动画施加的是容器内某一个筛选面板(currentView),而 alpha 动画施加的是整个容器——两条动画线作用在不同层级,正是"面板滑动 + 全局变暗"效果的来源。
六、给初学者的 3 个动画知识点总结 🎓
- 位移动画用百分比:
fromYDelta/toYDelta以控件自身高度为基准,用-100%即可实现"从屏幕外滑入",无需计算具体像素,自适应各种屏幕。 - 开合动画用镜像参数 + 相反插值器:展开用减速曲线
decelerate_cubic,收起用加速曲线accelerate_cubic,观感最自然。 - Animation 不改变视图状态:
startAnimation()结束后视图仍在原处,必须配合AnimationListener在onAnimationEnd中同步GONE等真实状态,否则会出现"看不见但挡点击"的经典 bug。
七、相关文件速查
| 说明 | 路径 |
|---|---|
| 组件主类(动画装配与触发) | DropDownMenu.java |
| 展开位移动画 | anim/top_in.xml |
| 收起位移动画 | anim/top_out.xml |
| 遮罩淡入 | anim/alpha_to_one.xml |
| 遮罩淡出 | anim/alpha_to_zero.xml |
| 动画结束监听基类 | util/SimpleAnimationListener.java |
| 顶部标签条视图 | view/FixedTabIndicator.java |
| 使用示例(Sample 模块) | MainActivity.java |
🔎 小结:DropDownMenu 的下拉展开动画本质上是"一条 300ms 的镜像 translate 动画 + 一条 300ms 的 alpha 动画",再加一个负责状态善后的动画监听器。理解了这三块,你就能在任何 Android 项目中快速复刻出同样流畅的下拉菜单动效。