DialogX 中 BottomDialog 高度与滚动控制的最佳实践

问题背景

在使用 DialogX 的 BottomDialog 组件时，开发者经常会遇到需要控制对话框高度和内部滚动行为的需求。一个典型场景是：对话框默认显示三分之一屏幕高度，用户可以向上拖动展开至全屏，同时对话框内部可能包含 RecyclerView 等可滚动组件。

核心问题分析

当 BottomDialog 内部使用 wrap_content 高度的 RecyclerView 时，直接调用 setBottomDialogMaxHeight 方法可能会出现对话框无法正常显示的问题（只显示遮罩层而没有内容）。这是因为 DialogX 默认在外层包裹了一个 ScrollView，导致内部滚动布局的高度计算可能出现异常。

解决方案

方案一：使用固定高度

最直接的解决方案是为 RecyclerView 设置固定高度而非 wrap_content。这样可以避免高度计算问题，确保对话框能够正常显示。

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/rvPlayLists"
    android:layout_width="match_parent"
    android:layout_height="300dp"  <!-- 使用固定高度 -->
    android:layout_marginTop="16dp"
    app:layout_constraintTop_toBottomOf="@id/ivAdd"/>

方案二：禁用外层滚动

如果必须使用 wrap_content，可以通过以下方法禁用 DialogX 的外层 ScrollView：

new BottomDialog()
    .setCustomView(yourCustomView)
    .setScrollableWhenContentLargeThanVisibleRange(false)  // 禁用外层滚动
    .show();

这种方法将自定义布局移至 BottomDialog 的滚动布局外部，使 wrap_content 高度能够正常工作。

方案三：实现 ScrollControll 接口

对于需要精细控制滚动行为的场景，可以实现 ScrollControll 接口：

1. 创建自定义 RecyclerView 类：

public class CustomRecyclerView extends RecyclerView implements ScrollControll {
    // 实现必要的方法
    @Override
    public boolean isReadyForPullStart() {
        // 判断是否可以下拉
        return computeVerticalScrollOffset() == 0;
    }

    @Override
    public boolean isReadyForPullEnd() {
        // 判断是否可以上拉
        return !canScrollVertically(1);
    }
}

2. 在布局中使用自定义 RecyclerView：

<com.your.package.CustomRecyclerView
    android:id="@+id/rvPlayLists"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_marginTop="16dp"
    app:layout_constraintTop_toBottomOf="@id/ivAdd"/>

最佳实践建议

1. 简单场景：优先考虑使用固定高度方案，这是最稳定可靠的方式。

2. 动态内容：如果内容高度确实需要动态变化，建议使用方案二（禁用外层滚动）结合适当的布局约束。

3. 复杂交互：当需要实现特殊的滚动交互效果时，才考虑实现 ScrollControll 接口。

4. 性能考虑：对于包含大量数据的列表，固定高度通常能提供更好的性能表现。

注意事项

1. 使用 wrap_content 时，确保父布局也有合理的高度约束，避免无限扩展。

2. 测试不同屏幕尺寸下的显示效果，特别是当设置最大高度时。

3. 考虑添加适当的边距和圆角，确保对话框在不同高度下都能保持良好的视觉效果。

通过合理运用这些技术方案，开发者可以灵活控制 DialogX 中 BottomDialog 的高度和滚动行为，满足各种复杂的UI需求。