Skip to content

AndroidSliderViewsLibrary is an Android SDK library supports vertical & horizontal carousel and slideshow Views which developers simply integrate on Android project. - by @sung2063

License

Notifications You must be signed in to change notification settings

sung2063/AndroidSliderViewsLibrary

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

60 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Android Slider Views Library


Generic badge Generic badge Generic badge

Android Slider Views library supports Carousels and Slideshow Views which developers simply creating a dynamic gallery on the Android application.

πŸ’– Sponsor

Android Slider Views library updates regularly. Your valuable sponsorship helps me contributing more features and maintaining the library. Support me for building more interesting projects! πŸ’œ

🎬 Sample GIF Images

Horizontal Carousel Carousel w/ Custom Indicator Vertical Carousel

πŸ“‹ Table of Contents

  1. Latest Update
  2. Usage Instruction
    1. Setup Project
    2. CarouselView
    3. SlideshowView
  3. Callback Events
  4. Attributions
    1. CarouselView
    2. SlideshowView
  5. Contributor
  6. License

πŸ†• Latest Update

Updated on May 31st 2021

  • NEW: Implemented slide buttons. ✨

πŸ“– How To Use Slider Views

1. Setup your Android project setting

Minimum SDK Version: 21 or greater (Update in your app level build.gradle)
Supported Programming Language: Java

Add following snippet code in your project level build.gradle.

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

2. Add required library

First, include following jitpack url inside maven block in your project level build.gradle.

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

Next, add the SliderViews and required libraries in app level build.gradle and sync the gradle file.

implementation 'com.github.sung2063:AndroidSliderViewsLibrary:1.8'
implementation 'com.google.android.material:material:1.1.0'

Now you are ready to use SliderView Library. You can start creating CarouselView and SlideshowView.


CarouselView

CarouselView can be used for your application intro and show multiple images or videos in one layout with scrolling. CarouselView by Sliders library supports both horizontal and vertical scrolls.

First, create a CarouselView in your xml file.

<com.sung2063.sliders.carousel.CarouselView
        android:id="@+id/carousel_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:showIndicator="true"
        app:scrollDirection="horizontal"
        app:showSlideNumber="true" />

Set scrollDirection attribution to horizontal for creating horizontal carousel and vertical for vertical carousel.

In your onCreate() method in Activity, create your own custom layouts, add layouts to List, and start the carousel. You can add up to 10 layouts in the CarouselView.

From version 1.6, you can also include sub-title of each slides. In that case, you need to make DescriptiveSlideModel objects that holds slide layout and sub-title and add to List<DescriptiveSlideModel>. Also, do not forget to add app:showSubTitle="true" into your CarouselView in xml. The default is false.

CarouselView carouselView = findViewById(R.id.carousel_view);

// Create your own layouts...
// Create List<ViewGroup> object or List<DescriptiveSlideModel>...
// Add your layouts to list object...

carouselView.setSlideList(layoutList);
carouselView.launch();

Your CarouselView is now displayed on your app! πŸ‘


SlideshowView

SlideshowView can be used to show the multiple layouts by certain period of time. You can set how much time you want to show each layout to the user.

First, create a SlideshowView in your xml file.

<com.sung2063.sliders.slideshow.SlideshowView
        android:id="@+id/slideshow_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:showIndicator="true"
        app:delayTimePeriod="5"
        app:showSlideNumber="true" />

In your onCreate() method in Activity, create your own custom layouts, add layouts to List<ViewGroup>, and start the slideshow. You can add up to 10 layouts in the SlideshowView.

From version 1.6, you can also include sub-title of each slides. In that case, you need to make DescriptiveSlideModel objects that holds slide layout and sub-title and add to List<DescriptiveSlideModel>. Also, do not forget to add app:showSubTitle="true" into your SlideshowView in xml. The default is false.

SlideshowView slideshowView = findViewById(R.id.slideshow_view);

// Create your own layouts...
// Create List<ViewGroup> object or List<DescriptiveSlideModel>...
// Add your layouts to list object...

slideshowView.setSlideList(layoutList);
slideshowView.launch();

Your SlideshowView is now displayed on your app! πŸ‘


Callback Events

You can also get callback events from slider. On your Activity, create a SliderListener object with implementing own action and pass this object to the view by calling setSliderListener. Here is the snippet code how to implement the callback:

// Create a callback interface
SliderListener sliderListener = position -> {
     // TODO: Do something when slide is clicked
};

// Set callback object to the View
carouselView.setSliderListener(sliderListener)    // If you are using Carousel
slideshowView.setSliderListener(sliderListener)   // If you are using Slideshow

Check out my Android Slide Sample App project for more example on using SliderView library.

🎨 Attributions

Here are available attributions you can use to modify your slider views.

CarouselView

Attribution Value Description
scrollDirection horizontal Display the carousel horizontally. Field value is 0.
vertical Display the carousel vertically. Field value is 1.
showIndicator boolean Show the dot indicator on the slide if the value true, otherwise do not show.
indicatorScale float Used for resize the indicator scale from 0.5 - 1.5.
indicatorSelectedIcon integer Selected indicator icon drawable id.
indicatorUnselectedIcon integer Unselected indicator icon drawable id.
showSlideNumber boolean Show the slide number text if the value is true, otherwise do not show.
slideNumberTextSize int Set the slide number text size in px.
showSubTitle boolean Show the sub-title if the value is true, otherwise do not show.
showSlideButtons boolean Show the slide buttons if the value is true, otherwise do not show. Default is true.

SlideshowView

Attribution Value Description
showIndicator boolean Show the dot indicator on the slide if the value true, otherwise do not show.
indicatorScale float Used for resize the indicator scale from 0.5 - 1.5.
indicatorSelectedIcon integer Selected indicator icon drawable id.
indicatorUnselectedIcon integer Unselected indicator icon drawable id.
showSlideNumber boolean Show the slide number text if the value is true, otherwise do not show.
slideNumberTextSize int Set the slide number text size in px.
delayTimePeriod int The slide delay time in second. Default is 5 seconds.
showSubTitle boolean Show the sub-title if the value is true, otherwise do not show.
showSlideButtons boolean Show the slide buttons if the value is true, otherwise do not show. Default is true.

🌟 Contributor

Sung Hyun Back (@sung2063)

πŸ“ License

The code is licensed under the GNU General Public License.

About

AndroidSliderViewsLibrary is an Android SDK library supports vertical & horizontal carousel and slideshow Views which developers simply integrate on Android project. - by @sung2063

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published

Languages