mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-09 14:10:05 +00:00
3e5b8c3096
Scenario: An ASCollectionNode is a subnode of an ASCellNode. A layout transition is started, resulting in the removal of the ASCollectionNode as a subnode. As it is removed, the hierarchy state is cleared - including the "range managed" bit - on the ASCollectionNode. However, the deep recursion traverses the layer hierarchy too, and clears this bit on the ASCellNodes inside the ASCollectionNode. A moment later, the collection performs its final ASRangeController update to mark its cells as invisible and free memory. Then an assertion is triggered in ASRangeController, because it is operating on nodes that do not have the "range managed" bit set. It turns out that ASInterfaceState also propogates in this way, but that behavior is efficient and beneficial in its current configuration (it assists how multi-dimensional preloading works). However, hierarchy state should never need to jump discontinuities in the node hierarchy. For now, disabling that case and will revisit other use cases soon.
166 lines
7.1 KiB
Objective-C
166 lines
7.1 KiB
Objective-C
//
|
|
// ASDisplayNodeExtras.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 <QuartzCore/QuartzCore.h>
|
|
#import <UIKit/UIKit.h>
|
|
|
|
#import <AsyncDisplayKit/ASBaseDefines.h>
|
|
#import <AsyncDisplayKit/ASDisplayNode.h>
|
|
|
|
// Because inline methods can't be extern'd and need to be part of the translation unit of code
|
|
// that compiles with them to actually inline, we both declare and define these in the header.
|
|
ASDISPLAYNODE_INLINE BOOL ASInterfaceStateIncludesVisible(ASInterfaceState interfaceState)
|
|
{
|
|
return ((interfaceState & ASInterfaceStateVisible) == ASInterfaceStateVisible);
|
|
}
|
|
|
|
ASDISPLAYNODE_INLINE BOOL ASInterfaceStateIncludesDisplay(ASInterfaceState interfaceState)
|
|
{
|
|
return ((interfaceState & ASInterfaceStateDisplay) == ASInterfaceStateDisplay);
|
|
}
|
|
|
|
ASDISPLAYNODE_INLINE BOOL ASInterfaceStateIncludesPreload(ASInterfaceState interfaceState)
|
|
{
|
|
return ((interfaceState & ASInterfaceStatePreload) == ASInterfaceStatePreload);
|
|
}
|
|
|
|
ASDISPLAYNODE_INLINE BOOL ASInterfaceStateIncludesMeasureLayout(ASInterfaceState interfaceState)
|
|
{
|
|
return ((interfaceState & ASInterfaceStateMeasureLayout) == ASInterfaceStateMeasureLayout);
|
|
}
|
|
|
|
__unused static NSString * _Nonnull NSStringFromASInterfaceState(ASInterfaceState interfaceState)
|
|
{
|
|
NSMutableArray *states = [NSMutableArray array];
|
|
if (interfaceState == ASInterfaceStateNone) {
|
|
[states addObject:@"No state"];
|
|
}
|
|
if (ASInterfaceStateIncludesMeasureLayout(interfaceState)) {
|
|
[states addObject:@"MeasureLayout"];
|
|
}
|
|
if (ASInterfaceStateIncludesPreload(interfaceState)) {
|
|
[states addObject:@"Preload"];
|
|
}
|
|
if (ASInterfaceStateIncludesDisplay(interfaceState)) {
|
|
[states addObject:@"Display"];
|
|
}
|
|
if (ASInterfaceStateIncludesVisible(interfaceState)) {
|
|
[states addObject:@"Visible"];
|
|
}
|
|
return [NSString stringWithFormat:@"{ %@ }", [states componentsJoinedByString:@" | "]];
|
|
}
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
ASDISPLAYNODE_EXTERN_C_BEGIN
|
|
|
|
/**
|
|
Returns the appropriate interface state for a given ASDisplayNode and window
|
|
*/
|
|
extern ASInterfaceState ASInterfaceStateForDisplayNode(ASDisplayNode *displayNode, UIWindow *window);
|
|
|
|
/**
|
|
Given a layer, returns the associated display node, if any.
|
|
*/
|
|
extern ASDisplayNode * _Nullable ASLayerToDisplayNode(CALayer * _Nullable layer);
|
|
|
|
/**
|
|
Given a view, returns the associated display node, if any.
|
|
*/
|
|
extern ASDisplayNode * _Nullable ASViewToDisplayNode(UIView * _Nullable view);
|
|
|
|
/**
|
|
Given a node, returns the root of the node heirarchy (where supernode == nil)
|
|
*/
|
|
extern ASDisplayNode *ASDisplayNodeUltimateParentOfNode(ASDisplayNode *node);
|
|
|
|
/**
|
|
If traverseSublayers == YES, this function will walk the layer hierarchy, spanning discontinuous sections of the node hierarchy\
|
|
(e.g. the layers of UIKit intermediate views in UIViewControllers, UITableView, UICollectionView).
|
|
In the event that a node's backing layer is not created yet, the function will only walk the direct subnodes instead
|
|
of forcing the layer hierarchy to be created.
|
|
*/
|
|
extern void ASDisplayNodePerformBlockOnEveryNode(CALayer * _Nullable layer, ASDisplayNode * _Nullable node, BOOL traverseSublayers, void(^block)(ASDisplayNode *node));
|
|
|
|
/**
|
|
This function will walk the node hierarchy in a breadth first fashion. It does run the block on the node provided
|
|
directly to the function call. It does NOT traverse sublayers.
|
|
*/
|
|
extern void ASDisplayNodePerformBlockOnEveryNodeBFS(ASDisplayNode *node, void(^block)(ASDisplayNode *node));
|
|
|
|
/**
|
|
Identical to ASDisplayNodePerformBlockOnEveryNode, except it does not run the block on the
|
|
node provided directly to the function call - only on all descendants.
|
|
*/
|
|
extern void ASDisplayNodePerformBlockOnEverySubnode(ASDisplayNode *node, BOOL traverseSublayers, void(^block)(ASDisplayNode *node));
|
|
|
|
/**
|
|
Given a display node, traverses up the layer tree hierarchy, returning the first display node that passes block.
|
|
*/
|
|
extern ASDisplayNode * _Nullable ASDisplayNodeFindFirstSupernode(ASDisplayNode * _Nullable node, BOOL (^block)(ASDisplayNode *node));
|
|
|
|
/**
|
|
Given a display node, traverses up the layer tree hierarchy, returning the first display node of kind class.
|
|
*/
|
|
extern __kindof ASDisplayNode * _Nullable ASDisplayNodeFindFirstSupernodeOfClass(ASDisplayNode *start, Class c);
|
|
|
|
/**
|
|
* Given two nodes, finds their most immediate common parent. Used for geometry conversion methods.
|
|
* NOTE: It is an error to try to convert between nodes which do not share a common ancestor. This behavior is
|
|
* disallowed in UIKit documentation and the behavior is left undefined. The output does not have a rigorously defined
|
|
* failure mode (i.e. returning CGPointZero or returning the point exactly as passed in). Rather than track the internal
|
|
* undefined and undocumented behavior of UIKit in ASDisplayNode, this operation is defined to be incorrect in all
|
|
* circumstances and must be fixed wherever encountered.
|
|
*/
|
|
extern ASDisplayNode * _Nullable ASDisplayNodeFindClosestCommonAncestor(ASDisplayNode *node1, ASDisplayNode *node2);
|
|
|
|
/**
|
|
Given a display node, collects all descendants. This is a specialization of ASCollectContainer() that walks the Core Animation layer tree as opposed to the display node tree, thus supporting non-continues display node hierarchies.
|
|
*/
|
|
extern NSArray<ASDisplayNode *> *ASCollectDisplayNodes(ASDisplayNode *node);
|
|
|
|
/**
|
|
Given a display node, traverses down the node hierarchy, returning all the display nodes that pass the block.
|
|
*/
|
|
extern NSArray<ASDisplayNode *> *ASDisplayNodeFindAllSubnodes(ASDisplayNode *start, BOOL (^block)(ASDisplayNode *node));
|
|
|
|
/**
|
|
Given a display node, traverses down the node hierarchy, returning all the display nodes of kind class.
|
|
*/
|
|
extern NSArray<__kindof ASDisplayNode *> *ASDisplayNodeFindAllSubnodesOfClass(ASDisplayNode *start, Class c);
|
|
|
|
/**
|
|
Given a display node, traverses down the node hierarchy, returning the depth-first display node, including the start node that pass the block.
|
|
*/
|
|
extern __kindof ASDisplayNode * _Nullable ASDisplayNodeFindFirstNode(ASDisplayNode *start, BOOL (^block)(ASDisplayNode *node));
|
|
|
|
/**
|
|
Given a display node, traverses down the node hierarchy, returning the depth-first display node, excluding the start node, that pass the block
|
|
*/
|
|
extern __kindof ASDisplayNode * _Nullable ASDisplayNodeFindFirstSubnode(ASDisplayNode *start, BOOL (^block)(ASDisplayNode *node));
|
|
|
|
/**
|
|
Given a display node, traverses down the node hierarchy, returning the depth-first display node of kind class.
|
|
*/
|
|
extern __kindof ASDisplayNode * _Nullable ASDisplayNodeFindFirstSubnodeOfClass(ASDisplayNode *start, Class c);
|
|
|
|
extern UIColor *ASDisplayNodeDefaultPlaceholderColor();
|
|
extern UIColor *ASDisplayNodeDefaultTintColor();
|
|
|
|
/**
|
|
Disable willAppear / didAppear / didDisappear notifications for a sub-hierarchy, then re-enable when done. Nested calls are supported.
|
|
*/
|
|
extern void ASDisplayNodeDisableHierarchyNotifications(ASDisplayNode *node);
|
|
extern void ASDisplayNodeEnableHierarchyNotifications(ASDisplayNode *node);
|
|
|
|
ASDISPLAYNODE_EXTERN_C_END
|
|
|
|
NS_ASSUME_NONNULL_END
|