IT博客汇
  • 首页
  • 精华
  • 技术
  • 设计
  • 资讯
  • 扯淡
  • 权利声明
  • 登录 注册

    [原]Android开源项目QuickReturnHeader分析

    grumoon发表于 2014-09-06 16:06:40
    love 0

    最近项目开发,碰到一个ListView的需求。

    向上滑动,隐藏Header。向下滑动,迅速显示Header。

    在GitHub中,找到了QuickReturnHeader项目,虽然最终因为我们的特殊需求,没有采用这个开源项目,但觉得这个项目不错,就对其进行了分析。

    项目地址:https://github.com/ManuelPeinado/QuickReturnHeader

    项目的使用方式很简单,下载master工程下来,将library目录倒入到eclipse中(我用的eclipse),其他项目使用的使用,作为library引用即可。

    使用方式如下:

    这是本项目中的给出的例子:



    在要使用的的Activity中onCreate方法中

    QuickReturnHeaderHelper helper = new QuickReturnHeaderHelper(this, R.layout.activity_listview, R.layout.header);
    View view = helper.createView();
    setContentView(view);

    R.layout.activity_listview 就是我们的ListView布局,代码如下,

    项目中使用了系统默认的ListView的id:@android:id/list。并且在QuickReturnHeader源码中,固定的使用了这个id。这应该是项目需要改进的地方。

    
    

    R.layout.header 就是我们的header布局文件,下面是例子中的布局文件

    
    
        
    
            
    
            
    
            
    
            
        
    
        
    
    

    以上就是,这个开源项目的使用,很简单。下面就实现的的原理,进行分析。

    简单总结就是一句话,QuickRetrunHeaderHelper,将我们的ListView布局和Header布局,放在了一个FrameLayout中。同时为ListView提供一个Header布局同样高度的空白的ListViewHeader。

    用一张图来说明




    下面是开源库中的关键代码:

    构造函数:

    public QuickReturnHeaderHelper(Context context, int contentResId, int headerResId) {
            this.context = context;
            this.contentResId = contentResId;
            this.headerResId = headerResId;
        }

    createView方法:

    public View createView() {
            inflater = LayoutInflater.from(context);
            content = inflater.inflate(contentResId, null);
    
            realHeader = inflater.inflate(headerResId, null);
            realHeaderLayoutParams = new FrameLayout.LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT);
            realHeaderLayoutParams.gravity = Gravity.TOP;
    
            // Use measured height here as an estimate of the header height, later on after the layout is complete 
            // we'll use the actual height
            int widthMeasureSpec = MeasureSpec.makeMeasureSpec(LayoutParams.MATCH_PARENT, MeasureSpec.EXACTLY);
            int heightMeasureSpec = MeasureSpec.makeMeasureSpec(LayoutParams.WRAP_CONTENT, MeasureSpec.EXACTLY);
            realHeader.measure(widthMeasureSpec, heightMeasureSpec);
            headerHeight = realHeader.getMeasuredHeight();
    
            listView = (ListView) content.findViewById(android.R.id.list);
            if (listView != null) {
                createListView();
            } else {
                createScrollView();
            }
            return root;
        }

    createListView方法(此开源库同样适用于ScrollView,通过createScrollView创建,代码类似):

    private void createListView() {
            root = (FrameLayout) inflater.inflate(R.layout.qrh__listview_container, null);
            root.addView(content);
    
            listView.getViewTreeObserver().addOnGlobalLayoutListener(this);
            ListViewScrollObserver observer = new ListViewScrollObserver(listView);
            //        listView.setOnScrollListener(this);
            observer.setOnScrollUpAndDownListener(new OnListViewScrollListener() {
                @Override
                public void onScrollUpDownChanged(int delta, int scrollPosition, boolean exact) {
                    onNewScroll(delta);
                    snap(headerTop == scrollPosition);
                }
    
                @Override
                public void onScrollIdle() {
                    QuickReturnHeaderHelper.this.onScrollIdle();
                }
            });
    
            root.addView(realHeader, realHeaderLayoutParams);
    
            dummyHeader = new View(context);
            AbsListView.LayoutParams params = new AbsListView.LayoutParams(LayoutParams.MATCH_PARENT, headerHeight);
            dummyHeader.setLayoutParams(params);
            listView.addHeaderView(dummyHeader);
        }


    添加好布局以后,监听ListView的onScroll,向上滑动就逐渐隐藏我们自定义的Header,向下滑动就将Header显示出来。


    以上就是全部分析了,大家看了源码,估计很快就能明白。

    我认为项目可能还有很多改进的地方,也不一定适合大家的需求,(好多时候我们自定义的ListView,已经使用了ListView的HeadView,这样再增加空白HeadView就不合适了)

    但项目提供了一种可以借鉴的思路,相信再很多时候还是很有用的。





沪ICP备19023445号-2号
友情链接