Need help with ExpandableCardView?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

AleSpero
492 Stars 81 Forks Apache License 2.0 57 Commits 42 Opened issues

Description

Simple expandable CardView for Android.

Services available

!
?

Need anything else?

Contributors list

No Data

ExpandableCardView

Download

Example Gif

An Android library that lets you create in a simple, fast and hassle-free way a CardView in which you can insert your custom layout and just expand and collapse without even writing a single Java/Kotlin line of code.

This component follows the Material Design Guidelines.

Searching for someone who wants to mantain this library! If you're interested, please send me an email.

Important: due to time issues, in the near future there will not be any kind of updates or fixes. PR however will be reviewed and very much appreciated.

Demo

Get it on the Google Play Store.

Setup

First of all, include the dependency in your app build.gradle:

compile 'com.alespero:expandable-cardview:0.8'

Or get the aar in the Releases section.

Declaring the view

After you have the Library correctly setup, just declare the ExpandableCardView in your xml:


The only required attributes are

inner_view
and
title
. The other attributes are optional.

You can specify a custom title and icon on the header on the card by setting the attribute

app:title
and
app:icon
respectively.

After you created the base xml, just create your custom layout and place it inside your

layout
folder.

Now just pass your newly created layout resource to the

app:inner_view
attribute. By setting the attribute
app:expandOnClick="true"
the card will have a default behaviour (expand/collapse on click); By setting the
animationDuration
attribute you can set a custom animation time, and by setting the
startExpanded
attribute the card will be automatically expanded when inflated.

Done! Now your ExpandableCardView is ready to roll.

Usage

If you want some basic Expandable Card without any custom behaviour, setting the view in the XML is enough. Otherwise just declare your ExpandableCardView in your Activity/Fragment and you're ready to use its methods.

Java

ExpandableCardView card = findViewById(R.id.profile);

//Do stuff here

Kotlin

val card : ExpandableCardView = findViewById(R.id.profile)

//Do stuff here

You can use

expand()
and
collapse()
to respectively expand and collapse the card, and use
isExpanded()
to check if the card is expanded or not. You can change the title and icon of the card dynamically by using
setTitle()
and
setIcon()
methods.

You can also set an OnExpandedListener to the card:

Java

card.setOnExpandedListener(new OnExpandedListener() {
    @Override
    public void onExpandChanged(View v, boolean isExpanded) {
        Toast.makeText(applicationContext, isExpanded ? "Expanded!" : "Collapsed!", Toast.LENGTH_SHORT).show();
    }
});

Kotlin

card.setOnExpandedListener { view, isExpanded ->
    Toast.makeText(applicationContext, if(isExpanded) "Expanded!" else "Collapsed!", Toast.LENGTH_SHORT).show()
 }

Contribute

This library is still in its early stages, so feel free to contribute. I will review any Pull Request in 24-48 hours.

License

  Copyright (c) 2018 Alessandro Sperotti

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.

Author

Made By Alessandro Sperotti.

alessandrosperotti at gmail dot com

If you liked this library, why don't you offer me a coffee (or a beer? :D)

ETH: 0x70b6b9eaCDf6f76ECb92bE3fb81d72B3971BA1Bc

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.