NestedTouchScrollingLayout 使用教程

NestedTouchScrollingLayout 使用教程

NestedTouchScrollingLayout :8ball: 处理子 View，父 View 嵌套滚动，成本比 support v4 NestedScrolling 低，放心食用～ 项目地址: https://gitcode.com/gh_mirrors/ne/NestedTouchScrollingLayout

1. 项目介绍

NestedTouchScrollingLayout 是一个用于处理 Android 中 View 和 ViewGroup 嵌套滚动的开源库。与传统的 NestedScrolling 机制相比，它提供了更低的滚动成本和更灵活的触摸事件处理。这个库可以有效地解决复杂布局中的嵌套滚动问题，使得开发者能够轻松实现自定义的滚动效果。

2. 项目快速启动

在您的 build.gradle 文件中添加以下依赖项：

方式 1: 使用 Jitpack

repositories {
    // ...
    maven { url 'https://jitpack.io' }
}

dependencies {
    implementation 'com.github.JarvisGG:NestedTouchScrollingLayout:1.2.4'
}

方式 2: 使用 JCenter

repositories {
    // ...
    jcenter()
}

dependencies {
    implementation 'com.jarvis.library.NestedTouchScrollingLayout:library:1.2.4'
}

在布局文件中，使用 NestedTouchScrollingLayout 包裹你的滚动视图：

<com.jarvis.library.NestedTouchScrollingLayout
    android:id="@+id/wrapper"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <android.support.v7.widget.RecyclerView
        android:id="@+id/container_rv"
        android:layout_width="match_parent"
        android:layout_height="400dp"
        android:background="#fff"
        android:overScrollMode="always" />

</com.jarvis.library.NestedTouchScrollingLayout>

在 Java/Kotlin 代码中，设置阻尼和注册回调：

mNestedTouchScrollingLayout.setDampingDown(2.0f / 5);
mNestedTouchScrollingLayout.setDampingUp(3.0f / 5);

mNestedTouchScrollingLayout.registerNestScrollChildCallback(new NestedTouchScrollingLayout.INestChildScrollChange() {
    @Override
    public void onNestChildScrollChange(float deltaY, float velocityY) {
        // 处理滚动中的逻辑
    }

    @Override
    public void onNestChildScrollRelease(float deltaY, int velocityY) {
        // 处理手指离开屏幕时的逻辑
    }

    // 其他回调方法...
});

3. 应用案例和最佳实践

案例一：普通使用

适用于一般的嵌套滚动场景，可以自定义阻尼效果。

<com.jarvis.library.NestedTouchScrollingLayout
    android:id="@+id/wrapper"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">
    <!-- 子视图 -->
</com.jarvis.library.NestedTouchScrollingLayout>

案例二：底部工作台（Bottom Sheet）

适用于底部抽屉式菜单，可以设置弹起方向和临界速度。

<com.jarvis.library.NestedTouchScrollingLayout
    android:id="@+id/wrapper"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <!-- 子视图 -->
</com.jarvis.library.NestedTouchScrollingLayout>

mNestedTouchScrollingLayout.setSheetDirection(NestedTouchScrollingLayout.SheetDirection.BOTTOM);
// 注册回调并处理逻辑...

4. 典型生态项目

目前没有明确的典型生态项目，但开发者可以基于 NestedTouchScrollingLayout 实现多种复杂的嵌套滚动效果，如日历组件、复杂列表等。

以上就是 NestedTouchScrollingLayout 的使用教程，希望对您有所帮助。

NestedTouchScrollingLayout :8ball: 处理子 View，父 View 嵌套滚动，成本比 support v4 NestedScrolling 低，放心食用～ 项目地址: https://gitcode.com/gh_mirrors/ne/NestedTouchScrollingLayout