Expandable Panel Android Library
Check ExpandablePanel Demo application on GooglePlay:
Details
This Android library implements the expand by sliding logic for a top or a bottom view in a two children view composition. That's the default behaviour, but it allows you to set a different View as the expandable one, making this component support multiple views inside it. It supports Android SDK 2.1 (Eclair)
as minimum.
ExpandablePanel library brings a custom view class called ExpandablePanelView
to the final user. It implements the needed logic for integrating the expandable logic into your own Android application.
Custom Attributes
ExpandablePanel lib allows you to customize the following properties. Feel free to combine them to create cool user interfaces:
expandablepanel:completionPercent
: % of the parent's height where you want the autocomplete animation to begin working.expandablepanel:completeExpandAnimationSpeed
: Speed for the autocomplete animation.expandablepanel:completeShrinkAnimationSpeed
: Speed for the autoshrink animation.expandablepanel:beginExpanded
: Use it if you need the topView to begin expanded. If that's your case, the view will play a bounce animation at start to inform the user about the hidden bottom view.expandablepanel:bounceCount
: Use it to set the number of times topView is going to play bounce animation when it begins expanded.expandablepanel:invertBehavior
: Use it to invert the panel's behaviour and make bottomView become the expandable one. You can combine it with any other custom attributes. Bounce animation will get inverted too when using this attr.expandablepanel:animableViewId
: Use it to assign an animable view using the view identifier if yourExpandablePanelView
contains more than 2 child. This attribute is not mandatory, if you don't use it, first or second child (based on theexpandablepanel:invertBehavior
attribute) is going to be used as the animable view.expandablepanel:autoAnimateOnClick
: Use this one to enable automatic expanding or shrinking when user clicks on animable view.
Usage
In order to make it work, you will need to use ExpandablePanelView
class into your Android XML Layout.
- 1. Add
ExpandablePanelView
to the layout. - 2. Add two children views to the ExpandablePanelView XML element.
- 3.
ExpandablePanelView
extendsRelativeLayout
, so you will need to give an android id to the top view and setup theandroid:below
attribute in the bottom one. - 4. Set the
xmlns:draggable_view="http://schemas.android.com/apk/res-auto"
if you are going to use any of the cusom attributes.
Use ExpandableListener
if you want your class to be able to get expandable callbacks. Following methods are offered to the user:
onExpandingStarted
: Dispatched when the user starts expanding the view.