Anroid ListView分组和悬浮Header实现方法

之前在使用iOS时,看到过一种分组的View,每一组都有一个Header,在上下滑动的时候,会有一个悬浮的Header,这种体验觉得很不错,请看下图:

上图中标红的1,2,3,4四张图中,当向上滑动时,仔细观察灰色条的Header变化,当第二组向上滑动时,会把第一组的悬浮Header挤上去。

这种效果在Android是没有的,iOS的SDK就自带这种效果。这篇文章就介绍如何在Android实现这种效果。

1、悬浮Header的实现

其实Android自带的联系人的App中就有这样的效果,我也是把他的类直接拿过来的,实现了PinnedHeaderListView这么一个类,扩展于ListView,核心原理就是在ListView的最顶部绘制一个调用者设置的Header View,在滑动的时候,根据一些状态来决定是否向上或向下移动Header View(其实就是调用其layout方法,理论上在绘制那里作一些平移也是可以的)。下面说一下具体的实现:

1.1、PinnedHeaderAdapter接口

这个接口需要ListView的Adapter来实现,它定义了两个方法,一个是让Adapter告诉ListView当前指定的position的数据的状态,比如指定position的数据可能是组的header;另一个方法就是设置Header View,比如设置Header View的文本,图片等,这个方法是由调用者去实现的。

/** 
 * Adapter interface. The list adapter must implement this interface. 
 */ 
public interface PinnedHeaderAdapter { 
 
  /** 
   * Pinned header state: don't show the header. 
   */ 
  public static final int PINNED_HEADER_GONE = 0; 
 
  /** 
   * Pinned header state: show the header at the top of the list. 
   */ 
  public static final int PINNED_HEADER_VISIBLE = 1; 
 
  /** 
   * Pinned header state: show the header. If the header extends beyond 
   * the bottom of the first shown element, push it up and clip. 
   */ 
  public static final int PINNED_HEADER_PUSHED_UP = 2; 
 
  /** 
   * Computes the desired state of the pinned header for the given 
   * position of the first visible list item. Allowed return values are 
   * {@link #PINNED_HEADER_GONE}, {@link #PINNED_HEADER_VISIBLE} or 
   * {@link #PINNED_HEADER_PUSHED_UP}. 
   */ 
  int getPinnedHeaderState(int position); 
 
  /** 
   * Configures the pinned header view to match the first visible list item. 
   * 
   * @param header pinned header view. 
   * @param position position of the first visible list item. 
   * @param alpha fading of the header view, between 0 and 255. 
   */ 
  void configurePinnedHeader(View header, int position, int alpha); 
} 

1.2、如何绘制Header View

这是在dispatchDraw方法中绘制的:

@Override 
protected void dispatchDraw(Canvas canvas) { 
  super.dispatchDraw(canvas); 
  if (mHeaderViewVisible) { 
    drawChild(canvas, mHeaderView, getDrawingTime()); 
  } 
} 

1.3、配置Header View

核心就是根据不同的状态值来控制Header View的状态,比如PINNED_HEADER_GONE(隐藏)的情况,可能需要设置一个flag标记,不绘制Header View,那么就达到隐藏的效果。当PINNED_HEADER_PUSHED_UP状态时,可能需要根据不同的位移来计算Header View的移动位移。下面是具体的实现:

public void configureHeaderView(int position) { 
  if (mHeaderView == null || null == mAdapter) { 
    return; 
  } 
   
  int state = mAdapter.getPinnedHeaderState(position); 
  switch (state) { 
    case PinnedHeaderAdapter.PINNED_HEADER_GONE: { 
      mHeaderViewVisible = false; 
      break; 
    } 
 
    case PinnedHeaderAdapter.PINNED_HEADER_VISIBLE: { 
      mAdapter.configurePinnedHeader(mHeaderView, position, MAX_ALPHA); 
      if (mHeaderView.getTop() != 0) { 
        mHeaderView.layout(0, 0, mHeaderViewWidth, mHeaderViewHeight); 
      } 
      mHeaderViewVisible = true; 
      break; 
    } 
 
    case PinnedHeaderAdapter.PINNED_HEADER_PUSHED_UP: { 
      View firstView = getChildAt(0); 
      int bottom = firstView.getBottom(); 
       int itemHeight = firstView.getHeight(); 
      int headerHeight = mHeaderView.getHeight(); 
      int y; 
      int alpha; 
      if (bottom < headerHeight) { 
        y = (bottom - headerHeight); 
        alpha = MAX_ALPHA * (headerHeight + y) / headerHeight; 
      } else { 
        y = 0; 
        alpha = MAX_ALPHA; 
      } 
      mAdapter.configurePinnedHeader(mHeaderView, position, alpha); 
      if (mHeaderView.getTop() != y) { 
        mHeaderView.layout(0, y, mHeaderViewWidth, mHeaderViewHeight + y); 
      } 
      mHeaderViewVisible = true; 
      break; 
    } 
  } 
} 

