Android SwipeActionAdapter结合Pinnedheaderlistview实现复杂列表的左右滑动操作

在上一篇博客《Android 使用SwipeActionAdapter开源库实现简单列表的左右滑动操作》里，已经介绍了利用SwipeActionAdapter来左右滑动操作列表；然，有时候，会要求一些特殊的列表也能够实现左右滑动：
列表滑动过程中，分组标题可以固定在顶部，同时列表支持左右滑动！效果图如下：

那么该如何实现呢，一开始，我是打算使用SwipeActionAdapter+StickyListView 来做，尝试一番后，发现左右滑动ListView
Item时，它的背景（上图滑动时出现的颜色）不显示不显示了，怎么也解决不了，后来在github上也搜索了一番，也发现了这么一个项目https://github.com/he667/StickyListSwipe，同样是想使用SwipeActionAdapter+StickyListView来实现上图的效果，然，该项目也遇到了背景不显示的情况，且没有解决，无奈之下舍弃了该项目，决定使用SwipeActionAdapter+Pinnedheaderlistview，实现了上图所示效果。

关于如何使用SwipeActionAdapter该库，请看我上一篇博客《Android
使用SwipeActionAdapter开源库实现简单列表的左右滑动操作》；至于Pinnedheaderlistview的介绍，可以看下《Android PinnedHeaderListView
详解》这篇博客。

先熟悉下这两个库的使用，然后在跟着继续学习如何把这两个库融合到一起实现上面的效果！

1. 创建项目，分别导入SwipeActionAdapter和Pinnedheaderlistview两个库，这样方便直接对源码进行修改。

这里，因为之后修改代码时，SwipeActionAdapter和Pinnedheaderlistview之间也会有些依赖关系，所以我精简了一些，直接把SwipeActionAdapter拷贝到sample模块下，方便修改引用。（到最后下载源码即可看到最重的项目）

2. 使用Pinnedheaderlistview，创建头部可悬浮显示的列表

2.1 列表适配器

import android.content.Context;

import android.view.LayoutInflater;

import android.view.View;

import android.view.ViewGroup;

import android.widget.LinearLayout;

import android.widget.TextView;

import java.util.List;

import bean.HeaderItem;

import za.co.immedia.pinnedheaderlistview.SectionedBaseAdapter;

public class TestSectionedAdapter extends SectionedBaseAdapter {

    List<HeaderItem> headers;

    public TestSectionedAdapter(List<HeaderItem> headers) {

        this.headers = headers;

    }

    @Override

    public Object getItem(int section, int position) {

        return null;

    }

    @Override

    public long getItemId(int section, int position) {

        return 0;

    }

    @Override

    public int getSectionCount() {

        return headers.size();

    }

    @Override

    public int getCountForSection(int section) {

        return headers.get(section).dataItem.size();

    }

    @Override

    public View getItemView(int section, int position, View convertView, ViewGroup parent) {

        LinearLayout layout = null;

        if (convertView == null) {

            LayoutInflater inflator = (LayoutInflater) parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE);

            layout = (LinearLayout) inflator.inflate(R.layout.list_item, null);

        } else {

            layout = (LinearLayout) convertView;

        }

//        ((TextView) layout.findViewById(R.id.textItem)).setText("Section " + section + " Item " + position);

        ((TextView) layout.findViewById(R.id.textItem)).setText(headers.get(section).dataItem.get(position).name);

        return layout;

    }

    @Override

    public View getSectionHeaderView(int section, View convertView, ViewGroup parent) {

        LinearLayout layout = null;

        if (convertView == null) {

            LayoutInflater inflator = (LayoutInflater) parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE);

            layout = (LinearLayout) inflator.inflate(R.layout.header_item, null);

        } else {

            layout = (LinearLayout) convertView;

        }

//        ((TextView) layout.findViewById(R.id.textItem)).setText("Header for section " + section);

        ((TextView) layout.findViewById(R.id.textItem)).setText(headers.get(section).name);

        return layout;

    }

}

Adapter继承了SectionedBaseAdapter，并且实现它里面的抽象方法，尤其是getItemView和getSectionHeaderView两个方法，前者用于创建普通列表的布局，后者用于创建悬浮标题的布局。（具体讲解可参看《Android
PinnedHeaderListView 详解》）

2.2 填充数据，实现基本的悬浮头部列表

public class MainActivity extends Activity {

