mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-06 20:54:04 +00:00
01fed69b26
Currently measurement always needs to happen on the main thread if implicit hierarchy management is enabled as adding and removing from nodes needs to happen on the main thread. We now will trampoline to the main thread to do the insertion and deletion of nodes. This also resolves the issue that can occur if a node is already loaded deep in the layout hierarchy in the layout that the node is transforming to. Before insertion or deletion is happening we need to crawl the layout hierarchy to check that though.
130 lines
4.7 KiB
Objective-C
130 lines
4.7 KiB
Objective-C
//
|
|
// ASLayoutable.h
|
|
// AsyncDisplayKit
|
|
//
|
|
// 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 root directory of this source tree. An additional grant
|
|
// of patent rights can be found in the PATENTS file in the same directory.
|
|
//
|
|
|
|
#import <AsyncDisplayKit/ASDimension.h>
|
|
#import <AsyncDisplayKit/ASRelativeSize.h>
|
|
#import <AsyncDisplayKit/ASStackLayoutDefines.h>
|
|
#import <AsyncDisplayKit/ASStackLayoutable.h>
|
|
#import <AsyncDisplayKit/ASStaticLayoutable.h>
|
|
|
|
#import <AsyncDisplayKit/ASLayoutablePrivate.h>
|
|
#import <AsyncDisplayKit/ASEnvironment.h>
|
|
#import <AsyncDisplayKit/ASLayoutableExtensibility.h>
|
|
|
|
@class ASLayout;
|
|
@class ASLayoutSpec;
|
|
|
|
typedef NS_ENUM(NSUInteger, ASLayoutableType) {
|
|
ASLayoutableTypeLayoutSpec,
|
|
ASLayoutableTypeDisplayNode
|
|
};
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/**
|
|
* The ASLayoutable protocol declares a method for measuring the layout of an object. A layout
|
|
* is defined by an ASLayout return value, and must specify 1) the size (but not position) of the
|
|
* layoutable object, and 2) the size and position of all of its immediate child objects. The tree
|
|
* recursion is driven by parents requesting layouts from their children in order to determine their
|
|
* size, followed by the parents setting the position of the children once the size is known
|
|
*
|
|
* The protocol also implements a "family" of Layoutable protocols. These protocols contain layout
|
|
* options that can be used for specific layout specs. For example, ASStackLayoutSpec has options
|
|
* defining how a layoutable should shrink or grow based upon available space.
|
|
*
|
|
* These layout options are all stored in an ASLayoutOptions class (that is defined in ASLayoutablePrivate).
|
|
* Generally you needn't worry about the layout options class, as the layoutable protocols allow all direct
|
|
* access to the options via convenience properties. If you are creating custom layout spec, then you can
|
|
* extend the backing layout options class to accommodate any new layout options.
|
|
*/
|
|
@protocol ASLayoutable <ASEnvironment, ASStackLayoutable, ASStaticLayoutable, ASLayoutablePrivate, ASLayoutableExtensibility>
|
|
|
|
/**
|
|
* @abstract Returns type of layoutable
|
|
*/
|
|
@property (nonatomic, readonly) ASLayoutableType layoutableType;
|
|
|
|
/**
|
|
* @abstract Returns if the layoutable can be used to layout in an asynchronous way on a background thread.
|
|
*/
|
|
@property (nonatomic, readonly) BOOL canLayoutAsynchronous;
|
|
|
|
/**
|
|
* @abstract Calculate a layout based on given size range.
|
|
*
|
|
* @param constrainedSize The minimum and maximum sizes the receiver should fit in.
|
|
*
|
|
* @return An ASLayout instance defining the layout of the receiver and its children.
|
|
*/
|
|
- (ASLayout *)measureWithSizeRange:(ASSizeRange)constrainedSize;
|
|
|
|
#pragma mark - Layout options from the Layoutable Protocols
|
|
|
|
#pragma mark - ASStackLayoutable
|
|
/**
|
|
* @abstract Additional space to place before this object in the stacking direction.
|
|
* Used when attached to a stack layout.
|
|
*/
|
|
@property (nonatomic, readwrite) CGFloat spacingBefore;
|
|
|
|
/**
|
|
* @abstract Additional space to place after this object in the stacking direction.
|
|
* Used when attached to a stack layout.
|
|
*/
|
|
@property (nonatomic, readwrite) CGFloat spacingAfter;
|
|
|
|
/**
|
|
* @abstract If the sum of childrens' stack dimensions is less than the minimum size, should this object grow?
|
|
* Used when attached to a stack layout.
|
|
*/
|
|
@property (nonatomic, readwrite) BOOL flexGrow;
|
|
|
|
/**
|
|
* @abstract If the sum of childrens' stack dimensions is greater than the maximum size, should this object shrink?
|
|
* Used when attached to a stack layout.
|
|
*/
|
|
@property (nonatomic, readwrite) BOOL flexShrink;
|
|
|
|
/**
|
|
* @abstract Specifies the initial size in the stack dimension for this object.
|
|
* Default to ASRelativeDimensionUnconstrained.
|
|
* Used when attached to a stack layout.
|
|
*/
|
|
@property (nonatomic, readwrite) ASRelativeDimension flexBasis;
|
|
|
|
/**
|
|
* @abstract Orientation of the object along cross axis, overriding alignItems
|
|
* Used when attached to a stack layout.
|
|
*/
|
|
@property (nonatomic, readwrite) ASStackLayoutAlignSelf alignSelf;
|
|
|
|
/**
|
|
* @abstract Used for baseline alignment. The distance from the top of the object to its baseline.
|
|
*/
|
|
@property (nonatomic, readwrite) CGFloat ascender;
|
|
|
|
/**
|
|
* @abstract Used for baseline alignment. The distance from the baseline of the object to its bottom.
|
|
*/
|
|
@property (nonatomic, readwrite) CGFloat descender;
|
|
|
|
#pragma mark - ASStaticLayoutable
|
|
/**
|
|
If specified, the child's size is restricted according to this size. Percentages are resolved relative to the static layout spec.
|
|
*/
|
|
@property (nonatomic, assign) ASRelativeSizeRange sizeRange;
|
|
|
|
/** The position of this object within its parent spec. */
|
|
@property (nonatomic, assign) CGPoint layoutPosition;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|