Skip to content

🔥🔥 An Android costomized ScrollView which likes UIScrollView over-scrolling effect in iOS.

License

Notifications You must be signed in to change notification settings

woxingxiao/BounceScrollView

Repository files navigation

BounceScrollView

API License

logo

🎨An Android warpped ScrollView, which works just like the UIScrollView in iOS when the user tries to scroll it beyond its content.🎨


Features

  • ♠️Maximum adaptability. It supports the horizontal and the vertical direction, and extends the NestScrollView. So it not only can work just like the ScrollView and the HorizontalScrollView, but also can work properly with Nest Scrolling.
  • ♥️Customizable damping coefficient (easier or harder to over scroll). The incremental damping or constant damping can be chose during the over-scrolling.
  • ♣️Customizable bounce delay, the duration of the restoring animation.
  • ♦️Customizable interpolator, the rate of change of the restoring animation.

Download

root project:build.gradle

  allprojects {
      repositories {
          ...
          maven { url "https://jitpack.io" }
      }
  }

app:build.gradle

Support:

  dependencies {
     implementation 'com.github.woxingxiao:BounceScrollView:LATEST_VERSION'
  }

AndroidX:

  dependencies {
     implementation 'com.github.woxingxiao:BounceScrollView:LATEST_VERSION-androidx'
  }

Usage

<?xml version="1.0" encoding="utf-8"?>
<com.xw.repo.widget.BounceScrollView
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <android.support.constraint.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

          <!-- The ConstraintLayout can be replaced by FrameLayout, LinearLayout, etc. -->
          <!-- Your content view goes here. -->

     </android.support.constraint.ConstraintLayout>
</com.xw.repo.widget.BounceScrollView>

Listener to the scrolling event of content of the BounceScrollView:

mBounceScrollView.setOnScrollListener(new OnScrollListener() {
    @Override
    public void onScrolling(int scrollX, int scrollY) {

    }
});

Listener to the over-scrolling event of the BounceScrollView:

mBounceScrollView.setOnOverScrollListener(new OnOverScrollListener() {
    @Override
    public void onOverScrolling(boolean fromStart, int overScrolledDistance) {

    }
});

Attributes

Attr Format Descrption
damping float The damping coefficient. The greater the value, the hard it is to over scroll. Defalut: 2.0
scrollOrientation enum The children layout direction. Default: vertical
incrementalDamping boolean Whether the damping coefficient growing with the distance or not. Default: true
bounceDelay long The duration of restoring animation. Default: 400(ms)
triggerOverScrollThreshold int The length in pixel to trigger over-scrolling. Default: 20(px)
disableBounce boolean Disable the bounce effect. Default: false
nestedScrollingEnabled boolean Whether nested scrolling is enabled. Default: true

It took me tons of time to adjust the parameters pixel by pixel, in order to achieve the best experience I think.:beers:


🍰If the attr damping is set to 2.0, the over-scrolling effort is almost the same as UIScrollView in iOS.
🍰The interpolator of the restoring animation is customizable. You can do it by:

mBounceScrollView.setBounceInterpolator(new YourCustomizedInterpolator());

Thanks to the repo EasingInterpolator, there are multiple choices to make.


Most of the resources in the sample come from gameofthrones.com.

License

   Copyright 2018 woxingxiao

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

About

🔥🔥 An Android costomized ScrollView which likes UIScrollView over-scrolling effect in iOS.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published