Skip to content

Expansion panels contain creation flows and allow lightweight editing of an element.

License

Notifications You must be signed in to change notification settings

robertlevonyan/material-expansion-panel

Repository files navigation

Material Expansion Panel

Expansion panels contain creation flows and allow lightweight editing of an element.

Android Arsenal API Maven Central

Setup

Add following line of code to your project level gradle file

  repositories {
    mavenCentral()
  }

Gradle:

Add following line of code to your module(app) level gradle file

    implementation 'com.robertlevonyan.view:MaterialExpansionPanel:<LATEST_VERSION>'

Kotlin:

    implementation("com.robertlevonyan.view:MaterialExpansionPanel:$LATEST_VERSION")

Maven:

<dependency>
  <groupId>com.robertlevonyan.view</groupId>
  <artifactId>MaterialExpansionPanel</artifactId>
  <version>LATEST_VERSION</version>
  <type>pom</type>
</dependency>

Usage

<com.robertlevonyan.views.expandable.Expandable
        android:id="@+id/expandable"
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <include
            android:id="@+id/header"
            layout="@layout/header_view" />

        <include
            android:id="@+id/content"
            layout="@layout/content_view" />
</com.robertlevonyan.views.expandable.Expandable>
alt text alt text

Material Expansion Panel in action

alt text

Attributes

Custom Atributes Description
app:exp_icon Icon for Expandable Header
app:exp_iconStyle Set style for header icon: square, circle or roundedSquare
app:exp_animateExpand Animate expand of layout
app:exp_backgroundColor Set a custom background color for layout
app:exp_expandIndicator Select custom drawable for expand indicator

Setting Listeners

    val expandable = findViewById(R.id.expandable);

Expand/collapse programmatically

Kotlin

    expandable.expand()

Java

    expandable.expand();

Set expand listener

Kotlin

    expandable.doOnExpand {
        //some stuff on expand
    }

    expandable.doOnCollapse {
        //some stuff on collapse
    }

Java

    expandable.setExpandingListener(new ExpandingListener() {
            @Override
            public void onExpanded() {
                //some stuff on expand
            }

            @Override
            public void onCollapsed() {
                //some stuff on collapse
            }
        });

Customizing Expandable from code

    expandable.icon = myIconDrawable // Icon for Expandable Header
    expandable.iconStyle = ExpandableIconStyles.SQUARE // Set style for header icon: square, circle or roundedSquare
    expandable.animateExpand = true // Animate layout expanding
    expandable.backgroundColor = myBackgroundColor // Set a custom background color for layout
    expandable.expandIndicator = myExpandDrawable // Select custom drawable for expand indicator

Versions

2.1.1 - 2.1.3

Update to Java 11 SDK 31 ready Minor updates

2.1.0

Migration to mavenCentral

2.0.1 - 2.0.10

Several bug fixes and small features

2.0.0

New version of the library. Fully rewritten with Kotlin and AndroidX ready 🤩

1.2.0

RecyclerView issue fixed

1.1.0

New version with bug fixes

1.0.0

First version of library

Contact

Licence

    Material Expansion Panel©
    Copyright 2017 Robert Levonyan
    Url: https://github.com/robertlevonyan/materialExpansionPanel

    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.