1.4、onLayout和onMeasure

在这两个方法中,控制Header View的位置及大小

@Override 
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) { 
  super.onMeasure(widthMeasureSpec, heightMeasureSpec); 
  if (mHeaderView != null) { 
    measureChild(mHeaderView, widthMeasureSpec, heightMeasureSpec); 
    mHeaderViewWidth = mHeaderView.getMeasuredWidth(); 
    mHeaderViewHeight = mHeaderView.getMeasuredHeight(); 
  } 
} 
 
@Override 
protected void onLayout(boolean changed, int left, int top, int right, int bottom) { 
  super.onLayout(changed, left, top, right, bottom); 
  if (mHeaderView != null) { 
    mHeaderView.layout(0, 0, mHeaderViewWidth, mHeaderViewHeight); 
    configureHeaderView(getFirstVisiblePosition()); 
  } 
} 

好了,到这里,悬浮Header View就完了,各位可能看不到完整的代码,只要明白这几个核心的方法,自己写出来,也差不多了。

2、ListView Section实现

有两种方法实现ListView Section效果:

方法一:

每一个ItemView中包含Header,通过数据来控制其显示或隐藏,实现原理如下图:

优点:

1,实现简单,在Adapter.getView的实现中,只需要根据数据来判断是否是header,不是的话,隐藏Item view中的header部分,否则显示。

2,Adapter.getItem(int n)始终返回的数据是在数据列表中对应的第n个数据,这样容易理解。

3,控制header的点击事件更加容易

缺点:
1、使用更多的内存,第一个Item view中都包含一个header view,这样会费更多的内存,多数时候都可能header都是隐藏的。

方法二:

使用不同类型的View:重写getItemViewType(int)和getViewTypeCount()方法。

优点:

1,允许多个不同类型的item

2,理解更加简单

缺点:

1,实现比较复杂

2,得到指定位置的数据变得复杂一些

到这里,我的实现方式是选择第二种方案,尽管它的实现方式要复杂一些,但优点比较明显。

3、Adapter的实现

这里主要就是说一下getPinnedHeaderState和configurePinnedHeader这两个方法的实现

private class ListViewAdapter extends BaseAdapter implements PinnedHeaderAdapter { 
   
  private ArrayList<Contact> mDatas; 
  private static final int TYPE_CATEGORY_ITEM = 0;  
  private static final int TYPE_ITEM = 1;  
   
  public ListViewAdapter(ArrayList<Contact> datas) { 
    mDatas = datas; 
  } 
   
  @Override 
  public boolean areAllItemsEnabled() { 
    return false; 
  } 
   
  @Override 
  public boolean isEnabled(int position) { 
    // 异常情况处理  
    if (null == mDatas || position < 0|| position > getCount()) { 
      return true; 
    }  
     
    Contact item = mDatas.get(position); 
    if (item.isSection) { 
      return false; 
    } 
     
    return true; 
  } 
   
  @Override 
  public int getCount() { 
    return mDatas.size(); 
  } 
   
  @Override 
  public int getItemViewType(int position) { 
    // 异常情况处理  
    if (null == mDatas || position < 0|| position > getCount()) { 
      return TYPE_ITEM; 
    }  
     
    Contact item = mDatas.get(position); 
    if (item.isSection) { 
      return TYPE_CATEGORY_ITEM; 
    } 
     
    return TYPE_ITEM; 
  } 
 
  @Override 
  public int getViewTypeCount() { 
    return 2; 
  } 
 
  @Override 
  public Object getItem(int position) { 
    return (position >= 0 && position < mDatas.size()) ? mDatas.get(position) : 0; 
  } 
 
  @Override 
  public long getItemId(int position) { 
    return 0; 
  } 
 
  @Override 
  public View getView(int position, View convertView, ViewGroup parent) { 
    int itemViewType = getItemViewType(position); 
    Contact data = (Contact) getItem(position); 
    TextView itemView; 
     
    switch (itemViewType) { 
    case TYPE_ITEM: 
      if (null == convertView) { 
        itemView = new TextView(SectionListView.this); 
        itemView.setLayoutParams(new AbsListView.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, 
            mItemHeight)); 
        itemView.setTextSize(16); 
        itemView.setPadding(10, 0, 0, 0); 
        itemView.setGravity(Gravity.CENTER_VERTICAL); 
        //itemView.setBackgroundColor(Color.argb(255, 20, 20, 20)); 
        convertView = itemView; 
      } 
       
      itemView = (TextView) convertView; 
      itemView.setText(data.toString()); 
      break; 
       
    case TYPE_CATEGORY_ITEM: 
      if (null == convertView) { 
        convertView = getHeaderView(); 
      } 
      itemView = (TextView) convertView; 
      itemView.setText(data.toString()); 
      break; 
    } 
     