    List<HeaderItem> headers = new ArrayList<>();

    @Override

    protected void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.activity_main);

        initData();

        initView();

    }

    private void initView() {

        PinnedHeaderListView listView = (PinnedHeaderListView) findViewById(R.id.pinnedListView);

        SectionedBaseAdapter sectionedAdapter = new TestSectionedAdapter(headers);

        listView.setAdapter(sectionedAdapter);

    }

    private void initData() {

        for (int i = 0; i < 5; i++) {

            HeaderItem headerItem = new HeaderItem();

            List<DataItem> datas = new ArrayList<>();

            for (int j = 0; j < 5; j++) {

                DataItem dataItem = new DataItem();

                dataItem.name = " 列表数据 " + j;

                datas.add(dataItem);

            }

            headerItem.name = "标题 " + i;

            headerItem.dataItem = datas;

            headers.add(headerItem);

        }

    }

}

3. 在Pinnedheaderlistview基础上，扩展SwipeActionAdapter

3.1 修改SwipeActionAdapter，让其实现PinnedHeaderListView.PinnedSectionedHeaderAdapter，并实现其中的方法

public class SwipeActionAdapter extends DecoratorAdapter implements

        SwipeActionTouchListener.ActionCallbacks, PinnedHeaderListView.PinnedSectionedHeaderAdapter {

    private ListView mListView;

    private SwipeActionTouchListener mTouchListener;

    protected SwipeActionListener mSwipeActionListener;

    private boolean mFadeOut = false;

    private boolean mFixedBackgrounds = false;

    private boolean mDimBackgrounds = false;

    private float mFarSwipeFraction = 0.5f;

    private float mNormalSwipeFraction = 0.25f;

    protected HashMap<SwipeDirection, Integer> mBackgroundResIds = new HashMap<>();

    private SectionedBaseAdapter listAdapter;

    public SwipeActionAdapter(BaseAdapter baseAdapter, SectionedBaseAdapter listAdapter) {

        super(baseAdapter);

        this.listAdapter = listAdapter;

    }

    @Override

    public View getView(final int position, final View convertView, final ViewGroup parent) {

        SwipeViewGroup output = (SwipeViewGroup) convertView;

        if (output == null) {

            output = new SwipeViewGroup(parent.getContext());

            for (Map.Entry<SwipeDirection, Integer> entry : mBackgroundResIds.entrySet()) {

                output.addBackground(View.inflate(parent.getContext(), entry.getValue(), null), entry.getKey());

            }

            output.setSwipeTouchListener(mTouchListener);

        }

        output.setContentView(super.getView(position, output.getContentView(), output));

//        LogUtils.e(output);

        return output;

    }

    /**

     * SwipeActionTouchListener.ActionCallbacks callback

     * We just link it through to our own interface

     *

     * @param position  the position of the item that was swiped

     * @param direction the direction in which the swipe has happened

     * @return boolean indicating whether the item has actions

     */

    @Override

    public boolean hasActions(int position, SwipeDirection direction) {

        // 这样设置，标题栏就可以不用滑动了

        if (listAdapter != null) {

            if (listAdapter.isSectionHeader(position)) {

                return false;

            }

        }

        return mSwipeActionListener != null && mSwipeActionListener.hasActions(position, direction);

    }

    /**

     * SwipeActionTouchListener.ActionCallbacks callback

     * We just link it through to our own interface

     *

     * @param listView  The originating {@link ListView}.

     * @param position  The position to perform the action on, sorted in descending  order

     *                  for convenience.

     * @param direction The type of swipe that triggered the action

     * @return boolean that indicates whether the list item should be dismissed or shown again.

     */

    @Override

    public boolean onPreAction(ListView listView, int position, SwipeDirection direction) {

        return mSwipeActionListener != null && mSwipeActionListener.shouldDismiss(position, direction);

    }

    /**

     * SwipeActionTouchListener.ActionCallbacks callback

     * We just link it through to our own interface

     *

     * @param listView  The originating {@link ListView}.

     * @param position  The positions to perform the action on, sorted in descending  order

     *                  for convenience.

     * @param direction The type of swipe that triggered the action.

     */

    @Override

    public void onAction(ListView listView, int[] position, SwipeDirection[] direction) {

        if (mSwipeActionListener != null) mSwipeActionListener.onSwipe(position, direction);

    }

    /**

     * Set whether items should have a fadeOut animation

     *

     * @param mFadeOut true makes items fade out with a swipe (opacity -> 0)

     * @return A reference to the current instance so that commands can be chained

     */

    @SuppressWarnings("unused")

    public SwipeActionAdapter setFadeOut(boolean mFadeOut) {

        this.mFadeOut = mFadeOut;

        if (mListView != null) mTouchListener.setFadeOut(mFadeOut);

        return this;

    }

    /**

     * Set whether the backgrounds should be fixed or swipe in from the side

     * The default value for this property is false: backgrounds will swipe in

     *

     * @param fixedBackgrounds true for fixed backgrounds, false for swipe in

     */

    @SuppressWarnings("unused")

    public SwipeActionAdapter setFixedBackgrounds(boolean fixedBackgrounds) {

        this.mFixedBackgrounds = fixedBackgrounds;

        if (mListView != null) mTouchListener.setFixedBackgrounds(fixedBackgrounds);

        return this;

    }

    /**

     * Set whether the backgrounds should be dimmed when in no-trigger zone

     * The default value for this property is false: backgrounds will not dim

     *

     * @param dimBackgrounds true for dimmed backgrounds, false for no opacity change

     */

    @SuppressWarnings("unused")

    public SwipeActionAdapter setDimBackgrounds(boolean dimBackgrounds) {

        this.mDimBackgrounds = dimBackgrounds;

        if (mListView != null) mTouchListener.setDimBackgrounds(dimBackgrounds);

        return this;

    }

    /**

     * Set the fraction of the View Width that needs to be swiped before it is counted as a far swipe

     *

     * @param farSwipeFraction float between 0 and 1

     */

    @SuppressWarnings("unused")

    public SwipeActionAdapter setFarSwipeFraction(float farSwipeFraction) {

        if (farSwipeFraction < 0 || farSwipeFraction > 1) {

            throw new IllegalArgumentException("Must be a float between 0 and 1");

        }

        this.mFarSwipeFraction = farSwipeFraction;

        if (mListView != null) mTouchListener.setFarSwipeFraction(farSwipeFraction);

        return this;

    }

    /**

     * Set the fraction of the View Width that needs to be swiped before it is counted as a normal swipe

     *

     * @param normalSwipeFraction float between 0 and 1

     */

    @SuppressWarnings("unused")

    public SwipeActionAdapter setNormalSwipeFraction(float normalSwipeFraction) {

        if (normalSwipeFraction < 0 || normalSwipeFraction > 1) {

            throw new IllegalArgumentException("Must be a float between 0 and 1");

        }

        this.mNormalSwipeFraction = normalSwipeFraction;

        if (mListView != null) mTouchListener.setNormalSwipeFraction(normalSwipeFraction);

        return this;

    }

    /**

     * We need the ListView to be able to modify it's OnTouchListener

     *

     * @param listView the ListView to which the adapter will be attached

     * @return A reference to the current instance so that commands can be chained

     */

    public SwipeActionAdapter setListView(ListView listView) {

        this.mListView = listView;

        mTouchListener = new SwipeActionTouchListener(listView, this);

        this.mListView.setOnTouchListener(mTouchListener);

        this.mListView.setOnScrollListener(mTouchListener.makeScrollListener());

        this.mListView.setClipChildren(false);

        mTouchListener.setFadeOut(mFadeOut);

        mTouchListener.setDimBackgrounds(mDimBackgrounds);

        mTouchListener.setFixedBackgrounds(mFixedBackgrounds);

        mTouchListener.setNormalSwipeFraction(mNormalSwipeFraction);

        mTouchListener.setFarSwipeFraction(mFarSwipeFraction);

        return this;

    }

    /**

     * Getter that is just here for completeness

     *

     * @return the current ListView

     */

    @SuppressWarnings("unused")

    public AbsListView getListView() {

        return mListView;

    }

    /**

     * Add a background image for a certain callback. The key for the background must be one of the

     * directions from the SwipeDirections class.

     *

     * @param key   the identifier of the callback for which this resource should be shown

     * @param resId the resource Id of the background to add

     * @return A reference to the current instance so that commands can be chained

     */

    public SwipeActionAdapter addBackground(SwipeDirection key, int resId) {

        if (SwipeDirection.getAllDirections().contains(key)) mBackgroundResIds.put(key, resId);

        return this;

    }

    /**

     * Set the listener for swipe events

     *

     * @param mSwipeActionListener class listening to swipe events

     * @return A reference to the current instance so that commands can be chained

     */

    public SwipeActionAdapter setSwipeActionListener(SwipeActionListener mSwipeActionListener) {

        this.mSwipeActionListener = mSwipeActionListener;

        return this;

    }

    @Override

    public boolean isSectionHeader(int position) {

        return listAdapter.isSectionHeader(position);

    }

    @Override

    public int getSectionForPosition(int position) {

        return listAdapter.getSectionForPosition(position);

    }

    @Override

    public int getPositionInSectionForPosition(int position) {

        return listAdapter.getPositionInSectionForPosition(position);

    }

    @Override

    public View getSectionHeaderView(int section, View convertView, ViewGroup parent) {

        return listAdapter.getSectionHeaderView(section, convertView, parent);

    }

    @Override

    public int getSectionHeaderViewType(int section) {

        return listAdapter.getSectionHeaderViewType(section);

    }

    /**

     * Interface that listeners of swipe events should implement

     */

    public interface SwipeActionListener {

        boolean hasActions(int position, SwipeDirection direction);

        boolean shouldDismiss(int position, SwipeDirection direction);

        void onSwipe(int[] position, SwipeDirection[] direction);

    }

}

