mirror of
https://github.com/Instagram/IGListKit
synced 2026-05-15 05:18:18 +00:00
ce4b851da3
Summary: I started working on adding support for dequeuing cells created from nibs (issue #1). Additionally I extended `IGListSingleSectionController` so that it can be used with nibs too. I don't know if you had this also in mind. - [x] I'm currently thinking about the best way to test these changes. - [x] I was not able to update the documentation (issue #55). - [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 have reviewed the [contributing guide](https://github.com/Instagram/IGListKit/blob/master/CONTRIBUTING.md) Closes https://github.com/Instagram/IGListKit/pull/56 Reviewed By: dshahidehpour Differential Revision: D4023746 Pulled By: rnystrom fbshipit-source-id: 6a8b4cfb4dba38ea6e9870a9a4506288ee155cfe
89 lines
3.6 KiB
Objective-C
89 lines
3.6 KiB
Objective-C
/**
|
|
* Copyright (c) 2016-present, Facebook, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This source code is licensed under the BSD-style license found in the
|
|
* LICENSE file in the root directory of this source tree. An additional grant
|
|
* of patent rights can be found in the PATENTS file in the same directory.
|
|
*/
|
|
|
|
#import <UIKit/UIKit.h>
|
|
|
|
#import <IGListKit/IGListSectionController.h>
|
|
#import <IGListKit/IGListSectionType.h>
|
|
#import <IGListKit/IGListMacros.h>
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
typedef void (^IGListSingleSectionCellConfigureBlock)(id item, __kindof UICollectionViewCell *cell);
|
|
typedef CGSize (^IGListSingleSectionCellSizeBlock)(id<IGListCollectionContext> _Nullable collectionContext);
|
|
|
|
@class IGListSingleSectionController;
|
|
|
|
/**
|
|
A delegate that can receive selection events on an IGListSingleSectionController.
|
|
*/
|
|
@protocol IGListSingleSectionControllerDelegate <NSObject>
|
|
|
|
/**
|
|
Tells the delegate that the section controller was selected.
|
|
|
|
@param sectionController The section controller that was selected.
|
|
*/
|
|
- (void)didSelectSingleSectionController:(IGListSingleSectionController *)sectionController;
|
|
|
|
@end
|
|
|
|
/**
|
|
This section controller is meant to make building simple, single-cell feeds easier. By providing the type of cell, a block
|
|
to configure the cell, and a block to return the size of a cell, you can use an IGListAdapter-powered feed without
|
|
overcomplicating your architecture.
|
|
*/
|
|
IGLK_SUBCLASSING_RESTRICTED
|
|
@interface IGListSingleSectionController : IGListSectionController <IGListSectionType>
|
|
|
|
/**
|
|
Create a new section controller for a given cell type that will always have only one cell when present in a feed.
|
|
|
|
@param cellClass The UICollectionViewCell subclass for the single cell.
|
|
@param configureBlock A block that configures the cell with the item given to the section controller.
|
|
@param sizeBlock A block that returns the size for the cell given the collection context.
|
|
|
|
@return A new section controller.
|
|
|
|
@warning Be VERY CAREFUL not to create retain cycles by holding strong references to: the object that owns the adapter
|
|
(usually "self") or the IGListAdapter. Pass in locally scoped objects or use weak references!
|
|
*/
|
|
- (instancetype)initWithCellClass:(Class)cellClass
|
|
configureBlock:(IGListSingleSectionCellConfigureBlock)configureBlock
|
|
sizeBlock:(IGListSingleSectionCellSizeBlock)sizeBlock;
|
|
|
|
/**
|
|
Create a new section controller for a given nib name and bundle that will always have only one cell when present in a feed.
|
|
|
|
@param nibName The name of the nib file for the single cell.
|
|
@param bundle The bundle in which to search for the nib file. If nil, this method looks for the file in the main bundle.
|
|
@param configureBlock A block that configures the cell with the item given to the section controller.
|
|
@param sizeBlock A block that returns the size for the cell given the collection context.
|
|
|
|
@return A new section controller.
|
|
|
|
@warning Be VERY CAREFUL not to create retain cycles by holding strong references to: the object that owns the adapter
|
|
(usually "self") or the IGListAdapter. Pass in locally scoped objects or use weak references!
|
|
*/
|
|
- (instancetype)initWithNibName:(NSString *)nibName
|
|
bundle:(nullable NSBundle *)bundle
|
|
configureBlock:(IGListSingleSectionCellConfigureBlock)configureBlock
|
|
sizeBlock:(IGListSingleSectionCellSizeBlock)sizeBlock;
|
|
|
|
/**
|
|
An optional delegate that handles selection and deselection.
|
|
*/
|
|
@property (nonatomic, weak, nullable) id<IGListSingleSectionControllerDelegate> selectionDelegate;
|
|
|
|
- (instancetype)init NS_UNAVAILABLE;
|
|
+ (instancetype)new NS_UNAVAILABLE;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|