ASDisplayNode(Beta) Category Reference

Declared in ASDisplayNode+Beta.h

+ suppressesInvalidCollectionUpdateExceptions

ASTableView and ASCollectionView now throw exceptions on invalid updates like their UIKit counterparts. If YES, these classes will log messages on invalid updates rather than throwing exceptions.

+ (BOOL)suppressesInvalidCollectionUpdateExceptions

Discussion

Note that even if AsyncDisplayKit’s exception is suppressed, the app may still crash as it proceeds with an invalid update.

This property defaults to NO. It will be removed in a future release.

Declared In

ASDisplayNode+Beta.h

– recursivelyEnsureDisplaySynchronously:

Recursively ensures node and all subnodes are displayed.

- (void)recursivelyEnsureDisplaySynchronously:(BOOL)synchronously

Declared In

ASDisplayNode+Beta.h

  willDisplayNodeContentWithRenderingContext

allow modification of a context before the node’s content is drawn

@property (nonatomic, copy, nullable) ASDisplayNodeContextModifier willDisplayNodeContentWithRenderingContext

Discussion

Set the block to be called after the context has been created and before the node’s content is drawn. You can override this to modify the context before the content is drawn. You are responsible for saving and restoring context if necessary. Restoring can be done in contextDidDisplayNodeContent This block can be called from any thread and it is unsafe to access any UIKit main thread properties from it.

Declared In

ASDisplayNode+Beta.h

  didDisplayNodeContentWithRenderingContext

allow modification of a context after the node’s content is drawn

@property (nonatomic, copy, nullable) ASDisplayNodeContextModifier didDisplayNodeContentWithRenderingContext

Declared In

ASDisplayNode+Beta.h

  measurementOptions

A bitmask representing which actions (layout spec, layout generation) should be measured.

@property (nonatomic, assign) ASDisplayNodePerformanceMeasurementOptions measurementOptions

Declared In

ASDisplayNode+Beta.h

  performanceMeasurements

A simple struct representing performance measurements collected.

@property (nonatomic, assign, readonly) ASDisplayNodePerformanceMeasurements performanceMeasurements

Declared In

ASDisplayNode+Beta.h

– placeholderShouldPersist

Currently used by ASNetworkImageNode and ASMultiplexImageNode to allow their placeholders to stay if they are loading an image from the network. Otherwise, a display pass is scheduled and completes, but does not actually draw anything - and ASDisplayNode considers the element finished.

- (BOOL)placeholderShouldPersist

Declared In

ASDisplayNode+Beta.h

– hierarchyDisplayDidFinish

Indicates that the receiver and all subnodes have finished displaying. May be called more than once, for example if the receiver has a network image node. This is called after the first display pass even if network image nodes have not downloaded anything (text would be done, and other nodes that are ready to do their final display). Each render of every progressive jpeg network node would cause this to be called, so this hook could be called up to 1 + (pJPEGcount * pJPEGrenderCount) times. The render count depends on how many times the downloader calls the progressImage block.

- (void)hierarchyDisplayDidFinish

Declared In

ASDisplayNode+Beta.h

+ setRangeModeForMemoryWarnings:

Only ASLayoutRangeModeVisibleOnly or ASLayoutRangeModeLowMemory are recommended. Default is ASLayoutRangeModeVisibleOnly, because this is the only way to ensure an application will not have blank / flashing views as the user navigates back after a memory warning. Apps that wish to use the more effective / aggressive ASLayoutRangeModeLowMemory may need to take steps to mitigate this behavior, including: restoring a larger range mode to the next controller before the user navigates there, enabling .neverShowPlaceholders on ASCellNodes so that the navigation operation is blocked on redisplay completing, etc.

+ (void)setRangeModeForMemoryWarnings:(ASLayoutRangeMode)rangeMode

Declared In

ASDisplayNode+Beta.h

– _logEventWithBacktrace:format:

The primitive event tracing method. You shouldn’t call this. Use the ASDisplayNodeLogEvent macro instead.

- (void)_logEventWithBacktrace:(NSArray<NSString*> *)backtrace format:(NSString *)format, ...

Declared In

ASDisplayNode+Beta.h

  eventLog

The most recent trace events for this node. Max count is ASDISPLAYNODE_EVENTLOG_CAPACITY.

@property (readonly, copy) NSArray *eventLog

Declared In

ASDisplayNode+Beta.h