注1：在SwipeActionAdapter中，我们把PinnedHeaderListView.PinnedSectionedHeaderAdapter接口中的方法，完全交给了通过构造方法传递过来的listAdapter进行处理，SwipeActionAdapter只做了一层封装的作用。

注2：修改了public boolean hasActions(int position, SwipeDirection direction) 方法，因为，如果不修改的话，左右滑动时，连标题栏也可以滑动了，所以在该方法中，我们判断如果滑动的事标题栏，则禁止其滑动。

3.2 实现分组且可左右滑动的列表

public class MainActivity extends Activity implements SwipeActionAdapter.SwipeActionListener {

    protected SwipeActionAdapter mAdapter;

    List<HeaderItem> headers = new ArrayList<>();

    @Override

    protected void onCreate(Bundle savedInstanceState) {

        super.onCreate(savedInstanceState);

        setContentView(R.layout.activity_main);

        initData();

        initView();

    }

    private void initView() {

        PinnedHeaderListView listView = (PinnedHeaderListView) findViewById(R.id.pinnedListView);

        SectionedBaseAdapter sectionedAdapter = new TestSectionedAdapter(headers);

        mAdapter = new SwipeActionAdapter(sectionedAdapter, sectionedAdapter);

        mAdapter.setSwipeActionListener(this)

                .setDimBackgrounds(true)

                .setListView(listView);

        listView.setAdapter(mAdapter);

        mAdapter.addBackground(SwipeDirection.DIRECTION_FAR_LEFT, R.layout.row_bg_left_far)

                .addBackground(SwipeDirection.DIRECTION_NORMAL_LEFT, R.layout.row_bg_left)

                .addBackground(SwipeDirection.DIRECTION_FAR_RIGHT, R.layout.row_bg_right_far)

                .addBackground(SwipeDirection.DIRECTION_NORMAL_RIGHT, R.layout.row_bg_right);

    }

