Swiftgram/AsyncDisplayKit/ASCellNode+Internal.h
Scott Goodson f71eba77af [ASCollectionView] Finish support for interoperability with base-class UICollectionViewCells.
This also supports supplementary nodes. It builds off of Adlai's .interop flag but makes necessary
improvements for all of the delegate methods to work in practice with heterogenous cell types.
2017-02-04 20:40:44 -08:00

73 lines
2.5 KiB
Objective-C

//
// ASCellNode+Internal.h
// AsyncDisplayKit
//
// Created by Max Gu on 2/19/16.
//
// 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/ASCellNode.h>
NS_ASSUME_NONNULL_BEGIN
@protocol ASCellNodeInteractionDelegate <NSObject>
/**
* Notifies the delegate that the specified cell node has done a relayout.
* The notification is done on main thread.
*
* This will not be called due to measurement passes before the node has loaded
* its view, even if triggered by -setNeedsLayout, as it is assumed these are
* not relevant to UIKit. Indeed, these calls can cause consistency issues.
*
* @param node A node informing the delegate about the relayout.
* @param sizeChanged `YES` if the node's `calculatedSize` changed during the relayout, `NO` otherwise.
*/
- (void)nodeDidRelayout:(ASCellNode *)node sizeChanged:(BOOL)sizeChanged;
/*
* Methods to be called whenever the selection or highlight state changes
* on ASCellNode. UIKit internally stores these values to update reusable cells.
*/
- (void)nodeSelectedStateDidChange:(ASCellNode *)node;
- (void)nodeHighlightedStateDidChange:(ASCellNode *)node;
@end
@interface ASCellNode ()
@property (nonatomic, weak) id <ASCellNodeInteractionDelegate> interactionDelegate;
/*
* Back-pointer to the containing scrollView instance, set only for visible cells. Used for Cell Visibility Event callbacks.
*/
@property (nonatomic, weak) UIScrollView *scrollView;
- (void)__setSelectedFromUIKit:(BOOL)selected;
- (void)__setHighlightedFromUIKit:(BOOL)highlighted;
/**
* @note This could be declared @c copy, but since this is only settable internally, we can ensure
* that it's always safe simply to retain it, and copy if needed. Since @c UICollectionViewLayoutAttributes
* is always mutable, @c copy is never "free" like it is for e.g. NSString.
*/
@property (nonatomic, strong, nullable) UICollectionViewLayoutAttributes *layoutAttributes;
/// readwrite variant of the readonly public property.
@property (nonatomic, copy, nullable) NSString *supplementaryElementKind;
@property (nonatomic, copy, nullable) NSIndexPath *cachedIndexPath;
@property (nonatomic, weak, nullable) ASDisplayNode *owningNode;
@property (nonatomic, assign) BOOL shouldUseUIKitCell;
@end
NS_ASSUME_NONNULL_END