Android开源框架之SwipeListView导入及模拟QQ侧滑

　　SwipeListView是Github上的一个开源框架，地址：https://github.com/47deg/android-swipelistview

　　SwipeListView was born out of the need to add swipe gestures to ListView on Android.

　　因为开发需要整一个类似QQ侧滑删除的ListView，一开始准备自己写一个自定义layout作为item布局，依稀记得有个叫swipelistview的开源框架，结果还真可以拿来用，效果略有差别，但也满足项目要求了。那么，问题也来了，Github上最后的push的SwipelistView使用的是Gradle来构建，无奈鄙人几个月来一直在用es开始开发，考虑到可能要查看或者修改它的源码，就只好手工转为ecplise下的工程。下面先上Demo说明基本使用方法，方法都很简单，主要是网上搜索的资料都不是很完整，自己写一篇备忘，也供新手朋友们参考，再说说Gradle构建的swipelistview Module如何导入eclipse工程。

　　一、引用swipelistview库开发带侧滑+按钮的ListView

　　　　swipelistview的使用同listview的使用方法差不多，因为swipelistview是直接继承于ListView的，只是扩展了一些方法。

　　　　官方给出了再XML布局文件中的基本写法：

<com.fortysevendeg.swipelistview.SwipeListView
            xmlns:swipe="http://schemas.android.com/apk/res-auto"
            android:id="@+id/example_lv_list"
            android:listSelector="#00000000"
            android:layout_width="fill_parent"
            android:layout_height="wrap_content"
            swipe:swipeFrontView="@+id/front"
            swipe:swipeBackView="@+id/back"
            swipe:swipeActionLeft="[reveal | dismiss]"
            swipe:swipeActionRight="[reveal | dismiss]"
            swipe:swipeMode="[none | both | right | left]"
            swipe:swipeCloseAllItemsWhenMoveList="[true | false]"
            swipe:swipeOpenOnLongPress="[true | false]"
            swipe:swipeAnimationTime="[miliseconds]"
            swipe:swipeOffsetLeft="[dimension]"
            swipe:swipeOffsetRight="[dimension]"
            />

各属性说明如下：

swipeFrontView - Required - front view id.
swipeBackView - Required - back view id.
swipeActionLeft - Optional - left swipe action Default: 'reveal'
swipeActionRight - Optional - right swipe action Default: 'reveal'
swipeMode - Gestures to enable or 'none'. Default: 'both'
swipeCloseAllItemsWhenMoveList - Close revealed items on list motion. Default: 'true'
swipeOpenOnLongPress - Reveal on long press Default: 'true'
swipeAnimationTime - item drop animation time. Default: android configuration
swipeOffsetLeft - left offset
swipeOffsetRight - right offset

 

Demo地址,效果图：

我们自己定义swipelistview的item布局:

<?xml version="1.0" encoding="utf-8"?>

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent" >

    <LinearLayout
        android:id="@+id/backview"
        android:layout_width="match_parent"
        android:layout_height="70dp"
        android:background="#eee"
        android:tag="back" >

        <Button
            android:id="@+id/example_1"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="2"
            android:background="@null" />

        <Button
            android:id="@+id/edit"
            android:layout_width="0dp"
            android:layout_height="60dp"
            android:layout_gravity="center"
            android:layout_weight="1"
            android:background="@drawable/edit"
            android:text="编辑" />

        <Button
            android:id="@+id/del"
            android:layout_width="0dp"
            android:layout_height="60dp"
            android:layout_gravity="center"
            android:layout_marginLeft="10dp"
            android:layout_weight="1"
            android:background="@drawable/del"
            android:text="删除" />
    </LinearLayout>

    <RelativeLayout
        android:id="@+id/frontview"
        android:layout_width="match_parent"
        android:layout_height="70dp"
        android:background="#ffffff"
        android:orientation="vertical"
        android:tag="front" >

        <TextView
            android:id="@+id/example_row_tv_title"
            android:layout_width="fill_parent"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            android:textSize="16sp" />
    </RelativeLayout>

</FrameLayout>

 

 

在布局swipeview所在布局文件中的定义

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    xmlns:swipe="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity" >

    <com.fortysevendeg.swipelistview.SwipeListView
        android:id="@+id/example_lv_list"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        swipe:swipeActionLeft="reveal"
        swipe:swipeActionRight="reveal"
        swipe:swipeAnimationTime="0"
        swipe:swipeBackView="@+id/backview"
        swipe:swipeCloseAllItemsWhenMoveList="true"
        swipe:swipeFrontView="@+id/frontview"
        swipe:swipeMode="both"
        swipe:swipeOffsetLeft="0dp"
        swipe:swipeOffsetRight="0dp"
        swipe:swipeOpenOnLongPress="false" />

</RelativeLayout>

　　使用注意点:

　　　　　为了让每次显示滑动一条数据，需要在你自己实现的BaseSwipeListViewListener中重写onStartOpen方法，在里面调用mSwipeListView.closeOpenedItems()。

　　二、导入swipelistview到eclipse工程

　　　　也许有人一看是gradle构建的android项目就不知道怎么办了,以为as构建的项目是不能之间导入eclipse工程的。幸运的是，swipelistview工程极其简洁，手工导入eclipse也是比较的容易的。

　　　　1. 新建一个android工程，勾选标记为libraray，且不用创建activity。

　　　　　　

　　　　2. 将下载下来的android-swipelistview-master工程中\android-swipelistview-master\swipelistview\src\main\java下的com文件下直接粘贴到新建工程的src目录下。

同时把\android-swipelistview-master\swipelistview\src\main目录下的res资源放到eclipse下新建的Android库工程对应目录下。

　　　　3. 做完上面两部还没有完，因为swipelistview依赖nineoldandroids库，且目前的swipelistview版本依赖nineoldandroids-2.4.0+，下载地址https://github.com/JakeWharton/NineOldAndroids，可以只下载

nineoldandroids-2.4.0.jar,直接放在新建android库工程的libs目录下即可。至此导入工作完成。