如何通过编程折叠或展开 Android 的 CollapsingToolbarLayout？

2024-03-03 02:30:10

在 Android 开发中，CollapsingToolbarLayout 凭借其灵活的折叠和展开效果，为应用界面增添了不少活力。但有时，我们希望能够通过代码控制 CollapsingToolbarLayout 的状态，而不是仅仅依赖于用户的滚动操作。这篇文章就来探讨如何以编程方式实现 CollapsingToolbarLayout 的折叠和展开。

我们先来简单回顾一下 CollapsingToolbarLayout 的工作原理。它通常与 AppBarLayout 和 NestedScrollView 配合使用，通过监听 NestedScrollView 的滚动事件来改变自身的状态。当内容向上滚动时，CollapsingToolbarLayout 会逐渐折叠，最终只显示 Toolbar；反之，当内容向下滚动时，它又会逐渐展开，显示完整的标题和背景图片。

那么，如何用代码来控制这个折叠和展开的过程呢？其实，Android 系统并没有提供一个直接的方法，例如 collapsingToolbarLayout.expand() 或 collapsingToolbarLayout.collapse()。我们需要借助一些间接的方式来实现。

一种常见的方法是利用 AppBarLayout.LayoutParams 的 setScrollFlags() 方法。我们可以通过修改 CollapsingToolbarLayout 在 AppBarLayout 中的滚动标志来控制它的行为。例如，如果我们将 scrollFlags 设置为 SCROLL_FLAG_SNAP，那么 CollapsingToolbarLayout 在滚动结束后会自动吸附到折叠或展开状态。

AppBarLayout.LayoutParams params = (AppBarLayout.LayoutParams) collapsingToolbarLayout.getLayoutParams();
params.setScrollFlags(AppBarLayout.LayoutParams.SCROLL_FLAG_SCROLL | AppBarLayout.LayoutParams.SCROLL_FLAG_EXIT_UNTIL_COLLAPSED | AppBarLayout.LayoutParams.SCROLL_FLAG_SNAP);
collapsingToolbarLayout.setLayoutParams(params);

接着，我们可以通过 AppBarLayout.setExpanded() 方法来控制 AppBarLayout 的展开状态，从而间接地控制 CollapsingToolbarLayout 的状态。

appBarLayout.setExpanded(true); // 展开 CollapsingToolbarLayout
appBarLayout.setExpanded(false); // 折叠 CollapsingToolbarLayout

需要注意的是，setExpanded() 方法可以接受一个布尔值参数，表示是否立即展开或折叠，还可以接受一个动画参数，实现平滑的过渡效果。

除了 setExpanded() 方法外，我们还可以使用 AppBarLayout.setLifted() 方法来控制 AppBarLayout 的提升状态，间接影响 CollapsingToolbarLayout。当 AppBarLayout 处于提升状态时，CollapsingToolbarLayout 会被折叠。

appBarLayout.setLifted(true); // 折叠 CollapsingToolbarLayout
appBarLayout.setLifted(false); // 展开 CollapsingToolbarLayout

这种方法的优点是更加直接，不需要设置滚动标志。但需要注意的是，setLifted() 方法只在 API 23 及以上版本可用。

在实际应用中，我们可能会遇到一些特殊情况，例如需要在 CollapsingToolbarLayout 完全折叠后执行一些操作。这时，我们可以监听 AppBarLayout 的偏移量变化，并在偏移量达到一定值时触发相应的操作。

appBarLayout.addOnOffsetChangedListener(new AppBarLayout.OnOffsetChangedListener() {
    @Override
    public void onOffsetChanged(AppBarLayout appBarLayout, int verticalOffset) {
        if (Math.abs(verticalOffset) >= appBarLayout.getTotalScrollRange()) {
            // CollapsingToolbarLayout 完全折叠
        } else {
            // CollapsingToolbarLayout 未完全折叠
        }
    }
});

通过以上几种方法，我们可以灵活地控制 CollapsingToolbarLayout 的折叠和展开状态，满足各种不同的需求。

常见问题解答

1. 为什么使用 setExpanded() 方法无法控制 CollapsingToolbarLayout 的状态？

请检查 CollapsingToolbarLayout 的 layout_scrollFlags 属性是否设置正确。它至少需要包含 SCROLL_FLAG_SCROLL 和 SCROLL_FLAG_EXIT_UNTIL_COLLAPSED 两个标志。

2. 如何实现 CollapsingToolbarLayout 的平滑折叠和展开动画？

可以在调用 setExpanded() 方法时传入一个动画参数，例如 ValueAnimator 或 ObjectAnimator。

3. 如何在 CollapsingToolbarLayout 折叠时隐藏 Toolbar 上的某些控件？

可以监听 AppBarLayout 的偏移量变化，并在偏移量达到一定值时隐藏或显示相应的控件。

4. 如何在 CollapsingToolbarLayout 展开时显示一个自定义的 View？

可以将自定义的 View 放在 CollapsingToolbarLayout 内部，并设置其 layout_collapseMode 属性为 parallax 或 pin。

5. 如何解决 CollapsingToolbarLayout 与其他控件的冲突问题？

可以尝试调整 CollapsingToolbarLayout 和其他控件的 layout_behavior 属性，或者使用 CoordinatorLayout 来协调它们之间的关系。