Introduction

PinStackView was a StackView relies on PinLayout.

Features

• can be used with manual layout, Autolayout
• is a real view and only layout specified sub-views
• has inner padding
• has equal distribution like UIStackView
• has auto style with dynamic length in axis direction

Usage

using cocoapods, import as local directory

examples listed in project 'Views/' group

$ cd Example
$ pod install
$ open Example.xcworkspace

PinStackView

Interface

• addItems(): add managed sub-views, return PinStackItemInfo for chained setting, you can addSubviews() and layout view by yourself
• insertItem(): like addItems(), can defined sequence
• removeItem(): remove managed sub-views, also removed from subviews
• itemForView(): get PinStackItemInfo from PinStackView after addItem() or insertItem()
• define(): a sugar to chain items info definition
• markDirty(): like setNeesLayout(), force layout in next view update

Properties

• style: default .fixed, the axis length will not change after layout; .auto style means its axis length will change by items
• axis: .horizontal or .vertical direction, dynamic length direction
• distribution: axis direction layout style, .equal only support .fixed style; .auto style always .start
• alignment: cross axis direction, you can specify view's alignment by alignSelf()
• spacing: spacing between items in axis direction
• padding: items will layout after padding
• autoSizeChangedCallback: in .auto style, when PinStackView bounds changed, it will callback for you to change superview's layout if needed

PinStackItemInfo

PinStackItemInfo was each item's layout definition, you will get instance after addItem(), you can chaned interface below

• top(): top margin, points or inner height ratio after padding
• bottom(): bottom margin, points or inner height ratio after padding
• left(): left margin, points or inner width ratio after padding
• right(): right margin, points or inner width ratio after padding
• width(): points or inner width ratio after padding
• height(): points or inner height ratio after padding
• size(): high priority than width() and height(), points or ratio after padding
• alignSelf(): high priroty than PinStackView's alignment, only for this item
• grow(): in .fixed style and .start / .end distribution, it means item using dynamic length in axis direction after all fixed items length acumulated; no meanings in .equal distribution or .auto style

Coding Example

using Then from Suyeol Jeon

    lazy var stackView = PinStackView().then {
        $0.style = .auto
        $0.axis = .horizontal
        $0.alignment = .center
        $0.distribution = .start
        $0.spacing = 10
        $0.addItem(v1).left(20)
        $0.addItem(v2).size(20)
        $0.addItem(v3)
        $0.addItem(v4).size(30).right(20)
    }