一个数据驱动的UICollectionView
框架,用于构建快速灵活的列表。
主要特性 | |
---|---|
🙅 | 无须直接调用 performBatchUpdates(_:, completion:) 或 reloadData() |
🏠 | 更好的可复用 cell 和组件体系结构 |
🔠 | 创建具有多个数据类型的列表 |
🔑 | 解耦的 Diff 算法 |
✅ | 完全的单元测试 |
🔍 | 可自定义数据模型的 Diff 行为 |
📱 | 简化并维持UICollectionView 的核心特性 |
🚀 | 可扩展的 API 设计 |
🐦 | Objective-C 编写,同时完全支持 Swift |
IGListKit
由 Instagram 工程师 创建 并且❤️ 维护。
我们在 Instagram 中使用开源的main
主版本。
- Xcode 11.0+
- iOS 11.0+
- tvOS 11.0+
- macOS 10.13+ (diffing algorithm components only)
- Interoperability with Swift 3.0+
推荐使用CocoaPods来进行安装,只需添加如下语句到你的Podfile
文件中:
pod 'IGListKit', '~> 5.0.0'
对于Carthage, 添加如下到Cartfile
文件中:
github "Instagram/IGListKit" ~> 5.0.0
对于高级用法, 查阅 安装指南。
$ git clone https://github.com/Instagram/IGListKit.git
$ cd IGListKit/
$ ./scripts/setup.sh
- 入门指南
- Ray Wenderlich's IGListKit Tutorial: Better UICollectionViews
- 样例项目
- Ryan Nystrom's talk at try! Swift NYC (Note: this talk was for an earlier version. Some APIs have changed.)
- Migrating an UITableView to IGListCollectionView, by Rodrigo Cavalcante
- Keeping data fresh in Buffer for iOS with AsyncDisplayKit, IGListKit & Pusher, Andy Yates, Buffer
这里可以查阅文档。文档由jazzy生成,托管在 GitHub-Pages。
运行位于仓库根目录下的./scripts/build_docs.sh
脚本来生成文档。
想要了解IGListKit
的长期目标和愿景,请阅读Vision。
请查看CONTRIBUTING来了解如何参与贡献。在 Instagram,我们每日都会同步开源版本的IGListKit
,因此我们总是在测试最新的改动。但是这也需要所有的改动都需要经历完全的测试,并且遵守我们的开发风格。
我们有一系列新人任务,来帮助新人学习如何参入其中。
IGListKit
遵循MIT-licensed。
/Examples/
目录下的文件,在文档里指明了它们各自所遵循的协议。文档遵循CC-BY-4.0。