Android Scrolling library: Horizontal List View, Grid Views with varying sizes and grid patterns, View pager that uses an adapter and more.
Java Groovy
Switch branches/tags
Nothing to show
Clone or download


Build Status

Horizontal/Vertical ListView, GridView, ViewPager, and GridPatternView

The Parchment library attempts to add the functionality that developers want to their AdapterViews, by providing horizontal and vertical scrolling to all of its AdapterViews. Parchment gives developers more control of layout by choosing from a simple horizontal List View, a GridView that wraps heights or a GridPatternView that lets a user specify the grid pattern.

alt tag


Android 2.2 +

Getting Started

Step 1: Set up




dependencies {
    compile 'mobi.parchment:parchment:1.6.9@aar'


[Adding parchment as an Android library in Eclipse] (

Step 2: XML

Add one of the AdapterView classes (GridView, ListView, GridPatternView), don't forget to choose an orientation:

    xmlns:parchment="<YOUR PACKAGE NAME>"
    android:scrollbars="< horizontal | vertical >"
    android:scrollbarAlwaysDrawHorizontalTrack="< true | false >"
    android:scrollbarAlwaysDrawVerticalTrack="< true | false >"
    android:clipToPadding="< true | false >"
    parchment:isViewPager="< true | false >"
    parchment:orientation="< horizontal | vertical >"
    parchment:isCircularScroll="< true | false >"
    parchment:snapPosition="< center | start | end | onScreen >"
    parchment:snapToPosition="< true | false >" />

Step 3: Java

Set Adapters and go:



Copyright 2014 Emir Hasanbegovic

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

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.