    return convertView; 
  } 
 
  @Override 
  public int getPinnedHeaderState(int position) { 
    if (position < 0) { 
      return PINNED_HEADER_GONE; 
    } 
     
    Contact item = (Contact) getItem(position); 
    Contact itemNext = (Contact) getItem(position + 1); 
    boolean isSection = item.isSection; 
    boolean isNextSection = (null != itemNext) ? itemNext.isSection : false; 
    if (!isSection && isNextSection) { 
      return PINNED_HEADER_PUSHED_UP; 
    } 
     
    return PINNED_HEADER_VISIBLE; 
  } 
 
  @Override 
  public void configurePinnedHeader(View header, int position, int alpha) { 
    Contact item = (Contact) getItem(position); 
    if (null != item) { 
      if (header instanceof TextView) { 
        ((TextView) header).setText(item.sectionStr); 
      } 
    } 
  } 
} 

在getPinnedHeaderState方法中,如果第一个item不是section,第二个item是section的话,就返回状态PINNED_HEADER_PUSHED_UP,否则返回PINNED_HEADER_VISIBLE。
在configurePinnedHeader方法中,就是将item的section字符串设置到header view上面去。

【重要说明】

Adapter中的数据里面已经包含了section(header)的数据,数据结构中有一个方法来标识它是否是section。那么,在点击事件就要注意了,通过position可能返回的是section数据结构。

数据结构Contact的定义如下:

public class Contact { 
  int id; 
  String name; 
  String pinyin; 
  String sortLetter = "#"; 
  String sectionStr; 
  String phoneNumber; 
  boolean isSection; 
  static CharacterParser sParser = CharacterParser.getInstance(); 
   
  Contact() { 
     
  } 
   
  Contact(int id, String name) { 
    this.id = id; 
    this.name = name; 
    this.pinyin = sParser.getSpelling(name); 
    if (!TextUtils.isEmpty(pinyin)) { 
      String sortString = this.pinyin.substring(0, 1).toUpperCase(); 
      if (sortString.matches("[A-Z]")) { 
        this.sortLetter = sortString.toUpperCase(); 
      } else { 
        this.sortLetter = "#"; 
      } 
    } 
  } 
   
  @Override 
  public String toString() { 
    if (isSection) { 
      return name; 
    } else { 
      //return name + " (" + sortLetter + ", " + pinyin + ")"; 
      return name + " (" + phoneNumber + ")"; 
    } 
  } 
}  

完整的代码

package com.lee.sdk.test.section; 
 
import java.util.ArrayList; 
 
import android.graphics.Color; 
import android.os.Bundle; 
import android.view.Gravity; 
import android.view.View; 
import android.view.ViewGroup; 
import android.widget.AbsListView; 
import android.widget.AdapterView; 
import android.widget.AdapterView.OnItemClickListener; 
import android.widget.BaseAdapter; 
import android.widget.TextView; 
import android.widget.Toast; 
 
import com.lee.sdk.test.GABaseActivity; 
import com.lee.sdk.test.R; 
import com.lee.sdk.widget.PinnedHeaderListView; 
import com.lee.sdk.widget.PinnedHeaderListView.PinnedHeaderAdapter; 
 
public class SectionListView extends GABaseActivity { 
 
  private int mItemHeight = 55; 
  private int mSecHeight = 25; 
   
  @Override 
  protected void onCreate(Bundle savedInstanceState) { 
    super.onCreate(savedInstanceState); 
    setContentView(R.layout.activity_main); 
     
    float density = getResources().getDisplayMetrics().density; 
    mItemHeight = (int) (density * mItemHeight); 
    mSecHeight = (int) (density * mSecHeight); 
     
    PinnedHeaderListView mListView = new PinnedHeaderListView(this); 
    mListView.setAdapter(new ListViewAdapter(ContactLoader.getInstance().getContacts(this))); 
    mListView.setPinnedHeaderView(getHeaderView()); 
    mListView.setBackgroundColor(Color.argb(255, 20, 20, 20)); 
    mListView.setOnItemClickListener(new OnItemClickListener() { 
      @Override 
      public void onItemClick(AdapterView<?> parent, View view, int position, long id) { 
        ListViewAdapter adapter = ((ListViewAdapter) parent.getAdapter()); 
        Contact data = (Contact) adapter.getItem(position); 
        Toast.makeText(SectionListView.this, data.toString(), Toast.LENGTH_SHORT).show(); 
      } 
    }); 
 
    setContentView(mListView); 
  } 
   
