下拉展开动画的秘密:DropDownMenu中top_in/top_out与alpha动画实现全解析

原创2026-10-18 21:22:281,746 阅读

下拉展开动画的秘密: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 行):

  1. FixedTabIndicator:顶部 50dp 高的筛选标签条,实现于 FixedTabIndicator.java
  2. contentView:外部传入的内容视图(如列表)
  3. frameLayoutContainer:动态创建的 FrameLayout,黑色半透明背景(black_p50),专门承载各筛选面板并充当"遮罩"

top_in / top_out 动画施加的是容器内某一个筛选面板(currentView),而 alpha 动画施加的是整个容器——两条动画线作用在不同层级,正是"面板滑动 + 全局变暗"效果的来源。

六、给初学者的 3 个动画知识点总结 🎓

  1. 位移动画用百分比:fromYDelta / toYDelta 以控件自身高度为基准,用 -100% 即可实现"从屏幕外滑入",无需计算具体像素,自适应各种屏幕。
  2. 开合动画用镜像参数 + 相反插值器:展开用减速曲线 decelerate_cubic,收起用加速曲线 accelerate_cubic,观感最自然。
  3. 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 项目中快速复刻出同样流畅的下拉菜单动效。

登录后查看全文
DropDownMenu