https://github.com/Ramotion/cardslider-android

:octocat: 🃏 Cardslider is a material design UI controller that allows you to swipe through cards with pictures and accompanying descriptions.
https://github.com/Ramotion/cardslider-android

android java library

Last synced: 3 months ago
JSON representation

:octocat: 🃏 Cardslider is a material design UI controller that allows you to swipe through cards with pictures and accompanying descriptions.

• Host: GitHub
• URL: https://github.com/Ramotion/cardslider-android
• Owner: Ramotion
• License: mit
• Created: 2017-05-04T07:35:28.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2020-12-27T15:29:05.000Z (almost 4 years ago)
• Last Synced: 2024-07-05T14:52:41.011Z (4 months ago)
• Topics: android, java, library
• Language: Java
• Homepage: https://www.ramotion.com/cardslider-android-ui-app-development-library-to-interact-with-cards/
• Size: 12 MB
• Stars: 2,345
• Watchers: 77
• Forks: 359
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• Android-Awesome-Resources - Cardslider-android

README

        






CARDSLIDER [JAVA]


Material design UI controller that allows to swipe through cards with pictures and descriptions


___

We specialize in the designing and coding of custom UI for Mobile Apps and Websites.





Stay tuned for the latest updates:





[![Twitter](https://img.shields.io/badge/[email protected]?style=flat)](http://twitter.com/Ramotion)

[![Codacy Badge](https://api.codacy.com/project/badge/Grade/42eb7b00b93645c0812c045ab26cb3b7)](https://www.codacy.com/app/andreylos/cardslider-android?utm_source=github.com&utm_medium=referral&utm_content=Ramotion/cardslider-android&utm_campaign=Badge_Grade)

[![CircleCI](https://circleci.com/gh/Ramotion/cardslider-android/tree/master.svg?style=svg)](https://circleci.com/gh/Ramotion/cardslider-android/tree/master)

[![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg)](https://paypal.me/Ramotion)

## Requirements

​

- Android 4.4 KitKat (API lvl 19) or greater

- Your favorite IDE

## Installation

​

Just download the package from [here](http://central.maven.org/maven2/com/ramotion/cardslider/card-slider/0.3.1/card-slider-0.3.1.aar) and add it to your project classpath, or just use the maven repo:

Gradle:

```groovy

'com.ramotion.cardslider:card-slider:0.3.1'

```

SBT:

```scala

libraryDependencies += "com.ramotion.cardslider" % "card-slider" % "0.3.1"

```

Maven:

```xml

	com.ramotion.cardslider

	card-slider

	0.3.1

```

​

## Basic usage

`CardSlider` is a custom `LayoutManager` for `RecyclerView`.

You can attach it to RecyclerView from code or XML layout.

Here are the attributes you can specify in the constructor or XML layout:

* `activeCardLeft` - Active card offset from start of RecyclerView. Default value is 50dp.

* `cardWidth` - Card width. Default value is 148dp.

* `cardsGap` - Distance between cards. Default value is 12dp.

For card snapping, there is `CardSnapHelper` class.'

```

...

@Override

protected void onCreate(Bundle savedInstanceState) {

    ...

    recyclerView = (RecyclerView) findViewById(R.id.recycler_view);

    recyclerView.setLayoutManager(new CardSliderLayoutManager(this););

    new CardSnapHelper().attachToRecyclerView(recyclerView);

    ...

}

```

## 📄 License

Cardslider Android is released under the MIT license.

See [LICENSE](./LICENSE) for details.

This library is a part of a selection of our best UI open-source projects

If you use the open-source library in your project, please make sure to credit and backlink to www.ramotion.com

## 📱 Get the Showroom App for Android to give it a try

Try this UI component and more like this in our Android app. Contact us if interested.