mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-06 12:43:58 +00:00
* Introduce ASCollectionViewLayout - `ASCollectionViewLayout` is an async `UICollectionViewLayout` that encapsulates its layout calculation logic into a separate thread-safe object which can be used ahead of time and/or on multiple threads. - `ASDataController` now can prepare for a new layout resulted from a change set before `ASCollectionView` even knows about it. By the time the change set it ready to be consumed by `ASCollectionView`, its new layout is also ready. - New `ASCollectionViewLayoutCalculating` protocol that is simple and generic enough that many types of calculators can be built on top. `ASCollectionViewLayoutSpecCalculator` conforms to `ASCollectionViewLayoutCalculating` protocol and can be backed by any layout spec (e.g `ASStackLayoutSpec`, `PIMasonryLayoutSpec`, etc). We can even build a `ASCollectionViewLayoutYogaCalculator` that uses Yoga internally. - A built-in `ASCollectionViewFlowLayoutCalculator` that is a subclass of `ASCollectionViewLayoutSpecCalculator` and uses a multi-threaded multi-line `ASStackLayoutSpec` internally. The result is a performant and thread-safe flow layout calculator. - Finally, `ASCollectionViewLayout` can be subclassed to handle a specific type of calculator with optimizations implemented based on the knowledge of such calculator. For example, `ASCollectionViewFlowLayout` can have a highly optimized implementation of `-layoutAttributesForElementsInRect:`. Protocolize layout calculator providing and consuming Add flex wrap documentation Add a `multithreaded` flag to ASStackLayoutSpec that forces it to dispatch even if it's off main - Update ASCollectionViewFlowLayoutSpecCalculator to use that flag. Minor change in ASCollectionViewLayout Implement Mosaic layout calculator Minor change Fix project file Rename and fix project file Skip fetching constrained size only if a layout calculator is available Update examples/ASCollectionView Remove unnecessary change in ASTableView Address comments Rename collection view calculator protocols Minor changes after rebasing with master Add ASLegacyCollectionLayoutCalculator for backward compatibility Remove ASCollectionLayoutSpecCalculator Remove ASLegacyCollectionLayoutCalculator Introduce ASCollectionLayout - A wrapper object that contains content size and an element to rect table. - Collection layout calculators to return this new object instead of an ASLayout. Before adding a content cache Finishing hooking up ASCollectionLayoutDataSource to ASCollectionNode Stash Finish ASCollectionLayout Rough impl of ASCollectionFlowLayout Revert changes in CustomCollectionView example Move ASRectTable back to Private * Rename ASCollectionContentAttributes to ASCollectionLayoutState * Address other comments * Introduce ASCollectionLayoutDelegate and make ASCollectionLayout private * Address comments * API tweaks: - Replace `-layoutContextWithElementMap:` in ASCollectionLayoutDelegate with `-additionalInfoForLayoutWithElements:`. The returned object is then stored in ASCollectionLayoutContext for later lookups. - ASCollectionLayoutContext has no public initializer. - ASDataControllerLayoutDelegate no longer requires a context of type ASCollectionLayoutContext but simply an `id`. This helps decouple ASDataController and ASCollectionLayout. - Rename `elementMap` to `elements`. - Rename `visibleMap` to `visibleElements`. - Other minor changes. * Rename ASCGSizeHash to ASHashFromCGSize * Make sure to call super in -[ASCollectionLayout prepareLayout] * Update example/ASCollectionView to use ASCollectionFlowLayoutDelegate * Remove unnecessary change
154 lines
4.8 KiB
Plaintext
154 lines
4.8 KiB
Plaintext
//
|
|
// ASCollectionLayout.mm
|
|
// AsyncDisplayKit
|
|
//
|
|
// Created by Huy Nguyen on 28/2/17.
|
|
// Copyright © 2017 Facebook. All rights reserved.
|
|
//
|
|
|
|
#import <AsyncDisplayKit/ASCollectionLayout.h>
|
|
|
|
#import <AsyncDisplayKit/ASAssert.h>
|
|
#import <AsyncDisplayKit/ASCollectionElement.h>
|
|
#import <AsyncDisplayKit/ASCollectionLayoutContext+Private.h>
|
|
#import <AsyncDisplayKit/ASCollectionLayoutDelegate.h>
|
|
#import <AsyncDisplayKit/ASCollectionLayoutState.h>
|
|
#import <AsyncDisplayKit/ASCollectionNode+Beta.h>
|
|
#import <AsyncDisplayKit/ASDisplayNode+FrameworkPrivate.h>
|
|
#import <AsyncDisplayKit/ASElementMap.h>
|
|
#import <AsyncDisplayKit/ASEqualityHelpers.h>
|
|
#import <AsyncDisplayKit/ASThread.h>
|
|
|
|
@interface ASCollectionLayout () <ASDataControllerLayoutDelegate> {
|
|
ASDN::Mutex __instanceLock__; // Non-recursive mutex, ftw!
|
|
|
|
// Main thread only.
|
|
ASCollectionLayoutState *_state;
|
|
|
|
// The pending state calculated ahead of time, if any.
|
|
ASCollectionLayoutState *_pendingState;
|
|
// The context used to calculate _pendingState
|
|
ASCollectionLayoutContext *_layoutContextForPendingState;
|
|
|
|
BOOL _layoutDelegateImplementsAdditionalInfoForLayoutWithElements;
|
|
}
|
|
|
|
@end
|
|
|
|
@implementation ASCollectionLayout
|
|
|
|
- (instancetype)initWithLayoutDelegate:(id<ASCollectionLayoutDelegate>)layoutDelegate
|
|
{
|
|
self = [super init];
|
|
if (self) {
|
|
ASDisplayNodeAssertNotNil(layoutDelegate, @"Collection layout delegate cannot be nil");
|
|
_layoutDelegate = layoutDelegate;
|
|
_layoutDelegateImplementsAdditionalInfoForLayoutWithElements = [layoutDelegate respondsToSelector:@selector(additionalInfoForLayoutWithElements:)];
|
|
}
|
|
return self;
|
|
}
|
|
|
|
#pragma mark - ASDataControllerLayoutDelegate
|
|
|
|
- (id)layoutContextWithElements:(ASElementMap *)elements
|
|
{
|
|
ASDisplayNodeAssertMainThread();
|
|
id additionalInfo = nil;
|
|
if (_layoutDelegateImplementsAdditionalInfoForLayoutWithElements) {
|
|
additionalInfo = [_layoutDelegate additionalInfoForLayoutWithElements:elements];
|
|
}
|
|
return [[ASCollectionLayoutContext alloc] initWithViewportSize:[self viewportSize] elements:elements additionalInfo:additionalInfo];
|
|
}
|
|
|
|
- (void)prepareLayoutWithContext:(id)context
|
|
{
|
|
ASCollectionLayoutState *state = [_layoutDelegate calculateLayoutWithContext:context];
|
|
|
|
ASDN::MutexLocker l(__instanceLock__);
|
|
_pendingState = state;
|
|
_layoutContextForPendingState = context;
|
|
}
|
|
|
|
#pragma mark - UICollectionViewLayout overrides
|
|
|
|
- (void)prepareLayout
|
|
{
|
|
ASDisplayNodeAssertMainThread();
|
|
[super prepareLayout];
|
|
ASCollectionLayoutContext *context = [self layoutContextWithElements:_collectionNode.visibleElements];
|
|
|
|
ASCollectionLayoutState *state = nil;
|
|
{
|
|
ASDN::MutexLocker l(__instanceLock__);
|
|
if (_pendingState != nil && ASObjectIsEqual(_layoutContextForPendingState, context)) {
|
|
// Looks like we can use the pending state. Great!
|
|
state = _pendingState;
|
|
_pendingState = nil;
|
|
_layoutContextForPendingState = nil;
|
|
}
|
|
}
|
|
|
|
if (state == nil) {
|
|
state = [_layoutDelegate calculateLayoutWithContext:context];
|
|
}
|
|
|
|
_state = state;
|
|
}
|
|
|
|
- (void)invalidateLayout
|
|
{
|
|
ASDisplayNodeAssertMainThread();
|
|
[super invalidateLayout];
|
|
_state = nil;
|
|
}
|
|
|
|
- (CGSize)collectionViewContentSize
|
|
{
|
|
ASDisplayNodeAssertMainThread();
|
|
ASDisplayNodeAssertNotNil(_state, @"Collection layout state should not be nil at this point");
|
|
return _state.contentSize;
|
|
}
|
|
|
|
- (NSArray<UICollectionViewLayoutAttributes *> *)layoutAttributesForElementsInRect:(CGRect)rect
|
|
{
|
|
NSMutableArray *attributesInRect = [NSMutableArray array];
|
|
NSMapTable *attrsMap = _state.elementToLayoutArrtibutesMap;
|
|
for (ASCollectionElement *element in attrsMap) {
|
|
UICollectionViewLayoutAttributes *attrs = [attrsMap objectForKey:element];
|
|
if (CGRectIntersectsRect(rect, attrs.frame)) {
|
|
[attributesInRect addObject:attrs];
|
|
}
|
|
}
|
|
return attributesInRect;
|
|
}
|
|
|
|
- (UICollectionViewLayoutAttributes *)layoutAttributesForItemAtIndexPath:(NSIndexPath *)indexPath
|
|
{
|
|
ASCollectionLayoutState *state = _state;
|
|
ASCollectionElement *element = [state.elements elementForItemAtIndexPath:indexPath];
|
|
return [state.elementToLayoutArrtibutesMap objectForKey:element];
|
|
}
|
|
|
|
- (UICollectionViewLayoutAttributes *)layoutAttributesForSupplementaryViewOfKind:(NSString *)elementKind atIndexPath:(NSIndexPath *)indexPath
|
|
{
|
|
ASCollectionLayoutState *state = _state;
|
|
ASCollectionElement *element = [state.elements supplementaryElementOfKind:elementKind atIndexPath:indexPath];
|
|
return [state.elementToLayoutArrtibutesMap objectForKey:element];
|
|
}
|
|
|
|
#pragma mark - Private methods
|
|
|
|
- (CGSize)viewportSize
|
|
{
|
|
ASCollectionNode *collectionNode = _collectionNode;
|
|
if (collectionNode != nil && !collectionNode.isNodeLoaded) {
|
|
// TODO consider calculatedSize as well
|
|
return collectionNode.threadSafeBounds.size;
|
|
} else {
|
|
ASDisplayNodeAssertMainThread();
|
|
return self.collectionView.bounds.size;
|
|
}
|
|
}
|
|
|
|
@end
|