    @Override

    public boolean hasActions(int position, SwipeDirection direction) {

        return true;

    }

    @Override

    public boolean shouldDismiss(int position, SwipeDirection direction) {

        boolean isDismiss = false;

        switch (direction) {

            case DIRECTION_FAR_RIGHT:

            case DIRECTION_NORMAL_RIGHT:

                isDismiss = true;

                break;

        }

        return isDismiss;

    }

    @Override

    public void onSwipe(int[] positionList, SwipeDirection[] directionList) {

        for (int i = 0; i < positionList.length; i++) {

            SwipeDirection direction = directionList[i];

            int position = positionList[i];

            String dir = "";

            switch (direction) {

                case DIRECTION_FAR_LEFT:

                    dir = "删除";

                    break;

                case DIRECTION_NORMAL_LEFT:

                    dir = "编辑";

                    break;

                case DIRECTION_FAR_RIGHT:

                    dir = "标为完成";

                    break;

                case DIRECTION_NORMAL_RIGHT:

                    dir = "标为未完成";

                    break;

            }

            Toast.makeText(this, dir, Toast.LENGTH_SHORT).show();

        }

    }

    private void initData() {

        for (int i = 0; i < 5; i++) {

            HeaderItem headerItem = new HeaderItem();

            List<DataItem> datas = new ArrayList<>();

            for (int j = 0; j < 5; j++) {

                DataItem dataItem = new DataItem();

                dataItem.name = " 列表数据 " + j;

                datas.add(dataItem);

            }

            headerItem.name = "标题 " + i;

            headerItem.dataItem = datas;

            headers.add(headerItem);

        }

        LogUtils.e(FastJsonUtil.t2Json2(headers));

        for (int i = 0; i < headers.size(); i++) {

            HeaderItem headerItem = headers.get(i);

            List<DataItem> dataItems = headerItem.dataItem;

            for (int j = 0; j < dataItems.size(); j++) {

//                LogUtils.e(headerItem.name + "   " + dataItems.get(j).name);

            }

        }

    }

}

