mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-12-14 02:10:15 +00:00
ca2885cf06
* Implement ASPageTable - It is a screen page table that can be used to quickly filter out objects in a certain rect without checking each and every one of them. - ASCollectionLayoutState generates and keeps a table that maps page to layout attributes within that page. - ASCollectionLayout (and later, ASCollectionGalleryLayoutDelegate) consults its layout state for `layoutAttributesForElementsInRect:`. This ensures the method can return as quickly as possible, especially on a large data set (I heard some people have galleries with thousands of photos!). * Address comments * Handle items that span multiple pages * Make danger happy
103 lines
3.5 KiB
Objective-C
103 lines
3.5 KiB
Objective-C
//
|
|
// ASCollectionLayoutState.h
|
|
// Texture
|
|
//
|
|
// Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
|
|
// This source code is licensed under the BSD-style license found in the
|
|
// LICENSE file in the /ASDK-Licenses directory of this source tree. An additional
|
|
// grant of patent rights can be found in the PATENTS file in the same directory.
|
|
//
|
|
// Modifications to this file made after 4/13/2017 are: Copyright (c) 2017-present,
|
|
// Pinterest, Inc. Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
|
|
#import <Foundation/Foundation.h>
|
|
#import <UIKit/UIKit.h>
|
|
#import <AsyncDisplayKit/ASBaseDefines.h>
|
|
|
|
@class ASCollectionLayoutContext, ASLayout, ASCollectionElement;
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
@interface NSMapTable (ASCollectionLayoutConvenience)
|
|
|
|
+ (NSMapTable<ASCollectionElement *, UICollectionViewLayoutAttributes *> *)elementToLayoutAttributesTable;
|
|
|
|
@end
|
|
|
|
AS_SUBCLASSING_RESTRICTED
|
|
@interface ASCollectionLayoutState : NSObject
|
|
|
|
/// The context used to calculate this object
|
|
@property (nonatomic, strong, readonly) ASCollectionLayoutContext *context;
|
|
|
|
/// The final content size of the collection's layout
|
|
@property (nonatomic, assign, readonly) CGSize contentSize;
|
|
|
|
- (instancetype)init __unavailable;
|
|
|
|
/**
|
|
* Designated initializer.
|
|
*
|
|
* @param context The context used to calculate this object
|
|
*
|
|
* @param contentSize The content size of the collection's layout
|
|
*
|
|
* @param table A map between elements to their layout attributes. It may contain all elements, or a subset of them that will be updated later.
|
|
* It should be initialized using +[NSMapTable elementToLayoutAttributesTable] convenience initializer.
|
|
*/
|
|
- (instancetype)initWithContext:(ASCollectionLayoutContext *)context contentSize:(CGSize)contentSize elementToLayoutAttributesTable:(NSMapTable<ASCollectionElement *, UICollectionViewLayoutAttributes *> *)table NS_DESIGNATED_INITIALIZER;
|
|
|
|
/**
|
|
* Convenience initializer.
|
|
*
|
|
* @param context The context used to calculate this object
|
|
*
|
|
* @param layout The layout describes size and position of all elements, or a subset of them and will be updated over time.
|
|
*
|
|
*/
|
|
- (instancetype)initWithContext:(ASCollectionLayoutContext *)context layout:(ASLayout *)layout;
|
|
|
|
/**
|
|
* Returns all layout attributes present in this object.
|
|
*/
|
|
- (NSArray<UICollectionViewLayoutAttributes *> *)allLayoutAttributes;
|
|
|
|
/**
|
|
* Returns layout attributes of elements in the specified rect.
|
|
*
|
|
* @param rect The rect containing the target elements.
|
|
*/
|
|
- (NSArray<UICollectionViewLayoutAttributes *> *)layoutAttributesForElementsInRect:(CGRect)rect;
|
|
|
|
/**
|
|
* Returns layout attributes of the element at the specified index path.
|
|
*
|
|
* @param indexPath The index path of the item.
|
|
*/
|
|
- (nullable UICollectionViewLayoutAttributes *)layoutAttributesForItemAtIndexPath:(NSIndexPath *)indexPath;
|
|
|
|
/**
|
|
* Returns layout attributes of the specified supplementary element.
|
|
*
|
|
* @param kind A string that identifies the type of the supplementary element.
|
|
*
|
|
* @param indexPath The index path of the element.
|
|
*/
|
|
- (nullable UICollectionViewLayoutAttributes *)layoutAttributesForSupplementaryElementOfKind:(NSString *)kind atIndexPath:(NSIndexPath *)indexPath;
|
|
|
|
/**
|
|
* Returns layout attributes of the specified element.
|
|
*
|
|
* @element The element.
|
|
*/
|
|
- (nullable UICollectionViewLayoutAttributes *)layoutAttributesForElement:(ASCollectionElement *)element;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|