ASStackLayoutSpec Class Reference

Inherits from ASLayoutSpec : NSObject
Declared in ASStackLayoutSpec.h

Overview

A simple layout spec that stacks a list of children vertically or horizontally.

  • All children are initially laid out with the an infinite available size in the stacking direction.
  • In the other direction, this spec’s constraint is passed.
  • The children’s sizes are summed in the stacking direction.
    • If this sum is less than this spec’s minimum size in stacking direction, children with flexGrow are flexed.
    • If it is greater than this spec’s maximum size in the stacking direction, children with flexShrink are flexed.
    • If, even after flexing, the sum is still greater than this spec’s maximum size in the stacking direction, justifyContent determines how children are laid out.

For example:

  • Suppose stacking direction is Vertical, min-width=100, max-width=300, min-height=200, max-height=500.
  • All children are laid out with min-width=100, max-width=300, min-height=0, max-height=INFINITY.
  • If the sum of the childrens' heights is less than 200, children with flexGrow are flexed larger.
  • If the sum of the childrens' heights is greater than 500, children with flexShrink are flexed smaller. Each child is shrunk by ((sum of heights) - 500)/(number of flexShrink-able children).
  • If the sum of the childrens' heights is greater than 500 even after flexShrink-able children are flexed, justifyContent determines how children are laid out.

  direction

Specifies the direction children are stacked in.

@property (nonatomic, assign) ASStackLayoutDirection direction

Declared In

ASStackLayoutSpec.h

  spacing

The amount of space between each child.

@property (nonatomic, assign) CGFloat spacing

Declared In

ASStackLayoutSpec.h

  justifyContent

The amount of space between each child.

@property (nonatomic, assign) ASStackLayoutJustifyContent justifyContent

Declared In

ASStackLayoutSpec.h

  alignItems

Orientation of children along cross axis

@property (nonatomic, assign) ASStackLayoutAlignItems alignItems

Declared In

ASStackLayoutSpec.h

  baselineRelativeArrangement

If YES the vertical spacing between two views is measured from the last baseline of the top view to the top of the bottom view

@property (nonatomic, assign) BOOL baselineRelativeArrangement

Declared In

ASStackLayoutSpec.h

+ stackLayoutSpecWithDirection:spacing:justifyContent:alignItems:children:

The direction of the stack view (horizontal or vertical)

+ (instancetype)stackLayoutSpecWithDirection:(ASStackLayoutDirection)direction spacing:(CGFloat)spacing justifyContent:(ASStackLayoutJustifyContent)justifyContent alignItems:(ASStackLayoutAlignItems)alignItems children:(NSArray *)children

Parameters

direction

The direction of the stack view (horizontal or vertical)
spacing

The spacing between the children
justifyContent

If no children are flexible, this describes how to fill any extra space
alignItems

Orientation of the children along the cross axis
children

ASLayoutable children to be positioned.

Declared In

ASStackLayoutSpec.h