mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-10 14:35:42 +00:00
55b5dff80c
* Initial ASLayoutSpecPlayground commit * Initial exploratory stab at the main challenge of the app - visualizing ASLayoutSpecs * Halfway through moving debug features out of ASDK framework files and into debug files. Project builds. * [ASLayoutSpecPlayground] Created new Inspector node, cleaning up internal implementation to start formalizing support for layout spec visualization. * Workaround for ensuring creation of visualizerNode for ALL layoutspecs * continued development * Layout Inspector Work in Progress * Resizing the playground works in the shrink direction, not for grow. * added new ASLayoutableInspectorNode features * Cleaned up examples code. * Cleaning up code. * more code cleanup * [ASLayoutableInspector] Transition to an ASTableNode-based architecture to support larger numbers of buttons / customizable types. * [ASLayoutableInspector] Support different layoutable property types to set up buttons that can edit all of them. * Huy debugging * Refactored layout inspector code for extensibility. * Properly lock layoutableContextMap * Fix context handling in ASDisplayNode:measureWithSizeRange * Fix ASLayoutSpecPlayground:ViewController:toggleVisualization * added slider to InspectorCell * [ASLayoutSpecPlayground] Improvements to propagation of visualize mode, resize handle, minor cleanup. * Fix to ASEnvironment * [ASLayoutSpecPlayground] Fix a few minor issues from the merge with latest master. * Implement layout spec cache * add pager ndoe * add more examples * add more layout examples * [ASLayoutPlayground] Fix merge issues * [ASLayoutPlayground] Fix up the example project from the 2.0 API changes. * [ASLayoutPlayground] Some fixes (#2411) * [ASLayoutPlayground]: Some fixes * Fixed crash when tapping descender. * Fixed setting the item to inspect. * Fixed button states in inspector node. * Added sliders for spacingBefore, spacingAfter, ascender. * [ASLayoutSpecPlayground] Deselect the buttons when editing is over. * [ASLayoutSpecPlayground] Changed flexGrow/Shrink's values from YES/NO to 1.0/0.0 * [Project] Create new Debug/ directory for advanced tools dedicated to debugging. * [LayoutSpecPlayground] Rename project without AS in title, to be consistent with LayoutSpecExamples. * [Bulid] Fix Xcode project to use new Debug subdirectory / group. * [Bulid] Fix a small merge error. * [Build] Fix build issue for Framework target. * [Bulid] Fix podspec to expose InspectorNode header; Remove old-cocoapods emojis from ASDKgram :) * Move aside ASLayoutSpecPlayground-Swift to match master * [LayoutSpecPlayground] Cleanup implementation in several files, xcodeproj, etc. * [ASControlNode] Add comment for new assertion, to be enabled in a separate diff.
119 lines
4.4 KiB
Objective-C
119 lines
4.4 KiB
Objective-C
//
|
|
// ASLayoutSpec.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/ASLayoutElement.h>
|
|
#import <AsyncDisplayKit/ASAsciiArtBoxCreator.h>
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/**
|
|
* A layout spec is an immutable object that describes a layout, loosely inspired by React.
|
|
*/
|
|
@interface ASLayoutSpec : NSObject <ASLayoutElement>
|
|
|
|
/**
|
|
* Creation of a layout spec should only happen by a user in layoutSpecThatFits:. During that method, a
|
|
* layout spec can be created and mutated. Once it is passed back to ASDK, the isMutable flag will be
|
|
* set to NO and any further mutations will cause an assert.
|
|
*/
|
|
@property (nonatomic, assign) BOOL isMutable;
|
|
|
|
/**
|
|
* Parent of the layout spec
|
|
*/
|
|
@property (nullable, nonatomic, weak) id<ASLayoutElement> parent;
|
|
|
|
/**
|
|
* Adds a child to this layout spec using a default identifier.
|
|
*
|
|
* @param child A child to be added.
|
|
*
|
|
* @discussion Every ASLayoutSpec must act on at least one child. The ASLayoutSpec base class takes the
|
|
* responsibility of holding on to the spec children. Some layout specs, like ASInsetLayoutSpec,
|
|
* only require a single child.
|
|
*
|
|
* For layout specs that require a known number of children (ASBackgroundLayoutSpec, for example)
|
|
* a subclass should use this method to set the "primary" child. It can then use setChild:forIdentifier:
|
|
* to set any other required children. Ideally a subclass would hide this from the user, and use the
|
|
* setChild:forIdentifier: internally. For example, ASBackgroundLayoutSpec exposes a backgroundChild
|
|
* property that behind the scenes is calling setChild:forIdentifier:.
|
|
*/
|
|
@property (nullable, strong, nonatomic) id<ASLayoutElement> child;
|
|
|
|
/**
|
|
* Adds childen to this layout spec.
|
|
*
|
|
* @param children An array of ASLayoutElement children to be added.
|
|
*
|
|
* @discussion Every ASLayoutSpec must act on at least one child. The ASLayoutSpec base class takes the
|
|
* reponsibility of holding on to the spec children. Some layout specs, like ASStackLayoutSpec,
|
|
* can take an unknown number of children. In this case, the this method should be used.
|
|
* For good measure, in these layout specs it probably makes sense to define
|
|
* setChild: and setChild:forIdentifier: methods to do something appropriate or to assert.
|
|
*/
|
|
@property (nullable, strong, nonatomic) NSArray<id<ASLayoutElement>> *children;
|
|
|
|
@property (nonatomic, assign) BOOL shouldVisualize;
|
|
@property (nonatomic, assign) BOOL neverShouldVisualize;
|
|
- (void)recursivelySetShouldVisualize:(BOOL)visualize;
|
|
|
|
@end
|
|
|
|
/**
|
|
* An ASLayoutSpec subclass that can wrap one or more ASLayoutElement and calculates the layout based on the
|
|
* sizes of the children. If multiple children are provided the size of the biggest child will be used to for
|
|
* size of this layout spec.
|
|
*/
|
|
@interface ASWrapperLayoutSpec : ASLayoutSpec
|
|
|
|
/*
|
|
* Returns an ASWrapperLayoutSpec object with the given layoutElement as child.
|
|
*/
|
|
+ (instancetype)wrapperWithLayoutElement:(id<ASLayoutElement>)layoutElement AS_WARN_UNUSED_RESULT;
|
|
|
|
/*
|
|
* Returns an ASWrapperLayoutSpec object with the given layoutElements as children.
|
|
*/
|
|
+ (instancetype)wrapperWithLayoutElements:(NSArray<id<ASLayoutElement>> *)layoutElements AS_WARN_UNUSED_RESULT;
|
|
|
|
/*
|
|
* Returns an ASWrapperLayoutSpec object initialized with the given layoutElement as child.
|
|
*/
|
|
- (instancetype)initWithLayoutElement:(id<ASLayoutElement>)layoutElement AS_WARN_UNUSED_RESULT;
|
|
|
|
/*
|
|
* Returns an ASWrapperLayoutSpec object initialized with the given layoutElements as children.
|
|
*/
|
|
- (instancetype)initWithLayoutElements:(NSArray<id<ASLayoutElement>> *)layoutElements AS_WARN_UNUSED_RESULT;
|
|
|
|
/*
|
|
* Init not available for ASWrapperLayoutSpec
|
|
*/
|
|
- (instancetype)init __unavailable;
|
|
|
|
@end
|
|
|
|
@interface ASLayoutSpec (Debugging) <ASLayoutElementAsciiArtProtocol>
|
|
/**
|
|
* Used by other layout specs to create ascii art debug strings
|
|
*/
|
|
+ (NSString *)asciiArtStringForChildren:(NSArray *)children parentName:(NSString *)parentName direction:(ASStackLayoutDirection)direction;
|
|
+ (NSString *)asciiArtStringForChildren:(NSArray *)children parentName:(NSString *)parentName;
|
|
|
|
@end
|
|
|
|
@interface ASLayoutSpec (Deprecated)
|
|
|
|
ASLayoutElementStyleForwardingDeclaration
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|