// // ASLayoutSpec.mm // 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 "ASLayoutSpec.h" #import "ASAssert.h" #import "ASEnvironmentInternal.h" #import "ASLayout.h" #import "ASThread.h" #import "ASTraitCollection.h" #import #import #import typedef std::map, std::less> ASChildMap; @interface ASLayoutSpec() { ASEnvironmentState _environmentState; ASDN::RecursiveMutex _propertyLock; ASChildMap _children; } @end @implementation ASLayoutSpec // these dynamic properties all defined in ASLayoutOptionsPrivate.m @dynamic spacingAfter, spacingBefore, flexGrow, flexShrink, flexBasis, alignSelf, ascender, descender, sizeRange, layoutPosition, layoutableType; @synthesize isFinalLayoutable = _isFinalLayoutable; - (instancetype)init { if (!(self = [super init])) { return nil; } _isMutable = YES; _environmentState = ASEnvironmentStateMakeDefault(); return self; } - (ASLayoutableType)layoutableType { return ASLayoutableTypeLayoutSpec; } - (BOOL)canLayoutAsynchronous { return YES; } #pragma mark - Layout - (ASLayout *)measureWithSizeRange:(ASSizeRange)constrainedSize { return [ASLayout layoutWithLayoutableObject:self constrainedSizeRange:constrainedSize size:constrainedSize.min]; } - (id)finalLayoutable { return self; } - (id)layoutableToAddFromLayoutable:(id)child { if (self.isFinalLayoutable == NO) { // If you are getting recursion crashes here after implementing finalLayoutable, make sure // that you are setting isFinalLayoutable flag to YES. This must be one BEFORE adding a child // to the new ASLayoutable. // // For example: //- (id)finalLayoutable //{ // ASInsetLayoutSpec *insetSpec = [[ASInsetLayoutSpec alloc] init]; // insetSpec.insets = UIEdgeInsetsMake(10,10,10,10); // insetSpec.isFinalLayoutable = YES; // [insetSpec setChild:self]; // return insetSpec; //} id finalLayoutable = [child finalLayoutable]; if (finalLayoutable != child) { if (ASEnvironmentStatePropagationEnabled()) { ASEnvironmentStatePropagateUp(finalLayoutable, child.environmentState.layoutOptionsState); } else { // If state propagation is not enabled the layout options state needs to be copied manually ASEnvironmentState finalLayoutableEnvironmentState = finalLayoutable.environmentState; finalLayoutableEnvironmentState.layoutOptionsState = child.environmentState.layoutOptionsState; finalLayoutable.environmentState = finalLayoutableEnvironmentState; } return finalLayoutable; } } return child; } - (void)setParent:(id)parent { // FIXME: Locking should be evaluated here. _parent is not widely used yet, though. _parent = parent; if ([parent supportsUpwardPropagation]) { ASEnvironmentStatePropagateUp(parent, self.environmentState.layoutOptionsState); } } - (void)setChild:(id)child { ASDisplayNodeAssert(self.isMutable, @"Cannot set properties when layout spec is not mutable"); if (child) { id finalLayoutable = [self layoutableToAddFromLayoutable:child]; if (finalLayoutable) { _children[0] = finalLayoutable; [self propagateUpLayoutable:finalLayoutable]; } } else { _children.erase(0); } } - (void)setChild:(id)child forIndex:(NSUInteger)index { ASDisplayNodeAssert(self.isMutable, @"Cannot set properties when layout spec is not mutable"); if (child) { id finalLayoutable = [self layoutableToAddFromLayoutable:child]; _children[index] = finalLayoutable; } else { _children.erase(index); } // TODO: Should we propagate up the layoutable at it could happen that multiple children will propagated up their // layout options and one child will overwrite values from another child // [self propagateUpLayoutable:finalLayoutable]; } - (void)setChildren:(NSArray> *)children { ASDisplayNodeAssert(self.isMutable, @"Cannot set properties when layout spec is not mutable"); _children.clear(); [children enumerateObjectsUsingBlock:^(id _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) { _children[idx] = [self layoutableToAddFromLayoutable:obj]; }]; } - (id)childForIndex:(NSUInteger)index { if (index < _children.size()) { return _children[index]; } return nil; } - (id)child { return _children[0]; } - (NSArray *)children { std::vector children; for (ASChildMap::iterator it = _children.begin(); it != _children.end(); ++it ) { children.push_back(it->second); } return [NSArray arrayWithObjects:&children[0] count:children.size()]; } #pragma mark - ASEnvironment - (ASEnvironmentState)environmentState { return _environmentState; } - (void)setEnvironmentState:(ASEnvironmentState)environmentState { _environmentState = environmentState; } // Subclasses can override this method to return NO, because upward propagation is not enabled if a layout // specification has more than one child. Currently ASStackLayoutSpec and ASStaticLayoutSpec are currently // the specifications that are known to have more than one. - (BOOL)supportsUpwardPropagation { return ASEnvironmentStatePropagationEnabled(); } - (BOOL)supportsTraitsCollectionPropagation { return ASEnvironmentStateTraitCollectionPropagationEnabled(); } - (void)propagateUpLayoutable:(id)layoutable { if ([layoutable isKindOfClass:[ASLayoutSpec class]]) { [(ASLayoutSpec *)layoutable setParent:self]; // This will trigger upward propogation if needed. } else if ([self supportsUpwardPropagation]) { ASEnvironmentStatePropagateUp(self, layoutable.environmentState.layoutOptionsState); // Probably an ASDisplayNode } } - (ASEnvironmentTraitCollection)environmentTraitCollection { return _environmentState.environmentTraitCollection; } - (void)setEnvironmentTraitCollection:(ASEnvironmentTraitCollection)environmentTraitCollection { _environmentState.environmentTraitCollection = environmentTraitCollection; } ASEnvironmentLayoutOptionsForwarding ASEnvironmentLayoutExtensibilityForwarding - (ASTraitCollection *)asyncTraitCollection { ASDN::MutexLocker l(_propertyLock); return [ASTraitCollection traitCollectionWithASEnvironmentTraitCollection:self.environmentTraitCollection]; } @end @implementation ASLayoutSpec (Debugging) #pragma mark - ASLayoutableAsciiArtProtocol + (NSString *)asciiArtStringForChildren:(NSArray *)children parentName:(NSString *)parentName direction:(ASStackLayoutDirection)direction { NSMutableArray *childStrings = [NSMutableArray array]; for (id layoutChild in children) { NSString *childString = [layoutChild asciiArtString]; if (childString) { [childStrings addObject:childString]; } } if (direction == ASStackLayoutDirectionHorizontal) { return [ASAsciiArtBoxCreator horizontalBoxStringForChildren:childStrings parent:parentName]; } return [ASAsciiArtBoxCreator verticalBoxStringForChildren:childStrings parent:parentName]; } + (NSString *)asciiArtStringForChildren:(NSArray *)children parentName:(NSString *)parentName { return [self asciiArtStringForChildren:children parentName:parentName direction:ASStackLayoutDirectionHorizontal]; } - (NSString *)asciiArtString { NSArray *children = self.child ? @[self.child] : self.children; return [ASLayoutSpec asciiArtStringForChildren:children parentName:[self asciiArtName]]; } - (NSString *)asciiArtName { return NSStringFromClass([self class]); } @end