JarCasting
JarCasting JarCasting

ScrollingBackgroundView

Scrolling background view for Android

License

License
GroupId

GroupId

ru.noties
ArtifactId

ArtifactId

sbv
Last Version

Last Version

1.0.0
Release Date

Release Date
Type

Type

aar
Description

Description

ScrollingBackgroundView
Scrolling background view for Android
Project URL

Project URL

https://github.com/noties/ScrollingBackgroundView
Source Code Management

Source Code Management

https://github.com/noties/ScrollingBackgroundView

Download sbv

Filename Size
sbv-1.0.0.pom
sbv-1.0.0.aar 5 KB
sbv-1.0.0-sources.jar 2 KB
sbv-1.0.0-javadoc.jar 27 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/ru.noties/sbv/ -->
<dependency>
    <groupId>ru.noties</groupId>
    <artifactId>sbv</artifactId>
    <version>1.0.0</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/ru.noties/sbv/
implementation 'ru.noties:sbv:1.0.0'
// https://jarcasting.com/artifacts/ru.noties/sbv/
implementation ("ru.noties:sbv:1.0.0")
'ru.noties:sbv:aar:1.0.0'
<dependency org="ru.noties" name="sbv" rev="1.0.0">
  <artifact name="sbv" type="aar" />
</dependency>
@Grapes(
@Grab(group='ru.noties', module='sbv', version='1.0.0')
)
libraryDependencies += "ru.noties" % "sbv" % "1.0.0"
[ru.noties/sbv "1.0.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

Scrolling Background View

Endless background scrolling for Android

Please note, that first GIF uses library: CCF to achive color-cross-fade effect, please refer to the sample project for more info.

Version Gradle
Maven Central compile 'ru.noties:sbv:x.x.x'

A simple Android View that can help to achive endless scrolling background effect. It takes one drawable and tiles it to fill to the width & height of the view.

<ru.noties.sbv.ScrollingBackgroundView
    android:id="@+id/scrolling_background_view"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:sbv_drawable="@drawable/tile_pager"
    app:sbv_scrollX="0dip"
    app:sbv_scrollY="0dip"/>

Custom attributes:

  • sbv_drawable - the drawable object to be used
  • sbv_scrollX - start scroll x value
  • sbv_scrollY - start scroll y value

This view works with preview layout tools in Android Studio.

Next we need to redirect scroll events from our scrolling View to the ScrollingBackgroundView. The sample project contains some basic cases like RecyclerView & ViewPager.

final ScrollingBackgroundView scrollingBackgroundView = findView(view, R.id.scrolling_background_view);

scrollingBackgroundView.setDrawable(/* drawable reference */);

scrollingBackgroundView.setOnSizeChangedListener(/* a listener to be notified about size changes of this view */);

// actual scrolling methods
scrollingBackgroundView.scrollBy(/* x & y values */);
scrollingBackgroundView.scrollTo(/* x & y values */);

scrollingBackgroundView.scrollX(); // use this method to retrieve current scroll x value
scrollingBackgroundView.scrollY(); // use this method to retrieve current scroll y value
final RecyclerView recyclerView = findView(view, R.id.recycler_view);
recyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
    @Override
    public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
        scrollingBackgroundView.scrollBy(dx, dy);
    }
});

License

  Copyright 2016 Dimitry Ivanov ([email protected])

  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.

Versions

Version
1.0.0