mirror of
https://github.com/Instagram/IGListKit
synced 2026-05-23 01:08:27 +00:00
2f76e8ce68
Summary: We have observed that keeping the coalescing time here would actually decrease the stability here, it makes the app crash more often. It's probably caused by some race condition during that time and UICV updates become out of sync. Reviewed By: rnystrom Differential Revision: D14379265 fbshipit-source-id: 502c1c14fb8bdfc35969f721687e82888b160110
68 lines
2.4 KiB
Objective-C
68 lines
2.4 KiB
Objective-C
/**
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*/
|
|
|
|
#import <UIKit/UIKit.h>
|
|
|
|
#import <IGListKit/IGListAdapterUpdaterDelegate.h>
|
|
#import <IGListKit/IGListExperiments.h>
|
|
#import <IGListKit/IGListMacros.h>
|
|
#import <IGListKit/IGListUpdatingDelegate.h>
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/**
|
|
An `IGListAdapterUpdater` is a concrete type that conforms to `IGListUpdatingDelegate`.
|
|
It is an out-of-box updater for `IGListAdapter` objects to use.
|
|
|
|
@note This updater performs re-entrant, coalesced updating for a list. It also uses a least-minimal diff
|
|
for calculating UI updates when `IGListAdapter` calls
|
|
`-performUpdateWithCollectionView:fromObjects:toObjects:completion:`.
|
|
*/
|
|
IGLK_SUBCLASSING_RESTRICTED
|
|
NS_SWIFT_NAME(ListAdapterUpdater)
|
|
@interface IGListAdapterUpdater : NSObject <IGListUpdatingDelegate>
|
|
|
|
/**
|
|
The delegate that receives events with data on the performance of a transition.
|
|
*/
|
|
@property (nonatomic, weak) id<IGListAdapterUpdaterDelegate> delegate;
|
|
|
|
/**
|
|
A flag indicating if a move should be treated as a "delete, then insert" operation.
|
|
*/
|
|
@property (nonatomic, assign) BOOL movesAsDeletesInserts;
|
|
|
|
/**
|
|
A flag indicating that section reloads should be treated as item reloads, instead of converting them to "delete, then insert" operations.
|
|
This only applies if the number of items for the section is unchanged.
|
|
|
|
@note If the number of items for the section is changed, we would fallback to the default behavior and convert it to "delete + insert",
|
|
because the collectionView can crash otherwise.
|
|
|
|
Default is NO.
|
|
*/
|
|
@property (nonatomic, assign) BOOL preferItemReloadsForSectionReloads;
|
|
|
|
/**
|
|
A flag indicating whether this updater should skip diffing and simply call
|
|
`reloadData` for updates when the collection view is not in a window. The default value is `YES`.
|
|
|
|
@note This will result in better performance, but will not generate the same delegate
|
|
callbacks. If using a custom layout, it will not receive `prepareForCollectionViewUpdates:`.
|
|
|
|
@warning On iOS < 8.3, this behavior is unsupported and will always be treated as `NO`.
|
|
*/
|
|
@property (nonatomic, assign) BOOL allowsBackgroundReloading;
|
|
|
|
/**
|
|
A bitmask of experiments to conduct on the updater.
|
|
*/
|
|
@property (nonatomic, assign) IGListExperiment experiments;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|