# czl0325/ZLCollectionView

为应对类似淘宝首页，京东首页，国美首页等复杂布局而写的Collectionview。基于UICollectionView实现，目前支持标签布局，列布局，百分比布局，定位布局，填充式布局，瀑布流布局等。支持纵向布局和横向布局，可以根据不同的section设置不同的布局，支持拖动cell，头部悬浮，设置section背景色和自定义section背景view，向自定义背景view传递自定义方法。功能强大，超过Android的recyclerview，实现了电影选座等高难度的布局。

Repository: https://github.com/czl0325/ZLCollectionView
Canonical: https://ross.abutalabs.com/products/zlcollectionview
Language: Objective-C
License: MIT
License Family: permissive
Topics: collectionview, collectionviewcell, collectionviewflowlayout, layout
Last push: 2023-05-09T02:46:51+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3358, "days_push": 1212, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1158, forks 170 (observed 2026-08-28T04:03:48.476113+00:00)

## What it is
An Objective-C library providing multiple UICollectionView layout types (tag, column, percentage, absolute-position, fill, waterfall) for building complex e-commerce-style pages on iOS. It supports per-section layouts, vertical and horizontal scrolling, cell dragging, floating headers, and custom section backgrounds.

## Use cases
- build a complex homepage layout like Taobao or JD in iOS
- implement waterfall flow layout in UICollectionView
- create a movie seat selection grid in iOS
- drag and reorder collection view cells
- make collection view section headers float when scrolling
- set different layouts per section in one collection view
- add custom background views to collection view sections

## When to choose
- building iOS apps with complex mixed-section collection layouts
- needing waterfall, tag, or fill layouts beyond stock UICollectionViewFlowLayout
- wanting drag-to-reorder and sticky headers with minimal configuration

## When to avoid
- developing for Android or cross-platform frameworks
- using Swift-only or SwiftUI architectures where an Objective-C flow layout is awkward
- needing simple standard list or grid layouts already covered by UIKit

## Facets
- artifact type: library
- maturity: maintenance
- function: ui-components, animation
- domain: mobile-development, frontend, cross-platform
- platform: -
- tags: uicollectionview, objective-c, layout, waterfall-layout, cocoapods, ios, mobile

## Member repositories
- czl0325/ZLCollectionView (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:48.476113+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:31:56.882986+00:00, confidence not recorded.
  - readme: https://github.com/czl0325/ZLCollectionView (fetched 2026-08-28T04:03:48.476113+00:00, sha 92da0a22ae90)
- Data as of 2026-08-30T08:39:29.467469+00:00.