流水不争先,争的是滔滔不绝

Android手把手朋友圈实战教程(二)ListView(中)

即时通讯软件开发 云聊IM 971℃

项目地址:https://github.com/razerdp/FriendCircle

上一篇我们初步弄出了一个Header,虽然这个header实现的仅仅是弄了一个灰色的图层,但我们需要的是它的回调。

这一篇,我们针对框架封装一个listview出来。

这里简要说说android-Ultra-Pull-To-Refresh这个框架,这个框架继承viewgroup,其实现原理是只能够add2个view,一个作为header,一个作为content,事件分发在dispatchTouchEvent处理,由于继承的viewgroup,所以理论上来说可以添加任何view来实现下拉刷新。

那我们目的就很明确,要将这个框架弄成一个listview(起码让使用的人看起来就是一个listview),我们就要按照listview的风格去弄这个控件,首先当然是定义我们的attrs,我们的attrs属性直接拉官方的包,在as中切换到project标签,依次打开 ->res->values->attrs.xml,然后ctrl+f找到abslistview和listview,把你觉得常用的都拉到我们自己新建的attrs.xml里面。

参考图

经过筛选,初步提取出以下属性:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <declare-styleable name="FriendCirclePtrListView">
        <!--abslistview start-->
        <!--=====================================-->     
        <attr name="listSelector" format="color|reference" />
        <attr name="transcriptMode">      
            <enum name="disabled" value="0"/>      
            <enum name="normal" value="1" />    
            <enum name="alwaysScroll" value="2" />
        </attr>  
        <attr name="cacheColorHint" format="color" /> 
        <attr name="fastScrollEnabled" format="boolean" />
        <attr name="fastScrollStyle" format="reference" />
        <attr name="smoothScrollbar" format="boolean" />
        <attr name="choiceMode">
            <!-- Normal list that does not indicate choices. -->
            <enum name="none" value="0" />
            <!-- The list allows up to one choice. -->
            <enum name="singleChoice" value="1" />
            <!-- The list allows multiple choices. -->
            <enum name="multipleChoice" value="2" />
            <!-- The list allows multiple choices in a custom selection mode. -->
            <enum name="multipleChoiceModal" value="3" />
        </attr>
        <!--=====================================-->
        <!--abslistview end-->
        <!--=====================================-->
        <!--listview start-->
        <attr name="listview_divider" format="reference|color" />
        <attr name="dividerHeight" format="dimension" />
        <attr name="overScrollHeader" format="reference|color" />
        <attr name="overScrollFooter" format="reference|color" />
    </declare-styleable>
</resources>

然后在我们的构造器中直接拉官方源码:

private void initAttrs(Context context, AttributeSet attrs) {
    final TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.FriendCirclePtrListView);

    final Drawable selector = a.getDrawable(R.styleable.FriendCirclePtrListView_listSelector);
    if (selector != null) {
        mListView.setSelector(selector);
    }

    mListView.setTranscriptMode(a.getInt(R.styleable.FriendCirclePtrListView_transcriptMode, 0));
    mListView.setCacheColorHint(a.getColor(R.styleable.FriendCirclePtrListView_cacheColorHint, 0));
    mListView.setFastScrollEnabled(a.getBoolean(R.styleable.FriendCirclePtrListView_fastScrollEnabled, false));
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
        mListView.setFastScrollStyle(a.getResourceId(R.styleable.FriendCirclePtrListView_fastScrollStyle, 0));
    }
    mListView.setSmoothScrollbarEnabled(a.getBoolean(R.styleable.FriendCirclePtrListView_smoothScrollbar, true));
    mListView.setChoiceMode(a.getInt(R.styleable.FriendCirclePtrListView_choiceMode, 0));

    final Drawable d = a.getDrawable(R.styleable.FriendCirclePtrListView_listview_divider);
    if (d != null) {
        // Use an implicit divider height which may be explicitly
        // overridden by android:dividerHeight further down.
        mListView.setDivider(d);
    }

    // Use an explicit divider height, if specified.
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP_MR1) {
        if (a.hasValueOrEmpty(R.styleable.FriendCirclePtrListView_dividerHeight)) {
            final int dividerHeight = a.getDimensionPixelSize(R.styleable.FriendCirclePtrListView_dividerHeight, 0);
            if (dividerHeight != 0) {
                mListView.setDividerHeight(dividerHeight);
            }
        }
    }
    else {
        final int dividerHeight = a.getDimensionPixelSize(R.styleable.FriendCirclePtrListView_dividerHeight, 0);
        if (dividerHeight != 0) {
            mListView.setDividerHeight(dividerHeight);
        }
    }

    final Drawable osHeader = a.getDrawable(R.styleable.FriendCirclePtrListView_overScrollHeader);
    if (osHeader != null) {
        mListView.setOverscrollHeader(osHeader);
    }

    final Drawable osFooter = a.getDrawable(R.styleable.FriendCirclePtrListView_overScrollFooter);
    if (osFooter != null) {
        mListView.setOverscrollFooter(osFooter);
    }
    a.recycle();
}

值得注意的是dividerheight这个属性,需要区分一下SDK版本,另外我的divider这个属性不知道为什么会提示重复属性,于是我只好改了一下名字改为listview_divider

初始化中进行各种各样的框架属性定义,代码如下:

