Android GridView 分組顯示圖片：StickyGridHeaders 庫實現 QQ 空間相冊效果

需求分析

類似 QQ 空間相冊列表：按時間/相冊分組，組頭懸浮固定，組內圖片網格滾動。

推薦方案：StickyGridHeaders (成熟開源庫)

GitHub: TonicArtos/StickyGridHeaders

核心實現步驟

1. 依賴引入

// build.gradle
implementation 'com.tonicartos:stickygridheaders:1.0.1'

2. 數據模型

public class Photo {
    public String path;
    public long dateTaken; // 用於分組
}

public class PhotoGroup {
    public String headerTitle; // 如 "2024年1月"
    public List photos;
}

3. 適配器實現 StickyGridHeadersBaseAdapter

public class PhotoAdapter extends BaseAdapter 
        implements StickyGridHeadersBaseAdapter {

    private List groups;

    @Override public int getCount() {
        return groups.stream().mapToInt(g -> g.photos.size()).sum();
    }

    @Override public Object getItem(int position) { /* 扁平化索引轉換 */ }
    @Override public long getItemId(int position) { return position; }

    @Override public View getView(int position, View convertView, ViewGroup parent) {
        // 普通 GridView 邏輯：加載圖片
    }

    // StickyGridHeaders 必須實現
    @Override public int getCountForHeader(int header) {
        return groups.get(header).photos.size();
    }

    @Override public int getNumHeaders() {
        return groups.size();
    }

    @Override public View getHeaderView(int header, View convertView, ViewGroup parent) {
        // 返回組頭 View (TextView 顯示 groups.get(header).headerTitle)
    }

    @Override public long getHeaderId(int header) {
        return header; // 穩定 ID
    }
}

4. 佈局文件

<com.tonicartos.widget.stickygridheaders.StickyGridHeadersGridView
    xmlns:android="https://schemas.android.com/apk/res/android"
    android:id="@+id/grid"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:numColumns="3"
    android:verticalSpacing="4dp"
    android:horizontalSpacing="4dp" />

5. Activity 綁定

StickyGridHeadersGridView grid = findViewById(R.id.grid);
PhotoAdapter adapter = new PhotoAdapter(groups);
grid.setAdapter(adapter);

進階：動態分組邏輯 (按月份自動分組)

public List groupPhotosByMonth(List allPhotos) {
    Map> map = new LinkedHashMap<>(); // 保持順序
    SimpleDateFormat sdf = new SimpleDateFormat("yyyy年MM月", Locale.CHINA);
    for (Photo p : allPhotos) {
        String key = sdf.format(new Date(p.dateTaken));
        map.computeIfAbsent(key, k -> new ArrayList<>()).add(p);
    }
    List groups = new ArrayList<>();
    for (Map.Entry> e : map.entrySet()) {
        PhotoGroup g = new PhotoGroup();
        g.headerTitle = e.getKey();
        g.photos = e.getValue();
        groups.add(g);
    }
    return groups;
}

替代方案對比

遷移建議

新項目**優先用 RecyclerView + SectionedRecyclerViewAdapter** 實現分組列表，GridView 已進入維護模式。StickyGridHeaders 適合快速修舊專案。