  private View getHeaderView() { 
    TextView itemView = new TextView(SectionListView.this); 
    itemView.setLayoutParams(new AbsListView.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, 
        mSecHeight)); 
    itemView.setGravity(Gravity.CENTER_VERTICAL); 
    itemView.setBackgroundColor(Color.WHITE); 
    itemView.setTextSize(20); 
    itemView.setTextColor(Color.GRAY); 
    itemView.setBackgroundResource(R.drawable.section_listview_header_bg); 
    itemView.setPadding(10, 0, 0, itemView.getPaddingBottom()); 
     
    return itemView; 
  } 
 
  private class ListViewAdapter extends BaseAdapter implements PinnedHeaderAdapter { 
     
    private ArrayList<Contact> mDatas; 
    private static final int TYPE_CATEGORY_ITEM = 0;  
    private static final int TYPE_ITEM = 1;  
     
    public ListViewAdapter(ArrayList<Contact> datas) { 
      mDatas = datas; 
    } 
     
    @Override 
    public boolean areAllItemsEnabled() { 
      return false; 
    } 
     
    @Override 
    public boolean isEnabled(int position) { 
      // 异常情况处理  
      if (null == mDatas || position < 0|| position > getCount()) { 
        return true; 
      }  
       
      Contact item = mDatas.get(position); 
      if (item.isSection) { 
        return false; 
      } 
       
      return true; 
    } 
     
    @Override 
    public int getCount() { 
      return mDatas.size(); 
    } 
     
    @Override 
    public int getItemViewType(int position) { 
      // 异常情况处理  
      if (null == mDatas || position < 0|| position > getCount()) { 
        return TYPE_ITEM; 
      }  
       
      Contact item = mDatas.get(position); 
      if (item.isSection) { 
        return TYPE_CATEGORY_ITEM; 
      } 
       
      return TYPE_ITEM; 
    } 
 
    @Override 
    public int getViewTypeCount() { 
      return 2; 
    } 
 
    @Override 
    public Object getItem(int position) { 
      return (position >= 0 && position < mDatas.size()) ? mDatas.get(position) : 0; 
    } 
 
    @Override 
    public long getItemId(int position) { 
      return 0; 
    } 
 
    @Override 
    public View getView(int position, View convertView, ViewGroup parent) { 
      int itemViewType = getItemViewType(position); 
      Contact data = (Contact) getItem(position); 
      TextView itemView; 
       
      switch (itemViewType) { 
      case TYPE_ITEM: 
        if (null == convertView) { 
          itemView = new TextView(SectionListView.this); 
          itemView.setLayoutParams(new AbsListView.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, 
              mItemHeight)); 
          itemView.setTextSize(16); 
          itemView.setPadding(10, 0, 0, 0); 
          itemView.setGravity(Gravity.CENTER_VERTICAL); 
          //itemView.setBackgroundColor(Color.argb(255, 20, 20, 20)); 
          convertView = itemView; 
        } 
         
        itemView = (TextView) convertView; 
        itemView.setText(data.toString()); 
        break; 
         
      case TYPE_CATEGORY_ITEM: 
        if (null == convertView) { 
          convertView = getHeaderView(); 
        } 
        itemView = (TextView) convertView; 
        itemView.setText(data.toString()); 
        break; 
      } 
       
      return convertView; 
    } 
 
    @Override 
    public int getPinnedHeaderState(int position) { 
      if (position < 0) { 
        return PINNED_HEADER_GONE; 
      } 
       
      Contact item = (Contact) getItem(position); 
      Contact itemNext = (Contact) getItem(position + 1); 
      boolean isSection = item.isSection; 
      boolean isNextSection = (null != itemNext) ? itemNext.isSection : false; 
      if (!isSection && isNextSection) { 
        return PINNED_HEADER_PUSHED_UP; 
      } 
       
      return PINNED_HEADER_VISIBLE; 
    } 
 
    @Override 
    public void configurePinnedHeader(View header, int position, int alpha) { 
      Contact item = (Contact) getItem(position); 
      if (null != item) { 
        if (header instanceof TextView) { 
          ((TextView) header).setText(item.sectionStr); 
        } 
      } 
    } 
  } 
} 

最后来一张截图:
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持呐喊教程。

声明:本文内容来源于网络,版权归原作者所有,内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎发送邮件至:notice#nhooo.com(发邮件时,请将#更换为@)进行举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。