Android Scrolling library: Horizontal List View, Grid Views with varying sizes and grid patterns, View pager that uses an adapter and more.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
integration
library
sample
.gitignore
.travis.yml
CHANGELOG.md
CONTRIBUTING.md
LICENSE.md
README.md

README.md

Parchment

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

Requires

Android 2.2 +

Getting Started

Step 1: Set up

pom.xml

<dependency>
    <groupId>mobi.parchment</groupId>
    <artifactId>parchment</artifactId>
    <version>1.6.9</version>
    <type>apklib</type>
</dependency>

build.gradle

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

eclipse

[Adding parchment as an Android library in Eclipse] (https://github.com/EmirWeb/parchment/wiki/Eclipse-Tutorial)

Step 2: XML

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

<mobi.parchment.widget.listview.ListView
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:parchment="http://schemas.android.com/apk/res/<YOUR PACKAGE NAME>"
    android:id="@+id/horizontal_list_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    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:cellSpacing="10dp"
    parchment:isCircularScroll="< true | false >"
    parchment:snapPosition="< center | start | end | onScreen >"
    parchment:snapToPosition="< true | false >" />

Step 3: Java

Set Adapters and go:

    mListView.setAdapter(mAdapter);

License:

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

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.