AsyncDisplayKit/_docs/containers-aspagernode.md

title, layout, permalink, prevPage, nextPage

title	layout	permalink	prevPage	nextPage
ASPagerNode	docs	/docs/containers-aspagernode.html	containers-ascollectionnode.html	display-node.html

ASPagerNode is a subclass of ASCollectionNode with a specific UICollectionViewLayout used under the hood.

Using it allows you to produce a page style UI similar to what you'd create with UIKit's UIPageViewController. ASPagerNode currently supports staying on the correct page during rotation. It does not currently support circular scrolling.

The main dataSource methods are:

SwiftObjective-C

- (NSInteger)numberOfPagesInPagerNode:(ASPagerNode *)pagerNode

func numberOfPagesInPagerNode(pagerNode: ASPagerNode!) -> Int 

and

SwiftObjective-C

- (ASCellNode *)pagerNode:(ASPagerNode *)pagerNode nodeAtIndex:(NSInteger)index

func pagerNode(pagerNode: ASPagerNode!, nodeAtIndex index: Int) -> ASCellNode!

or

SwiftObjective-C

- (ASCellNodeBlock)pagerNode:(ASPagerNode *)pagerNode nodeBlockAtIndex:(NSInteger)index`

func pagerNode(pagerNode: ASPagerNode!, nodeBlockAtIndex index: Int) -> ASCellNodeBlock!

These two methods, just as with ASCollectionNode and ASTableNode need to return either an ASCellNode or an ASCellNodeBlock - a block that creates an ASCellNode and can be run on a background thread.

Note that neither methods should rely on cell reuse (they will be called once per row). Also, unlike UIKit, these methods are not called when the row is just about to display.

While -pagerNode:nodeAtIndex: will be called on the main thread, -pagerNode:nodeBlockAtIndex: is preferred because it concurrently allocates cell nodes, meaning that the -init: method of each of your subnodes will be run in the background. It is very important that node blocks be thread-safe as they can be called on the main thread or a background queue.

Node Block Thread Safety Warning

It is imperative that the data model be accessed outside of the node block. This means that it is highly unlikely that you should need to use the index inside of the block.

In the example below, you can see how the index is used to access the photo model before creating the node block.

SwiftObjective-C

- (ASCellNodeBlock)pagerNode:(ASPagerNode *)pagerNode nodeBlockAtIndex:(NSInteger)index
{
  PhotoModel *photoModel = _photoFeed[index];
// this part can be executed on a background thread - it is important to make sure it is thread safe!
ASCellNode *(^cellNodeBlock)() = ^ASCellNode *() {
PhotoCellNode *cellNode = [[PhotoCellNode alloc] initWithPhoto:photoModel];
return cellNode;
};
return cellNodeBlock;
}

func pagerNode(pagerNode: ASPagerNode!, nodeBlockAtIndex index: Int) -> ASCellNodeBlock! {
    guard photoFeed.count > index else { return nil }
    
    let photoModel = photoFeed[index]
    let cellNodeBlock = { () -> ASCellNode in
        let cellNode = PhotoCellNode(photo: photoModel)
        return cellNode
    }
    return cellNodeBlock
}

Using an ASViewController For Optimal Performance

One especially useful pattern is to return an ASCellNode that is initialized with an existing UIViewController or ASViewController. For optimal performance, use an ASViewController.

SwiftObjective-C

- (ASCellNode *)pagerNode:(ASPagerNode *)pagerNode nodeAtIndex:(NSInteger)index
{
    NSArray *animals = self.animals[index];
ASCellNode *node = [[ASCellNode alloc] initWithViewControllerBlock:^{
    return [[AnimalTableNodeController alloc] initWithAnimals:animals];;
} didLoadBlock:nil];

node.preferredFrameSize = pagerNode.bounds.size;

return node;

}

func pagerNode(pagerNode: ASPagerNode!, nodeAtIndex index: Int) -> ASCellNode! {
    guard animals.count > index else { return nil }

    let animal = animals[index]
    let node = ASCellNode(viewControllerBlock: { () -> UIViewController in
      return AnimalTableNodeController(animals: animals)
    }, didLoadBlock: nil)

    node.preferredFrameSize = pagerNode.bounds.size

    return node
}

In this example, you can see that the node is constructed using the -initWithViewControllerBlock: method. It is usually necessary to provide a cell created this way with a preferredFrameSize so that it can be laid out correctly.

Sample Apps

Check out the following sample apps to see an ASPagerNode in action:

• PagerNode
• VerticalWithinHorizontalScrolling