mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-11 15:10:37 +00:00
a1061301e0
The optimization seems correct now, but apps like Pinterest have some core code relying on edit operation order that is actually not permitted by UIKit (and this diff) but were tolerated previously. We will re-land this once we have time to adapt the code.
166 lines
6.6 KiB
Objective-C
166 lines
6.6 KiB
Objective-C
/* Copyright (c) 2015-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.
|
|
*/
|
|
|
|
#ifndef ASDataControllerSubclasses_Included
|
|
#define ASDataControllerSubclasses_Included
|
|
|
|
//#import "ASDataController.h"
|
|
|
|
@interface ASDataController (Subclasses)
|
|
|
|
#pragma mark - Internal editing & completed store querying
|
|
@property (nonatomic, strong, readonly) NSMutableDictionary *editingNode;
|
|
|
|
/**
|
|
* Read only access to the underlying completed nodes of the given kind
|
|
*/
|
|
- (NSMutableArray *)completedNodesOfKind:(NSString *)kind;
|
|
|
|
#pragma mark - Node sizing
|
|
|
|
/**
|
|
* Measure and layout the given nodes in optimized batches, constraining each to a given size in `constrainedSizeForNodeOfKind:atIndexPath:`.
|
|
*/
|
|
- (void)layoutAndInsertFromNodeBlocks:(NSArray<ASCellNodeBlock> *)nodes ofKind:(NSString *)kind atIndexPaths:(NSArray<NSIndexPath *> *)indexPaths completion:(void (^)(NSArray<ASCellNode *> *nodes, NSArray<NSIndexPath *> *indexPaths))completionBlock;
|
|
|
|
/*
|
|
* Perform measurement and layout of loaded nodes on the main thread, skipping unloaded nodes.
|
|
*
|
|
* @discussion Once nodes have loaded their views, we can't layout in the background so this is a chance
|
|
* to do so immediately on the main thread.
|
|
*/
|
|
- (void)layoutLoadedNodes:(NSArray *)nodes ofKind:(NSString *)kind atIndexPaths:(NSArray *)indexPaths;
|
|
|
|
/**
|
|
* Provides the size range for a specific node during the layout process.
|
|
*/
|
|
- (ASSizeRange)constrainedSizeForNodeOfKind:(NSString *)kind atIndexPath:(NSIndexPath *)indexPath;
|
|
|
|
#pragma mark - Node & Section Insertion/Deletion API
|
|
|
|
/**
|
|
* Inserts the given nodes of the specified kind into the backing store.
|
|
*/
|
|
- (void)insertNodes:(NSArray *)nodes ofKind:(NSString *)kind atIndexPaths:(NSArray *)indexPaths;
|
|
|
|
/**
|
|
* Deletes the given nodes of the specified kind in the backing store.
|
|
*/
|
|
- (NSArray *)deleteNodesOfKind:(NSString *)kind atIndexPaths:(NSArray *)indexPaths;
|
|
|
|
/**
|
|
* Inserts the given sections of the specified kind in the backing store.
|
|
*/
|
|
- (void)insertSections:(NSMutableArray *)sections ofKind:(NSString *)kind atIndexSet:(NSIndexSet *)indexSet;
|
|
|
|
/**
|
|
* Deletes the given sections of the specified kind in the backing store.
|
|
*/
|
|
- (void)deleteSectionsOfKind:(NSString *)kind atIndexSet:(NSIndexSet *)indexSet;
|
|
|
|
/**
|
|
* Moves the given section of the specified kind in the backing store.
|
|
*/
|
|
- (void)moveSection:(NSInteger)section ofKind:(NSString *)kind toSection:(NSInteger)newSection;
|
|
|
|
/**
|
|
* Commit the change for insert/delete node or sections to the backing store, calling completion on the main thread when finished.
|
|
*/
|
|
- (void)commitChangesToNodesOfKind:(NSString *)kind withCompletion:(void (^)())completionBlock;
|
|
|
|
#pragma mark - Data Manipulation Hooks
|
|
|
|
/**
|
|
* Notifies the subclass to perform any work needed before the data controller is reloaded entirely
|
|
*
|
|
* @discussion This method will be performed before the data controller enters its editing queue.
|
|
* The data source is locked at this point and accessing it is safe. Use this method to set up any nodes or
|
|
* data stores before entering into editing the backing store on a background thread.
|
|
*/
|
|
- (void)prepareForReloadData;
|
|
|
|
/**
|
|
* Notifies the subclass that the data controller is about to reload its data entirely
|
|
*
|
|
* @discussion This method will be performed on the data controller's editing background queue before the parent's
|
|
* concrete implementation. This is a great place to perform new node creation like supplementary views
|
|
* or header/footer nodes.
|
|
*/
|
|
- (void)willReloadData;
|
|
|
|
/**
|
|
* Notifies the subclass to perform setup before sections are inserted in the data controller
|
|
*
|
|
* @discussion This method will be performed before the data controller enters its editing queue.
|
|
* The data source is locked at this point and accessing it is safe. Use this method to set up any nodes or
|
|
* data stores before entering into editing the backing store on a background thread.
|
|
*
|
|
* @param sections Indices of sections to be inserted
|
|
*/
|
|
- (void)prepareForInsertSections:(NSIndexSet *)sections;
|
|
|
|
/**
|
|
* Notifies the subclass that the data controller will insert new sections at the given position
|
|
*
|
|
* @discussion This method will be performed on the data controller's editing background queue before the parent's
|
|
* concrete implementation. This is a great place to perform any additional transformations like supplementary views
|
|
* or header/footer nodes.
|
|
*
|
|
* @param sections Indices of sections to be inserted
|
|
*/
|
|
- (void)willInsertSections:(NSIndexSet *)sections;
|
|
|
|
/**
|
|
* Notifies the subclass that the data controller will delete sections at the given positions
|
|
*
|
|
* @discussion This method will be performed on the data controller's editing background queue before the parent's
|
|
* concrete implementation. This is a great place to perform any additional transformations like supplementary views
|
|
* or header/footer nodes.
|
|
*
|
|
* @param sections Indices of sections to be deleted
|
|
*/
|
|
- (void)willDeleteSections:(NSIndexSet *)sections;
|
|
|
|
/**
|
|
* Notifies the subclass to perform any work needed before the given sections will be reloaded.
|
|
*
|
|
* @discussion This method will be performed before the data controller enters its editing queue, usually on the main
|
|
* thread. The data source is locked at this point and accessing it is safe. Use this method to set up any nodes or
|
|
* data stores before entering into editing the backing store on a background thread.
|
|
*
|
|
* @param sections Indices of sections to be reloaded
|
|
*/
|
|
- (void)prepareForReloadSections:(NSIndexSet *)sections;
|
|
|
|
/**
|
|
* Notifies the subclass that the data controller will reload the sections in the given index set
|
|
*
|
|
* @discussion This method will be performed on the data controller's editing background queue before the parent's
|
|
* concrete implementation. This is a great place to perform any additional transformations like supplementary views
|
|
* or header/footer nodes.
|
|
*
|
|
* @param sections Indices of sections to be reloaded
|
|
*/
|
|
- (void)willReloadSections:(NSIndexSet *)sections;
|
|
|
|
/**
|
|
* Notifies the subclass that the data controller will move a section to a new position
|
|
*
|
|
* @discussion This method will be performed on the data controller's editing background queue before the parent's
|
|
* concrete implementation. This is a great place to perform any additional transformations like supplementary views
|
|
* or header/footer nodes.
|
|
*
|
|
* @param section Index of current section position
|
|
* @param newSection Index of new section position
|
|
*/
|
|
- (void)willMoveSection:(NSInteger)section toSection:(NSInteger)newSection;
|
|
|
|
@end
|
|
|
|
#endif
|