CarouselView

A simple yet flexible library to add carousel view in your android application.

Download

####Gradle:

compile 'com.synnapps:carouselview:0.0.9'

####Maven:

<dependency>
  <groupId>com.synnapps</groupId>
  <artifactId>carouselview</artifactId>
  <version>0.0.9</version>
  <type>pom</type>
</dependency>

Usage

####Include following code in your layout:

    <com.synnapps.carouselview.CarouselView
        android:id="@+id/carouselView"
        android:layout_width="match_parent"
        android:layout_height="200dp"
        app:fillColor="#FFFFFFFF"
        app:pageColor="#00000000"
        app:radius="6dp"
        app:slideInterval="3000"
        app:strokeColor="#FF777777"
        app:strokeWidth="1dp"/>

####Include following code in your activity:

public class SampleCarouselViewActivity extends AppCompatActivity {

    CarouselView carouselView;

    int[] sampleImages = {R.drawable.image_1, R.drawable.image_2, R.drawable.image_3, R.drawable.image_4, R.drawable.image_5};

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_sample_carousel_view);

        carouselView = (CarouselView) findViewById(R.id.carouselView);
        carouselView.setPageCount(sampleImages.length);

        carouselView.setImageListener(imageListener);
    }

    ImageListener imageListener = new ImageListener() {
        @Override
        public void setImageForPosition(int position, ImageView imageView) {
            imageView.setImageResource(sampleImages[position]);
        }
    };

}

####If you want to add custom view, implement ViewListener.

public class SampleCarouselViewActivity extends AppCompatActivity {

    CarouselView customCarouselView;
    int NUMBER_OF_PAGES = 5;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_sample_carousel_view);

        customCarouselView = (CarouselView) findViewById(R.id.customCarouselView);
        customCarouselView.setPageCount(NUMBER_OF_PAGES);
        // set ViewListener for custom view 
        customCarouselView.setViewListener(viewListener);
    }

    ViewListener viewListener = new ViewListener() {
    
        @Override
        public View setViewForPosition(int position) {
            View customView = getLayoutInflater().inflate(R.layout.view_custom, null);
            //set view attributes here
            
            return customView;
        }
    };

####Supported xml Attributes

Attribute	Description	Values
app:slideInterval	Interval per page in ms.	integer
app:indicatorGravity	Gravity of the indicator. (Just like layout_gravity)	gravity
app:indicatorOrientation	Orientation of the indicator.	[horizontal, vertical]
app:fillColor	Color of the filled circle that represents the current page.	color
app:pageColor	Color of the filled circles that represents pages.	color
app:radius	Radius of the circles. This is also the spacing between circles.	dimension
app:snap	Whether or not the selected indicator snaps to the circles.	boolean
app:strokeColor	Width of the stroke used to draw the circles.	color
app:autoPlay	Whether or not to auto play. Default: true	boolean
app:disableAutoPlayOnUserInteraction	Disables autoPlay when user interacts. Default: false	boolean
app:indicatorMarginHorizontal	Sets horizontal margin for Indicator in Carousel View	dimension
app:indicatorMarginVertical	Sets vertical margin for Indicator in Carousel View	dimension
app:pageTransformInterval	Sets speed at which page will slide from one to another in ms.	integer
app:pageTransformer	Sets page transition animation.	[zoom,flow,depth,slide_over]
app:animateOnBoundary	Sets whether to animate from last page. Default: true	boolean

Note: Add xmlns:app="http://schemas.android.com/apk/res-auto" in your layout's root view.

Developed By

Sayyam Mehmood
Muhammad Rehan

Special Thanks

This library uses code snippet from Jake Wharton's ViewPagerIndicator to display page indicator.

License