Skip to content
This repository has been archived by the owner on Dec 1, 2017. It is now read-only.

Commit

Permalink
[readme] Update to match the state of the project
Browse files Browse the repository at this point in the history
  • Loading branch information
lucasr committed Sep 5, 2014
1 parent 27e9290 commit c236b2f
Showing 1 changed file with 36 additions and 22 deletions.
58 changes: 36 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,49 @@
NOTE: TwoWayView's API is not final yet and code is under heavy development
at the moment. Do not rely on it for production code just yet. Feedback and
at the moment. Feedback and
patches are very welcome!

What is it?
===========

An AdapterView with support for vertical and horizontal scrolling.
The ultimate utility belt for `RecyclerView`.

Features
========

* View recycling while scrolling, just like ListView/GridView.
* Vertical and horizontal scrolling support.
* Accessibility support
* Keyboard events and navigation
* Focus handling

A lot more to come, stay tuned.

How do I use it?
================

1. Import TwoWayView as a library to your project.

2. Add a `TwoWayView` to your layout.
* A `LayoutManager` base class that greatly simplified the development of custom layouts for `RecyclerView`
* A collection of feature-complete stock layouts for `RecyclerView` including:
* List
* Grid
* Staggered Grid
* Spannable Grid
* A collection of stock item decorations including:
* Item spacing
* Horizontal/vertical dividers.
* `ListView`-style pluggable APIs for:
* Item click and long click support e.g. `OnItemClickListener` and `OnItemLongClickListener`.
* Item selection (single and multiple) support e.g. `setChoiceMode()`, `setItemChecked(int, boolean)`, etc.

Snapshot
========

3. Set an Adapter to the TwoWayView.
The new API is still under heavy development but you can try it now via Maven Central snapshots.

The sample app uses all features available in the widget.
Gradle:
```groovy
repositories {
maven { url "https://oss.sonatype.org/content/repositories/snapshots/" }
}
dependencies {
compile 'org.lucasr.twowayview:core:1.0.0-SNAPSHOT'
compile 'org.lucasr.twowayview:layouts:1.0.0-SNAPSHOT'
}
```

Stable Release
==============

Download
========
TwoWayView used to be a standalone `AdapterView` implementation. You can grab it here from Maven Central as follows.

Grab via Maven:
```xml
@@ -41,11 +53,13 @@ Grab via Maven:
<version>0.1.1</version>
</dependency>
```
or Gradle:

Gradle:
```groovy
compile 'org.lucasr.twowayview:twowayview:0.1.1'
compile 'org.lucasr.twowayview:core:0.1.1'
```


Want to help?
=============

0 comments on commit c236b2f

Please sign in to comment.