Permalink
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
87 lines (64 sloc) 2.74 KB

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.