private void initView(Context context) {
    //header
    mHeader = new FriendCirclePtrHeader(context);
    //listview
    mListView = new ListView(context);
    mListView.setSelector(android.R.color.transparent);
    mListView.setLayoutParams(
            new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
    //footer
    mFooter = new FriendCirclePtrFooter(context);

    //view add
    setHeaderView(mHeader);
    addView(mListView);

    //ptr option
    addPtrUIHandler(mHeader.getPtrUIHandler());
    setPtrHandler(this);
    setResistance(2.3f);
    setRatioOfHeaderHeightToRefresh(.25f);
    setDurationToClose(200);
    setDurationToCloseHeader(1000);
    //刷新时的固定的偏移量
    setOffsetToKeepHeaderWhileLoading(0);

    //下拉刷新,即下拉到距离就刷新而不是松开刷新
    setPullToRefresh(false);
    //刷新的时候保持头部?
    setKeepHeaderWhenRefresh(false);

    setScrollListener();
}

我们在控件中new一个listview,作为content,然后new一个header,就是上一篇的那个header,作为我们的header,接着footer备用,用于滑到底部自动加载时显示用的,这里没有什么技术含量,在setScrollListener(),我们对listview进行滑动监听,当滑动到底部的时候,进行加载更多的操作(本篇暂未实现)

int lastItem = 0;

private void setScrollListener() {
    mListView.setOnScrollListener(new AbsListView.OnScrollListener() {
        @Override
        public void onScrollStateChanged(AbsListView view, int scrollState) {
            if (mOnLoadMoreRefreshListener != null) {
                if (SCROLL_STATE_IDLE == scrollState &&
                        0 != mListView.getFirstVisiblePosition() && lastItem == mListView.getCount()) {
                    if (hasMore && loadmoreState != PullStatus.REFRESHING) {
                        // TODO: 2016/2/10 待完成
                        //当有更多同时当前加载更多布局不再刷新状态,则执行刷新
                    }
                }
            }
        }

        @Override
        public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) {
            lastItem = firstVisibleItem + visibleItemCount;
        }
    });
}

那么,现在listview有了,滑动监听也有了,我们该如何实现下拉刷新的监听呢,在框架中有这么一个接口PtrHandler,这个接口需要我们实现两个回调:

public interface PtrHandler {

    /**
     * Check can do refresh or not. For example the content is empty or the first child is in view.
     * 

* {@link in.srain.cube.views.ptr.PtrDefaultHandler#checkContentCanBePulledDown} */ public boolean checkCanDoRefresh(final PtrFrameLayout frame, final View content, final View header); /** * When refresh begin * * @param frame */ public void onRefreshBegin(final PtrFrameLayout frame); }

根据官方文档,第一个回调是我们决定能否下拉,通常返回官方自带的判断工具类就可以了,第二个就是刷新回调了。

为了方便控制,我们在控件里定义两个枚举:

  1. 当前模式:下拉刷新、上拉加载
  2. 当前状态:普通(无状态)、正在刷新

定义这两个状态的目的是为了方便我们以后扩展的时候用,比如如果当前状态是正在刷新,我们就禁用掉下拉功能什么的。。。。

public enum PullStatus {
    NORMAL,REFRESHING
}
public enum PullMode {
    FROM_START,FROM_BOTTOM
}

同时,我们定义两个接口,这两个接口用于外部回调,方便控制状态:

/**
 * Created by 大灯泡 on 2016/2/9.
 * 下拉刷新接口
 */
public interface OnPullDownRefreshListener {
    void onRefreshing(PtrFrameLayout frame);
}
/**
 * Created by 大灯泡 on 2016/2/9.
 * 加载更多接口
 */
public interface OnLoadMoreRefreshListener {
    void onRefreshing();
}

接下来在我们的框架回调中执行下面步骤:

@Override
public void onRefreshBegin(PtrFrameLayout frame) {
    curMode = PullMode.FROM_START;
    loadmoreState = PullStatus.NORMAL;
    if (mOnPullDownRefreshListener != null) mOnPullDownRefreshListener.onRefreshing(frame);
}

根据官方文档,官方并未提供上拉加载更多的接口,也就是说这个回调必定是下拉刷新的回调,所以我们的模式指定为from_start,loadmoreState(加载更多状态)则是normal,另外还有一个pullState,这个是下拉状态,该状态由header对应ui接口回调控制。(详情看上篇)

做完这一系列的操作后,我们的下拉刷新基本完成了,但是还有一个很重要的东东,就是刷新的icon,但是这个icon我们的listview不负责控制,控制在header里面(详情看上篇),listview仅用于传值。

在中篇最后让我们分析一下

到目前为止:

我们写了一个header,一个listview(继承PtrFrameLayout)

其中:

  1. header有两个作用,一个是控制自身下拉的展示,另一个是控制刷新icon的展示
  2. listview则是继承框架,其作用是做刷新相关操作以及暴露listview接口,让外界看起来像是一个listview

写到这里我思考到一个问题:刷新icon,listview,header这三者的耦合度是不是有点太高了

另外,关于icon使用margintop来更新是否会重复导致measure和layout的问题,在我的测试打印日志里面没有发生。

//更正:

另外,关于icon使用margintop来更新是否会重复导致measure和layout的问题,在我的测试打印日志里面没有发生。

这个有误,在setAdapter后发现采用relativelayout的话在不断的改变margin时会导致多次测量(如果布局复杂,将会导致测量时间较长,在视觉上表现为掉帧),现改正布局根节点为FrameLayout,多次测量消失。

//更正结束

关于这个问题,待我查查官方资料,以及思考一下,在下篇讨论一下。

版权声明:部分文章、图片等内容为用户发布或互联网整理而来,仅供学习参考。如有侵犯您的版权,请联系我们,将立刻删除。
点击这里给我发消息