Android RecyclerView多视图类型实现遇阻：按year字段展示头部与行

你遇到的问题核心是没有正确处理数据源与视图类型的映射——直接用原列表的位置判断视图类型，无法插入额外的头部视图。下面是一套可行的实现方案：

步骤1：定义视图类型与头部数据类 #

先明确两种视图的类型标识，再创建专门的头部数据类来存储年份信息：

// 视图类型常量
private static final int TYPE_HEADER = 0;
private static final int TYPE_ITEM = 1;

// 头部数据类
public static class YearHeader {
    String year;
    public YearHeader(String year) {
        this.year = year;
    }
}

步骤2：预处理数据源 #

遍历原列表，将头部视图对应的YearHeader对象插入到每个新年份的开头，生成包含头部和列表项的混合数据源：

List<Object> mMixedData = new ArrayList<>();
String lastYear = null;

// 假设原列表为List<YourData> originalList，YourData包含year字段
for (YourData data : originalList) {
    String currentYear = data.year;
    // 首次遍历或年份变化时，插入头部
    if (lastYear == null || !currentYear.equals(lastYear)) {
        mMixedData.add(new YearHeader(currentYear));
        lastYear = currentYear;
    }
    // 添加当前列表项
    mMixedData.add(data);
}

步骤3：实现Adapter核心方法 #

在Adapter中通过getItemViewType区分视图类型，创建对应的ViewHolder并绑定数据：

public class YearGroupAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {

    private List<Object> mMixedData;

    public YearGroupAdapter(List<YourData> originalList) {
        // 初始化时完成数据源预处理
        mMixedData = new ArrayList<>();
        String lastYear = null;
        for (YourData data : originalList) {
            String currentYear = data.year;
            if (lastYear == null || !currentYear.equals(lastYear)) {
                mMixedData.add(new YearHeader(currentYear));
                lastYear = currentYear;
            }
            mMixedData.add(data);
        }
    }

    @Override
    public int getItemViewType(int position) {
        // 根据当前位置的对象类型返回视图类型
        return mMixedData.get(position) instanceof YearHeader ? TYPE_HEADER : TYPE_ITEM;
    }

    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        LayoutInflater inflater = LayoutInflater.from(parent.getContext());
        if (viewType == TYPE_HEADER) {
            // 加载头部布局view1
            View headerView = inflater.inflate(R.layout.layout_year_header, parent, false);
            return new HeaderViewHolder(headerView);
        } else {
            // 加载列表项布局view2
            View itemView = inflater.inflate(R.layout.layout_data_item, parent, false);
            return new ItemViewHolder(itemView);
        }
    }

    @Override
    public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
        if (holder instanceof HeaderViewHolder) {
            // 绑定头部数据
            YearHeader header = (YearHeader) mMixedData.get(position);
            ((HeaderViewHolder) holder).tvYear.setText(header.year);
        } else if (holder instanceof ItemViewHolder) {
            // 绑定列表项数据
            YourData data = (YourData) mMixedData.get(position);
            ((ItemViewHolder) holder).tvContent.setText(data.content);
            // 绑定其他字段...
        }
    }

    @Override
    public int getItemCount() {
        return mMixedData.size();
    }

    // 头部ViewHolder
    static class HeaderViewHolder extends RecyclerView.ViewHolder {
        TextView tvYear;
        public HeaderViewHolder(View itemView) {
            super(itemView);
            tvYear = itemView.findViewById(R.id.tv_year_header);
        }
    }

    // 列表项ViewHolder
    static class ItemViewHolder extends RecyclerView.ViewHolder {
        TextView tvContent;
        public ItemViewHolder(View itemView) {
            super(itemView);
            tvContent = itemView.findViewById(R.id.tv_item_content);
        }
    }
}

关键注意点 #

• 不要直接在原列表的位置上判断视图类型，必须通过扩展数据源的方式插入头部视图，否则RecyclerView无法识别额外的视图位置
• 预处理数据源时要处理第一个元素无前置年份的边界情况
• 确保getItemViewType返回的类型与onCreateViewHolder中创建的布局一一对应

内容的提问来源于stack exchange，提问作者Aniket Dhanrao