99 lines
3.0 KiB
Markdown
99 lines
3.0 KiB
Markdown
# Android Swipe Layout
|
|
|
|
This is the brother of [AndroidViewHover](https://github.com/daimajia/AndroidViewHover).
|
|
|
|
One year ago, I started to make an app named [EverMemo](https://play.google.com/store/apps/details?id=com.zhan_dui.evermemo) with my good friends. The designer gave me a design picture, the design like this:
|
|
|
|
|
|
|
|
I found it's pretty hard to archive this effect, cause you have to be very familiar with the Android Touch System. It was beyond my ability that moment, and I also noticed that there was no such a concept library...
|
|
|
|
So... as you see right now.
|
|
|
|
## Demo
|
|
|
|
|
|
|
|
Before I made this, I actually found some libraries (eg.[SwipeListView](https://github.com/47deg/android-swipelistview)) that helps developers to integrate swiping with your UI component. But they have too much limitation, only in ListView, or some other limitations.
|
|
|
|
When I start to make this library, I set some goals:
|
|
|
|
- Can be easily integrated in anywhere, ListView, GridView, ViewGroup etc.
|
|
- Can receive `onOpen`,`onClose`,`onUpdate` callbacks.
|
|
- Can notifiy the hidden children how much they have shown.
|
|
- Can be nested each other.
|
|
|
|
## Usage
|
|
|
|
### Step 1
|
|
#### Gradle
|
|
|
|
```groovy
|
|
dependencies {
|
|
compile "com.daimajia.swipelayout:library:1.0.0@aar"
|
|
}
|
|
```
|
|
|
|
#### Maven
|
|
|
|
```xml
|
|
<dependency>
|
|
<groupId>com.daimajia.swipelayout</groupId>
|
|
<artifactId>library</artifactId>
|
|
<version>1.0.0</version>
|
|
<type>apklib</type>
|
|
</dependency>
|
|
```
|
|
|
|
#### Eclipse
|
|
|
|
|
|
### Step 2
|
|
|
|
Create a `SwipeLayout`:
|
|
|
|
- `SwipeLayout` must have 2 children (all should be an instance of `ViewGroup`).
|
|
|
|
```xml
|
|
<com.daimajia.swipe.SwipeLayout xmlns:android="http://schemas.android.com/apk/res/android"
|
|
android:layout_width="match_parent" android:layout_height="80dp">
|
|
<!-- Bottom View Start-->
|
|
<LinearLayout
|
|
android:background="#66ddff00"
|
|
android:id="@+id/bottom_wrapper"
|
|
android:layout_width="160dp"
|
|
android:weightSum="1"
|
|
android:layout_height="match_parent">
|
|
<!--What you want to show-->
|
|
</LinearLayout>
|
|
<!-- Bottom View End-->
|
|
|
|
<!-- Surface View Start -->
|
|
<LinearLayout
|
|
android:padding="10dp"
|
|
android:background="#ffffff"
|
|
android:layout_width="match_parent"
|
|
android:layout_height="match_parent">
|
|
<!--What you want to show in SurfaceView-->
|
|
</LinearLayout>
|
|
<!-- Surface View End -->
|
|
</com.daimajia.swipe.SwipeLayout>
|
|
```
|
|
|
|
There are some preset examples: [example1](./demo/src/main/res/layout/sample1.xml), [example2](./demo/src/main/res/layout/sample2.xml), [example3](./demo/src/main/res/layout/sample3.xml).
|
|
|
|
### Step3
|
|
|
|
[Source code](./demo/src/main/java/com/daimajia/swipedemo/MyActivity.java).
|
|
|
|
## Wiki
|
|
|
|
Wiki is under construction.
|
|
|
|
## About me
|
|
|
|
A student in mainland China.
|
|
|
|
Welcome to [offer me an internship](mailto:daimajia@gmail.com). If you have any new idea about this project, feel free to [contact me](mailto:daimajia@gmail.com). :smiley:
|
|
|