Branch: master
Find file History
Adlai-Holler Add extension points for global node behaviors, potentially replacing…
… interface state delegates (#1229)

* Add extension points for global node behaviors via categories and a public ivar

* Update documentation on context ivar
Latest commit 6e7cdea Feb 14, 2019
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
ASCollectionView [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
ASDKLayoutTransition [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
ASDKTube [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
ASDKgram Add Yoga layout to ASDKGram Texture cells (#1315) Jan 18, 2019
ASMapNode [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
ASViewController [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
AnimatedGIF [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
AsyncDisplayKitOverview [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
CatDealsCollectionView Add extension points for global node behaviors, potentially replacing… Feb 14, 2019
CustomCollectionView-Swift [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
CustomCollectionView [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
HorizontalWithinVerticalScrolling [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
Kittens Don’t handle touches on additional attributed message if passthrough… Oct 24, 2018
LayoutSpecExamples-Swift [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
LayoutSpecExamples [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
PagerNode [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
SocialAppLayout-Inverted [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
SocialAppLayout [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
Swift [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
VerticalWithinHorizontalScrolling [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
Videos [License] Simplify the Texture license to be pure Apache 2 (removing … Aug 28, 2018
README.md [ASCornerLayoutSpec] New layout spec class for declarative corner ele… Nov 24, 2017

README.md

Sample projects

Building

Run pod install in each sample project directory to set up their dependencies.

Example Catalog

ASCollectionView [ObjC]

ASCollectionView Example App Screenshot

Featuring:

  • ASCollectionView with header/footer supplementary node support
  • ASCollectionView batch API
  • ASDelegateProxy

ASDKgram [ObjC]

ASDKgram Example App Screenshot

ASDKLayoutTransition [ObjC]

ASDKLayoutTransition Example App

ASDKTube [ObjC]

ASDKTube Example App

ASMapNode [ObjC]

ASMapNode Example App Screenshot

ASTableViewStressTest [ObjC]

ASTableViewStressTest Example App Screenshot

ASViewController [ObjC]

ASViewController Example App Screenshot

Featuring:

  • ASViewController
  • ASTableView
  • ASMultiplexImageNode
  • ASLayoutSpec

AsyncDisplayKitOverview [ObjC]

AsyncDisplayKitOverview Example App Screenshot

BackgroundPropertySetting [Swift]

BackgroundPropertySetting Example App gif

Featuring:

  • ASDK Swift compatibility
  • ASViewController
  • ASCollectionView
  • thread affinity
  • ASLayoutSpec

CarthageBuildTest

CatDealsCollectionView [ObjC]

CatDealsCollectionView Example App Screenshot

Featuring:

  • ASCollectionView
  • ASRangeTuningParameters
  • Placeholder Images
  • ASLayoutSpec

CollectionViewWithViewControllerCells [ObjC]

CollectionViewWithViewControllerCells Example App Screenshot

Featuring:

  • custom collection view layout
  • ASLayoutSpec
  • ASMultiplexImageNode

CustomCollectionView [ObjC+Swift]

CustomCollectionView Example App gif

Featuring:

  • custom collection view layout
  • ASCollectionView with sections

EditableText [ObjC]

EditableText Example App Screenshot

Featuring:

  • ASEditableTextNode

HorizontalwithinVerticalScrolling [ObjC]

HorizontalwithinVerticalScrolling Example App gif

Featuring:

  • UIViewController with ASTableView
  • ASCollectionView
  • ASCellNode

Kittens [ObjC]

Kittens Example App Screenshot

Featuring:

  • UIViewController with ASTableView
  • ASCellNodes with ASNetworkImageNode and ASTextNode

LayoutSpecPlayground [ObjC]

LayoutSpecPlayground Example App Screenshot

Multiplex [ObjC]

Multiplex Example App

Featuring:

  • ASMultiplexImageNode (with artificial delay inserted)
  • ASLayoutSpec

PagerNode [ObjC]

PagerNode Example App

Featuring:

  • ASPagerNode

Placeholders [ObjC]

Featuring:

  • ASDisplayNodes now have an overidable method -placeholderImage that lets you provide a custom UIImage to display while a node is displaying asyncronously. The default implementation of this method returns nil and thus does nothing. A provided example project also demonstrates using the placeholder API.

SocialAppLayout [ObjC]

SocialAppLayout Example App Screenshot

Featuring:

  • ASLayoutSpec
  • UIViewController with ASTableView

Swift [Swift]

Swift Example App Screenshot

Featuring:

  • ASViewController with ASTableNode

SynchronousConcurrency [ObjC]

SynchronousConcurrency Example App Screenshot

Implementation of Synchronous Concurrency features for AsyncDisplayKit 2.0

This provides internal features on _ASAsyncTransaction and ASDisplayNode to facilitate implementing public API that allows clients to choose if they would prefer to block on the completion of unfinished rendering, rather than allow a placeholder state to become visible.

The internal features are: -[_ASAsyncTransaction waitUntilComplete] -[ASDisplayNode recursivelyEnsureDisplay]

Also provided are two such implementations: -[ASCellNode setNeverShowPlaceholders:], which integrates with both Tables and Collections -[ASViewController setNeverShowPlaceholders:], which should work with Nav and Tab controllers.

Lastly, on ASDisplayNode, a new property .shouldBypassEnsureDisplay allows individual node types to exempt themselves from blocking the main thread on their display.

By implementing the feature at the ASCellNode level rather than ASTableView & ASCollectionView, developers can retain fine-grained control on display characteristics. For example, certain cell types may be appropriate to display to the user with placeholders, whereas others may not.

SynchronousKittens [ObjC]

VerticalWithinHorizontalScrolling [ObjC]

VerticalWithinHorizontalScrolling Example App

Features:

  • UIViewController containing ASPagerNode containing ASTableNodes

Videos [ObjC]

VideoTableView Example App gif

Featuring:

  • ASVideoNode

VideoTableView [ObjC]

VideoTableView Example App Screenshot

Featuring:

  • ASVideoNode
  • ASTableView
  • ASCellNode

LayoutSpecExamples [ObjC]

Layout Spec Example App Screenshot

Featuring:

  • ASStackLayoutSpec
  • ASInsetLayoutSpec
  • ASOverlayLayoutSpec
  • ASAbsoluteLayoutSpec
  • ASBackgroundLayoutSpec
  • ASCornerLayoutSpec

There is an associated swift version app: LayoutSpecExamples-Swift with same logic implementation.

License

This file provided by Facebook is for non-commercial testing and evaluation
purposes only.  Facebook reserves all rights not expressly granted.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
FACEBOOK BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.