appleguy 55928f343d [Yoga] Rewrite YOGA_TREE_CONTIGUOUS mode with improved behavior and cleaner integration (#343)
* [Yoga] Rewrite YOGA_TREE_CONTIGUOUS mode with support for mixing with ASLayoutSpec.

After experimentation with the ASYogaLayoutSpec (or non-contiguous) approach to
integrating Yoga, test results and feedback from the authors of Yoga have shown
that this approach can't be made completely correct,

There are issues with some of the features required to represent Web-style
flexbox; in particular: padding, margins, and border handling have varience.

This diff is a first step towards a truly correct and elegant implementation of
Yoga integration with Texture. In addition to reducing the footprint of
the integration, which is an explicit goal of work at this stage, these changes
already support improved behavior - including mixing between ASLayoutSpecs
even as subnodes of Yoga layout-driven nodes, in addition to above them. Yoga
may be used for any set of nodes.

Because Yoga usage is limited at this time, it's safe to merge this diff and
further improvements will be refinements in this direction.

* [ASDKgram] Add Yoga layout implementation for PhotoCellNode.

* [Yoga] Final fixes for the upgraded implementation of the Contiguous layout mode.

* [Yoga] Add CHANGELOG.md entry and fix for Yoga rounding to screen scale.

* [Yoga] Minor cleanup to remove old comments and generalize utility methods.
2017-06-14 19:36:13 -07:00
..
2017-04-14 09:37:38 -07:00
2017-04-14 09:37:38 -07:00
2017-04-14 09:37:38 -07:00
2017-04-14 09:37:38 -07:00
2017-04-14 09:37:38 -07:00
2017-04-14 09:37:38 -07:00
2017-04-14 09:37:38 -07:00

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

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.