sliding-panel

A ViewGroup that implements a sliding panel that is part of the view hierarchy, not above it.

Difference from other libraries

All other implementations of the bottom sheet pattern and sliding panel pattern implement a panel that sits above all the other Views of the app. When the panel is collapsed (but visible) the only way to set its position is by using a peek factor (its distance from the bottom of the screen).

With this library the sliding panel is placed exactly where it is supposed to be in the view hierarchy, just like it would be in a vertical (or horizontal) LinearLayout. It doesn't sit above other Views.

Overview

SlidingPanelLayout is a ViewGroup exending FrameLayout.

It has exacly two children: a non sliding view and a sliding view.

• The non sliding view is just a view that doesn't move, positioned as if SlidingPanelLayout was a LinearLayout.
• The sliding view is a View that can be dragged by the user. It slides over the non sliding view, both vertically and horizontally.

The sliding view can be collapsed or expanded.

• When expanded, the sliding view is exactly where it would be if SlidingPanelLayout was a LinearLayout.
• When collapsed, the sliding view is positioned to exactly cover the non sliding view. (Therefore the maximum amount of movement allowed to the sliding view is equal to the height (or width) of the non sliding view)

Sample app

You can download the apk of the sample app at this link. The code of the sample app is available at this link.

Download

The Gradle dependency is available via jCenter. jCenter is the default Maven repository used by Android Studio.

jCenter is gone, now it is available at jitpack.io

The minimum API level supported by this library is API 15.

dependencies {
 implementation 'com.github.iRYO400:sliding-panel:$latestVersion'
}

Quick start

In order to start using the library you need to add a SlidingPanelLayout to your layout.

<com.akbolatss.workshop.slidingpanel.SlidingPanelLayout
  xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto"
  android:id="@+id/sliding_panel"
  android:layout_width="match_parent"
  android:layout_height="match_parent"

  app:orientation="vertical"
  app:nonSlidingView="@id/non_sliding_view"
  app:slidingView="@id/sliding_view"
  app:slidingState="expanded"
  app:elevation="4dp" >

  <TextView
    android:id="@+id/non_sliding_view"
    android:layout_width="match_parent"
    android:layout_height="150dp"
    android:gravity="center"
    android:text="non sliding view"
    android:background="#af4448" />

  <TextView
    android:id="@+id/sliding_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:text="sliding view"
    android:background="#e57373" />

</com.akbolatss.workshop.slidingpanel.SlidingPanelLayout>

non_sliding_view and sliding_view can be whatever View or ViewGroup you need.

If you want to listen to slide events, you can add a OnSlideListener to the SlidingPanelLayout.

sliding_panel.addSlideListener { slidingPanel, state, currentSlide ->
  when(state) {
    PanelState.COLLAPSED -> { }
    PanelState.EXPANDED -> { }
    PanelState.SLIDING -> { }
  }
}

API documentation

Table of contents

1. SlidingPanelLayout attributes
   1. slidingView
   2. nonSlidingView
   3. dragView
   4. fitToScreenView
   5. orientation
   6. slidingState
   7. elevation
2. API
   1. Panel state
   2. slideTo
   3. slideDuration
   4. Programmatically set drag view
   5. Listen to events

SlidingPanelLayout attributes

SlidingPanelLayout has a set of attributes that you can set to customize its behviour. Some of this attributes are mandatory.

slidingView

Mandatory: yes -- Value: view reference -- Default: null

This mandatory attribute is used to tell SlidingPanelLayout which of its two children is the sliding view. If this attribute is not set SlidingPanelLayout will throw an Excpetion.

<com.akbolatss.workshop.slidingpanel.SlidingPanelLayout
  ...
  app:slidingView="@id/sliding_view" >

  ...
</com.akbolatss.workshop.slidingpanel.SlidingPanelLayout>

nonSlidingView

Mandatory: yes -- Value: view reference -- Default: null

This mandatory attribute is used to tell SlidingPanelLayout which of its two children is the non sliding view. If this attribute is not set SlidingPanelLayout will throw an Excpetion.

<com.akbolatss.workshop.slidingpanel.SlidingPanelLayout
  ...
  app:nonSlidingView="@id/non_sliding_view" >

  ...
</com.akbolatss.workshop.slidingpanel.SlidingPanelLayout>

dragView

Mandatory: no -- Value: view reference -- Default: slidingView

This attribute is used to tell SlidingPanelLayout which View should be used to drag the sliding view. If not set this value defaults to the sliding view. Therefore the whole panel will be sensible to dragging.

Note that if the whole panel is draggable it won't be possible to use scrollable views inside the sliding view.

<com.akbolatss.workshop.slidingpanel.SlidingPanelLayout
  ...
  app:dragView="@id/drag_view" >

  ...
</com.akbolatss.workshop.slidingpanel.SlidingPanelLayout>

