Horizontal list view for Android which allows variable items widths
Clone or download
Latest commit 70a3e0a Mar 27, 2015
Failed to load latest commit information.
demo refactoring... Jun 4, 2014
gradle/wrapper updated demo app Mar 4, 2014
library Applied EdgeEffectCompat Sep 23, 2014
.gitignore updated readme, removed pom from git Feb 13, 2014
HorizontalListView.iml gradle Nov 15, 2013
README.md Update README.md Mar 26, 2015
build.gradle refactoring... Jun 4, 2014
gradle.properties version Jun 4, 2014
gradlew gradle Nov 10, 2013
gradlew.bat gradle Nov 10, 2013
settings.gradle maven release Nov 22, 2013



This widget is now deprecated and it won't be updated anymore. Use RecyclerView instead

Horizontal Variable ListView

Horizontal ListView for Android. Based on the official ListView google code. The library includes also an ExpandableHListView, also based on the official ExpandableListView.
See the demo project for sample implementations

Usage (gradle)

Add this line to your dependency group:

compile 'it.sephiroth.android.library.horizontallistview:hlistview:1.2.2'


It supports almost all the features of the ListView widget. There are minor differences in the attributes supported like "hlv_dividerWidth" instead of the default "dividerHeight".

This is the styleable used for the HListView class:

    <declare-styleable name="HListView">
        <attr name="android:entries" />
        <attr name="android:divider" />
        <attr name="hlv_dividerWidth" format="dimension" />
        <attr name="hlv_headerDividersEnabled" format="boolean" />
        <attr name="hlv_footerDividersEnabled" format="boolean" />
        <attr name="hlv_overScrollHeader" format="reference|color" />
        <attr name="hlv_overScrollFooter" format="reference|color" />
        When "wrap_content" is used as value of the layout_height property.
        Pass the position, inside the adapter, of the view being used to measure the view
        or '-1' to use the default behavior ( default is -1 )
        <attr name="hlv_measureWithChild" format="integer" />

    <declare-styleable name="AbsHListView">
        <attr name="android:listSelector" />
        <attr name="android:smoothScrollbar" />
        <attr name="android:drawSelectorOnTop" />
        <attr name="android:cacheColorHint" />
        <attr name="android:scrollingCache" />
        <attr name="android:choiceMode" />
        <attr name="hlv_stackFromRight" format="boolean" />
        <attr name="hlv_transcriptMode">
            <enum name="disabled" value="0"/>
            <enum name="normal" value="1" />
            <enum name="alwaysScroll" value="2" />


  • 1.2.0 Added the ExpandableHListView

API Requirements

The minimum supported Android version is android 2.3 (API Level 9)


This software is distributed under Apache License 2.0: http://www.apache.org/licenses/LICENSE-2.0

Author Alessandro Crugnola