mirror of
https://github.com/Swiftgram/Telegram-iOS.git
synced 2025-09-01 18:33:10 +00:00
2cda73a334
* [ASTextNode2] Provide compiler flag to enable ASTextNode2 for all usages. The runtime switch is helpful, but is too slow to be shipped in a large production application where startup time is carefully optimized. Although this doesn't pass text-related snapshot tests when enabled, it does allow apps to rely on built-in components like ASButtonNode using the same text stack as when they are manually creating ASTextNode2 instances. A simpler approach would be to use a #define ASTextNode ASTextNode2, but this would create unusual keyword highlighting in code referencing ASTextNode. However, because it would be less invasive and this is not on by default, we could do that instead if preferred. * Update AsyncDisplayKit.h * [ASTextNode2] Improve naming and documentation of ASTEXTNODE_EXPERIMENT_GLOBAL_ENABLE * [ASTextNode2] CHANGELOG.md for #410.
71 lines
2.9 KiB
Objective-C
71 lines
2.9 KiB
Objective-C
//
|
|
// ASTextNode+Beta.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 <UIKit/UIKit.h>
|
|
|
|
#import <AsyncDisplayKit/ASTextNode.h>
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
// When enabled, use ASTextNode2 for subclasses, random instances, or all instances of ASTextNode.
|
|
// See ASAvailability.h declaration of ASTEXTNODE_EXPERIMENT_GLOBAL_ENABLE for a compile-time option.
|
|
typedef NS_OPTIONS(NSUInteger, ASTextNodeExperimentOptions) {
|
|
// All subclass instances use the experimental implementation.
|
|
ASTextNodeExperimentSubclasses = 1 << 0,
|
|
// Random instances of ASTextNode (50% chance) (not subclasses) use experimental impl.
|
|
// Useful for profiling with apps that have no custom text node subclasses.
|
|
ASTextNodeExperimentRandomInstances = 1 << 1,
|
|
// All instances of ASTextNode itself use experimental implementation. Supersedes `.randomInstances`.
|
|
ASTextNodeExperimentAllInstances = 1 << 2,
|
|
// Add highlighting etc. for debugging.
|
|
ASTextNodeExperimentDebugging = 1 << 3
|
|
};
|
|
|
|
@interface ASTextNode ()
|
|
|
|
/**
|
|
@abstract An array of descending scale factors that will be applied to this text node to try to make it fit within its constrained size
|
|
@discussion This array should be in descending order and NOT contain the scale factor 1.0. For example, it could return @[@(.9), @(.85), @(.8)];
|
|
@default nil (no scaling)
|
|
*/
|
|
@property (nullable, nonatomic, copy) NSArray<NSNumber *> *pointSizeScaleFactors;
|
|
|
|
/**
|
|
@abstract Text margins for text laid out in the text node.
|
|
@discussion defaults to UIEdgeInsetsZero.
|
|
This property can be useful for handling text which does not fit within the view by default. An example: like UILabel,
|
|
ASTextNode will clip the left and right of the string "judar" if it's rendered in an italicised font.
|
|
*/
|
|
@property (nonatomic, assign) UIEdgeInsets textContainerInset;
|
|
|
|
/**
|
|
* Opt in to an experimental implementation of text node. The implementation may improve performance and correctness,
|
|
* but may not support all features and has not been thoroughly tested in production.
|
|
*
|
|
* @precondition You may not call this after allocating any text nodes. You may only call this once.
|
|
*/
|
|
+ (void)setExperimentOptions:(ASTextNodeExperimentOptions)options;
|
|
|
|
/**
|
|
* Returns YES if this node is using the experimental implementation. NO otherwise. Will not change.
|
|
*/
|
|
@property (atomic, readonly) BOOL usingExperiment;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|