2019-12-19 17:32:49 +00:00
|
|
|
/*
|
2023-04-06 09:44:16 +00:00
|
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
2019-12-19 17:32:49 +00:00
|
|
|
*
|
|
|
|
|
* This source code is licensed under the MIT license found in the
|
|
|
|
|
* LICENSE file in the root directory of this source tree.
|
2016-09-07 22:37:59 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
import IGListKit
|
2018-01-22 20:01:53 +00:00
|
|
|
import UIKit
|
2016-09-07 22:37:59 +00:00
|
|
|
|
Swift name annotations
Summary:
This adds `NS_SWIFT_NAME` annotations to all public API's to provide cleaner integration into Swift:
- Removes the need to prefix classes in Swift code, instead rely on Swift module name spacing
- Adds more argument labels to C function API's like `IGListDiff([], [], .equality)` => `ListDiff(oldArray: [], newArray: [], option: .equality)`
While this is a large API change it should be as easy as:
- Find and replace `(IGList)([^K])` to `List$2` in Xcode with a scope set to Swift
- Build and follow compiler's auto fix corrections for C API's or any missed renames
I have not updated the documentation to reflect this yet, I am totally willing to do so but before I sink that amount of time into it I wanted to see if the Instagram team is even open to this change!
- [x] All tests pass. Demo project builds and runs.
- [x] I added tests, an experiment, or detailed why my change isn't tested.
- [x] I added an entry to the `CHANGELOG.md` for any breaking changes, enhancements, or bug fixes.
- [x] I have reviewed the [contributing guide](https://github.com/Instagram/IGListKit/blob/master/.github/CONTRIBUTING.md)
- [ ] I have updated the documentation
Closes https://github.com/Instagram/IGListKit/pull/593
Reviewed By: jessesquires
Differential Revision: D5028039
Pulled By: rnystrom
fbshipit-source-id: b473d874a1f9574e56b2ebaabd5b73d1b57d4bab
2017-05-09 21:29:52 +00:00
|
|
|
final class DemosViewController: UIViewController, ListAdapterDataSource {
|
2016-09-07 22:37:59 +00:00
|
|
|
|
2023-07-25 16:17:11 +00:00
|
|
|
let horizontalInset = 16.0
|
|
|
|
|
|
Swift name annotations
Summary:
This adds `NS_SWIFT_NAME` annotations to all public API's to provide cleaner integration into Swift:
- Removes the need to prefix classes in Swift code, instead rely on Swift module name spacing
- Adds more argument labels to C function API's like `IGListDiff([], [], .equality)` => `ListDiff(oldArray: [], newArray: [], option: .equality)`
While this is a large API change it should be as easy as:
- Find and replace `(IGList)([^K])` to `List$2` in Xcode with a scope set to Swift
- Build and follow compiler's auto fix corrections for C API's or any missed renames
I have not updated the documentation to reflect this yet, I am totally willing to do so but before I sink that amount of time into it I wanted to see if the Instagram team is even open to this change!
- [x] All tests pass. Demo project builds and runs.
- [x] I added tests, an experiment, or detailed why my change isn't tested.
- [x] I added an entry to the `CHANGELOG.md` for any breaking changes, enhancements, or bug fixes.
- [x] I have reviewed the [contributing guide](https://github.com/Instagram/IGListKit/blob/master/.github/CONTRIBUTING.md)
- [ ] I have updated the documentation
Closes https://github.com/Instagram/IGListKit/pull/593
Reviewed By: jessesquires
Differential Revision: D5028039
Pulled By: rnystrom
fbshipit-source-id: b473d874a1f9574e56b2ebaabd5b73d1b57d4bab
2017-05-09 21:29:52 +00:00
|
|
|
lazy var adapter: ListAdapter = {
|
|
|
|
|
return ListAdapter(updater: ListAdapterUpdater(), viewController: self)
|
2016-09-07 22:37:59 +00:00
|
|
|
}()
|
2017-03-31 21:45:28 +00:00
|
|
|
let collectionView = UICollectionView(frame: .zero, collectionViewLayout: UICollectionViewFlowLayout())
|
2016-09-07 22:37:59 +00:00
|
|
|
|
|
|
|
|
let demos: [DemoItem] = [
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Tail Loading", imageName: "arrow.down.circle",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: LoadMoreViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Search Autocomplete", imageName: "magnifyingglass",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: SearchViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Mixed Data", imageName: "square.fill.text.grid.1x2",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: MixedDataViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Nested Adapter", imageName: "curlybraces",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: NestedAdapterViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Empty View", imageName: "exclamationmark.triangle",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: EmptyViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Single Section Controller", imageName: "1.square",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: SingleSectionViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Storyboard", imageName: "rectangle.on.rectangle",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: SingleSectionViewController.self,
|
|
|
|
|
controllerIdentifier: "demo"),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Single Section Storyboard", imageName: "rectangle",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: SingleSectionStoryboardViewController.self,
|
|
|
|
|
controllerIdentifier: "singleSectionDemo"),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Working Range", imageName: "arrow.left.and.right",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: WorkingRangeViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Diff Algorithm", imageName: "function",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: DiffTableViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Supplementary Views", imageName: "square.stack.3d.up",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: SupplementaryViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Self-sizing cells", imageName: "brain",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: SelfSizingCellsViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Display delegate", imageName: "megaphone",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: DisplayViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Objc Demo", imageName: "c.square",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: ObjcDemoViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Objc Generated Model Demo", imageName: "c.circle",
|
2018-02-09 17:50:18 +00:00
|
|
|
controllerClass: ObjcGeneratedModelDemoViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Calendar (auto diffing)", imageName: "calendar",
|
2017-05-16 14:30:08 +00:00
|
|
|
controllerClass: CalendarViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Dependency Injection", imageName: "syringe",
|
Interactive Reordering
Summary:
I had a desire for interactive reordering in a personal project, so here's a first attempt at adding support in IGListKit.
I figured I might as well get a WIP PR up for comments before I continue further as there are a few aspects to interactive reordering that don't interplay perfectly with IGListKit.
As discussed in #291, I went after two prime use cases:
1. Moving items amongst a section
2. Rearranging whole sections
I also "disabled" moving items between sections by having those moves revert, to mimic interactive reordering cancellation as closely as possible.
You can see both in the Mixed Data example. Grid items can be moved within a section, while users can be moved to reorder whole sections. But trying to move a grid item out of a grid or a user item into a grid will auto-revert. The revert animation isn't as tight as it should be. It may be more desirable to disable the animation - though you lose the visual cue.
There is a also a new example, `ReorderableViewController`, that demonstrates 2 in its pure form (likely the most desired use case), where all sections are reorderable single rows.
Happy to take feedback -- this is my first experience working on IGListKit, so I would expect there to be gaps. (Ex. I haven't used `IGListStackedSectionController`, and its tests failed as I hadn't implemented reordering delegates for it. Those are simply stubbed out for now.)
Issue fixed: #291
- [x] All tests pass. Demo project builds and runs.
- [x] I added tests, an experiment, or detailed why my change isn't tested.
- [x] I added an entry to the `CHANGELOG.md` for any breaking changes, enhancements, or bug fixes.
- [x] I have reviewed the [contributing guide](https://github.com/Instagram/IGListKit/blob/master/.github/CONTRIBUTING.md)
- [x] Proper support in `IGListStackedSectionController`
Closes https://github.com/Instagram/IGListKit/pull/976
Differential Revision: D6674493
Pulled By: rnystrom
fbshipit-source-id: cd53c5fdc6fb59636edc4747c4bbd0f81a4610e5
2018-02-12 17:09:26 +00:00
|
|
|
controllerClass: AnnouncingDepsViewController.self),
|
2023-07-20 05:08:21 +00:00
|
|
|
DemoItem(name: "Reorder Cells", imageName: "arrow.up.and.down.and.arrow.left.and.right",
|
2023-12-19 15:17:30 +00:00
|
|
|
controllerClass: ReorderableViewController.self),
|
|
|
|
|
DemoItem(name: "Compositional Layout", imageName: "square.stack",
|
|
|
|
|
controllerClass: CompositionLayoutViewController.self)
|
2016-09-07 22:37:59 +00:00
|
|
|
]
|
|
|
|
|
|
|
|
|
|
override func viewDidLoad() {
|
|
|
|
|
super.viewDidLoad()
|
2023-07-20 05:08:21 +00:00
|
|
|
title = "IGListKit"
|
|
|
|
|
navigationController?.navigationBar.prefersLargeTitles = true
|
2023-07-20 05:08:21 +00:00
|
|
|
collectionView.alwaysBounceVertical = true
|
2023-07-25 16:17:11 +00:00
|
|
|
collectionView.backgroundColor = .groupedBackground
|
|
|
|
|
collectionView.contentInset = UIEdgeInsets(top: 0, left: horizontalInset, bottom: 0, right: horizontalInset)
|
2016-09-07 22:37:59 +00:00
|
|
|
view.addSubview(collectionView)
|
|
|
|
|
adapter.collectionView = collectionView
|
|
|
|
|
adapter.dataSource = self
|
2023-07-20 05:08:21 +00:00
|
|
|
if splitViewController?.viewControllers.count ?? 0 < 2, let demoItem = demos.first {
|
|
|
|
|
let viewController = demoItem.controllerClass.init()
|
|
|
|
|
viewController.title = demoItem.name
|
|
|
|
|
let navigationController = UINavigationController(rootViewController: viewController)
|
|
|
|
|
navigationController.navigationBar.prefersLargeTitles = true
|
|
|
|
|
splitViewController?.viewControllers.append(navigationController)
|
|
|
|
|
}
|
2016-09-07 22:37:59 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
override func viewDidLayoutSubviews() {
|
|
|
|
|
super.viewDidLayoutSubviews()
|
2023-07-20 05:08:21 +00:00
|
|
|
collectionView.collectionViewLayout.invalidateLayout()
|
2016-09-07 22:37:59 +00:00
|
|
|
collectionView.frame = view.bounds
|
|
|
|
|
}
|
|
|
|
|
|
2023-07-20 05:08:21 +00:00
|
|
|
override func viewWillAppear(_ animated: Bool) {
|
|
|
|
|
super.viewWillAppear(animated)
|
|
|
|
|
|
|
|
|
|
guard let splitViewController = splitViewController else {
|
|
|
|
|
return
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if splitViewController.viewControllers.count > 1 {
|
|
|
|
|
// When on iPad, this view controller is visible all the time, so on initial launch, select the first section
|
|
|
|
|
if let firstSection = adapter.sectionController(forSection: 0) {
|
|
|
|
|
firstSection.collectionContext.selectItem(at: 0, sectionController: firstSection, animated: false, scrollPosition: .top)
|
2023-07-25 16:17:11 +00:00
|
|
|
firstSection.didSelectItem(at: 0)
|
2023-07-20 05:08:21 +00:00
|
|
|
}
|
|
|
|
|
} else {
|
|
|
|
|
// On iPhone, deselect all cells when returning to this view controller (since we'll be coming back from a navigation pop)
|
|
|
|
|
for sectionController in adapter.visibleSectionControllers() {
|
|
|
|
|
sectionController.collectionContext.deselectItem(at: 0, sectionController: sectionController, animated: animated)
|
|
|
|
|
// UIColletionView doesn't call the deselection delegate by design when manually deselected, so manually deselect here
|
|
|
|
|
sectionController.didDeselectItem(at: 0)
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2017-05-16 14:30:08 +00:00
|
|
|
// MARK: ListAdapterDataSource
|
2016-09-07 22:37:59 +00:00
|
|
|
|
Swift name annotations
Summary:
This adds `NS_SWIFT_NAME` annotations to all public API's to provide cleaner integration into Swift:
- Removes the need to prefix classes in Swift code, instead rely on Swift module name spacing
- Adds more argument labels to C function API's like `IGListDiff([], [], .equality)` => `ListDiff(oldArray: [], newArray: [], option: .equality)`
While this is a large API change it should be as easy as:
- Find and replace `(IGList)([^K])` to `List$2` in Xcode with a scope set to Swift
- Build and follow compiler's auto fix corrections for C API's or any missed renames
I have not updated the documentation to reflect this yet, I am totally willing to do so but before I sink that amount of time into it I wanted to see if the Instagram team is even open to this change!
- [x] All tests pass. Demo project builds and runs.
- [x] I added tests, an experiment, or detailed why my change isn't tested.
- [x] I added an entry to the `CHANGELOG.md` for any breaking changes, enhancements, or bug fixes.
- [x] I have reviewed the [contributing guide](https://github.com/Instagram/IGListKit/blob/master/.github/CONTRIBUTING.md)
- [ ] I have updated the documentation
Closes https://github.com/Instagram/IGListKit/pull/593
Reviewed By: jessesquires
Differential Revision: D5028039
Pulled By: rnystrom
fbshipit-source-id: b473d874a1f9574e56b2ebaabd5b73d1b57d4bab
2017-05-09 21:29:52 +00:00
|
|
|
func objects(for listAdapter: ListAdapter) -> [ListDiffable] {
|
2016-09-07 22:37:59 +00:00
|
|
|
return demos
|
|
|
|
|
}
|
|
|
|
|
|
Swift name annotations
Summary:
This adds `NS_SWIFT_NAME` annotations to all public API's to provide cleaner integration into Swift:
- Removes the need to prefix classes in Swift code, instead rely on Swift module name spacing
- Adds more argument labels to C function API's like `IGListDiff([], [], .equality)` => `ListDiff(oldArray: [], newArray: [], option: .equality)`
While this is a large API change it should be as easy as:
- Find and replace `(IGList)([^K])` to `List$2` in Xcode with a scope set to Swift
- Build and follow compiler's auto fix corrections for C API's or any missed renames
I have not updated the documentation to reflect this yet, I am totally willing to do so but before I sink that amount of time into it I wanted to see if the Instagram team is even open to this change!
- [x] All tests pass. Demo project builds and runs.
- [x] I added tests, an experiment, or detailed why my change isn't tested.
- [x] I added an entry to the `CHANGELOG.md` for any breaking changes, enhancements, or bug fixes.
- [x] I have reviewed the [contributing guide](https://github.com/Instagram/IGListKit/blob/master/.github/CONTRIBUTING.md)
- [ ] I have updated the documentation
Closes https://github.com/Instagram/IGListKit/pull/593
Reviewed By: jessesquires
Differential Revision: D5028039
Pulled By: rnystrom
fbshipit-source-id: b473d874a1f9574e56b2ebaabd5b73d1b57d4bab
2017-05-09 21:29:52 +00:00
|
|
|
func listAdapter(_ listAdapter: ListAdapter, sectionControllerFor object: Any) -> ListSectionController {
|
2016-09-07 22:37:59 +00:00
|
|
|
return DemoSectionController()
|
|
|
|
|
}
|
|
|
|
|
|
Swift name annotations
Summary:
This adds `NS_SWIFT_NAME` annotations to all public API's to provide cleaner integration into Swift:
- Removes the need to prefix classes in Swift code, instead rely on Swift module name spacing
- Adds more argument labels to C function API's like `IGListDiff([], [], .equality)` => `ListDiff(oldArray: [], newArray: [], option: .equality)`
While this is a large API change it should be as easy as:
- Find and replace `(IGList)([^K])` to `List$2` in Xcode with a scope set to Swift
- Build and follow compiler's auto fix corrections for C API's or any missed renames
I have not updated the documentation to reflect this yet, I am totally willing to do so but before I sink that amount of time into it I wanted to see if the Instagram team is even open to this change!
- [x] All tests pass. Demo project builds and runs.
- [x] I added tests, an experiment, or detailed why my change isn't tested.
- [x] I added an entry to the `CHANGELOG.md` for any breaking changes, enhancements, or bug fixes.
- [x] I have reviewed the [contributing guide](https://github.com/Instagram/IGListKit/blob/master/.github/CONTRIBUTING.md)
- [ ] I have updated the documentation
Closes https://github.com/Instagram/IGListKit/pull/593
Reviewed By: jessesquires
Differential Revision: D5028039
Pulled By: rnystrom
fbshipit-source-id: b473d874a1f9574e56b2ebaabd5b73d1b57d4bab
2017-05-09 21:29:52 +00:00
|
|
|
func emptyView(for listAdapter: ListAdapter) -> UIView? {
|
2016-09-07 22:37:59 +00:00
|
|
|
return nil
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
}
|