fitToScreenView

Mandatory: no -- Value: view reference -- Default: null

When collapsed, the sliding view is shifted down (or right) by an amount equal to the height (or width) of the non sliding view. Therefore, when collapsed, the bottom (or right) part of the sliding view will be out of the screen.

This attribute is used to tell SlidingPanelLayout that we want a view to be shifted up (or left) so that it is always visible.

See the screenshots below to better understand. In the first one fitToScreenView is set, in the second one it isn't.

Notice the white text at the bottom of the screen. It is not visible in the second screen, it is visible only when the panel is expanded.

The sample app has an example specific for this attribute.

<com.akbolatss.workshop.slidingpanel.SlidingPanelLayout
  ...
  app:fitToScreenView="@id/fit_to_screen_view" >

  ...
</com.akbolatss.workshop.slidingpanel.SlidingPanelLayout>

slidingState

Mandatory: no -- Value: expanded | collapsed -- Default: collapsed

This attribute is used to set initial state of SlidingPanelLayout. By default it is set to expanded.

<com.akbolatss.workshop.slidingpanel.SlidingPanelLayout
  ...
  slidingState="expanded" >

  ...
</com.akbolatss.workshop.slidingpanel.SlidingPanelLayout>

orientation

Mandatory: no -- Value: vertical | horizontal -- Default: vertical

This attribute is used to set the orientation of SlidingPanelLayout in the same way that it is used for a LinearLayout. By default it is set to vertical.

<com.akbolatss.workshop.slidingpanel.SlidingPanelLayout
  ...
  app:orientation="horizontal" >

  ...
</com.akbolatss.workshop.slidingpanel.SlidingPanelLayout>

elevation

Mandatory: no -- Value: dimension -- Default: 4dp

This attribute is used to set the length of the shadow drawn to the top (or left) side of the sliding view.

<com.akbolatss.workshop.slidingpanel.SlidingPanelLayout
  ...
  app:elevation="10dp" >

  ...
</com.akbolatss.workshop.slidingpanel.SlidingPanelLayout>

API

You can interact with SlidingPanelLayout programmatically through its API.

Panel state

SlidingPanelLayout has a state that can be one of: EXPANDED, COLLAPSED and SLIDING.

You can get the state but are not allowed to set it directly.

To programmatically change the state of the panel you should use the slideTo method.

slideTo

This method takes as argument one of the possible states of the panel: EXPANDED, COLLAPSED. If you try to pass SLIDING the panel will throw an IllegalArgumentException.

When this method is called the panel will automatically animate to to match the state passed as argument.

slideDuration

You can set the duration of the slide animation using the slideDuration property.

This property affects:

• the duration of the slide triggered by slideTo.
• the speed at which the panel autocompletes the slides when the user stops dragging it before reaching the EXPANDED or COLLAPSED state.

You can use the constants defined in SlidingPanelLayout (SlidingPanelLayout.SLIDE_DURATION_SHORT, SlidingPanelLayout.SLIDE_DURATION_LONG) or set it to an arbitrary duration in millisecond.

sliding_panel.slideDuration = SlidingPanelLayout.SLIDE_DURATION_SHORT
sliding_panel.slideDuration = SlidingPanelLayout.SLIDE_DURATION_LONG

Programmatically set drag view

Sometimes it is usefull to change the dragView at runtime.

An example is give in the sample app, in the "advanced example". In this case a list is shown when the panel is expanded, therefore the drag view has to be changed. Otherwise the list wouldn't be scrollable.

Use the setDragView(view: View) method to programmatically set the drag view.

Listen to events

You can listen to slide events, by adding an OnSlideListener to the SlidingPanelLayout.

sliding_panel.addSlideListener { slidingPanelLayout, state, currentSlide ->
  when(state) {
    PanelState.COLLAPSED -> { }
    PanelState.EXPANDED -> { }
    PanelState.SLIDING -> { }
  }
}

or

sliding_panel.addSlideListener(object : SlidingPanelLayout.OnSlideListener {
  override fun onSlide(slidingPanel: SlidingPanelLayout, state: PanelState, currentSlide: Float) { }
})

• The first argument is a reference to the SlidingPanelLayout emitting the event.
• The second argument is the current state of the panel.
• The third argument is a value between 0 and 1. The value is 0 when the state is COLLAPSED and 1 when EXPANDED.

About the Fork

This is a fork of the original sliding-panel of Pierfrancesco Soffritti. The original has well documented and written code, so you can use it in production(400+ stars). But in my case, it covers about 80% of my needs. So I started to make PRs, here is the first one. As you see, the maintainer doesn't have time for this library. Then, this fork was born with all my PRs included and some other features as well.

License

As the original repo, this is under the Apache-2.0 too. I started to contribute at the commit 9117a51. Feel free to compare the latest version with the commit to see a diff about "what is new and what is original".