注: 首先确定你知道SwipeActionAdapter如何使用，可参考《Android
使用SwipeActionAdapter开源库实现简单列表的左右滑动操作》，然后，在initView方法中，需要添加mAdapter = new SwipeActionAdapter(sectionedAdapter, sectionedAdapter);其中sectionedAdapter是SectionedBaseAdapter的实例，前面扩展SwipeActionAdapter时提过，要把SwipeActionAdapter只是封装了一层SectionedBaseAdapter中的方法，具体的实现，由传递过来的实例对象sectionedAdapter来实现。

4.
为列表添加事件处理

4.1 在onSwipe(int[] positionList, SwipeDirection[] directionList)方法中处理滑动事件

 @Override

    public void onSwipe(int[] positionList, SwipeDirection[] directionList) {

        for (int i = 0; i < positionList.length; i++) {

            SwipeDirection direction = directionList[i];

            int position = positionList[i];

            String dir = "";

            switch (direction) {

                case DIRECTION_FAR_LEFT:

                    dir = "删除";

                    break;

                case DIRECTION_NORMAL_LEFT:

                    dir = "编辑";

                    break;

                case DIRECTION_FAR_RIGHT:

                    dir = "标为完成";

                    break;

                case DIRECTION_NORMAL_RIGHT:

                    dir = "标为未完成";

                    break;

            }

            Toast.makeText(this, dir, Toast.LENGTH_SHORT).show();

            if (mAdapter != null) {

                try {

                    int section = mAdapter.getSectionForPosition(position);

                    int itemPos = mAdapter.getPositionInSectionForPosition(position);

                    if (position != -1) {

//                    String sectionName = headers.get(section).name;

//                    DataItem dataItem = headers.get(section).dataItem.get(itemPos);

                        headers.get(section).dataItem.remove(itemPos);

                        mAdapter.notifyDataSetChanged();

                    }

                } catch (Exception e) {

                    e.printStackTrace();

                }

            }

        }

其中，mAdapter是上面扩展的SwipeActionAdapter的实例。通过mAdapter，可以获取滑动的标题的位置、数据项在标题中位置。之后，就可以操作数据了。

4.2 列表的点击事件

listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {

            @Override

            public void onItemClick(AdapterView<?> adapterView, View view, int rawPosition, long id) {

                PinnedHeaderListView.PinnedSectionedHeaderAdapter adapter;

                if (adapterView.getAdapter().getClass().equals(HeaderViewListAdapter.class)) {

                    HeaderViewListAdapter wrapperAdapter = (HeaderViewListAdapter) adapterView.getAdapter();

                    adapter = (PinnedHeaderListView.PinnedSectionedHeaderAdapter) wrapperAdapter.getWrappedAdapter();

                } else {

                    adapter = (PinnedHeaderListView.PinnedSectionedHeaderAdapter) adapterView.getAdapter();

                }

                int section = adapter.getSectionForPosition(rawPosition);

                int position = adapter.getPositionInSectionForPosition(rawPosition);

//                LogUtils.e("section : " + section + "  position : " + position);

                if (position != -1) {

                    String sectionName = headers.get(section).name;

                    DataItem dataItem = headers.get(section).dataItem.get(position);

                    LogUtils.e(sectionName + " --> " + dataItem.name);

                }

            }

        });

如此这般，就OK啦！欢迎指正！

如有疑问，请留言，共同探讨。

源码地址: https://github.com/zuiwuyuan/PinnedHeader_SwipeAction_ListView

巴特西

Android SwipeActionAdapter结合Pinnedheaderlistview实现复杂列表的左右滑动操作

最新文章

热门文章