Latest 1.0.0
Homepage https://github.com/lurui1029/LRCustomSpacingStackView
License MIT
Platforms ios 9.0
Frameworks UIKit
Authors

Pod Version
Pod Platform
Pod License

UIStackView officially supports custom spacing after iOS 11. This library makes it easier to use, and also work on iOS 9.

Features

  • [x] Custom spacing support on iOS 9 and above
  • [X] Spacing after and/or before the arrangedView
  • [X] Spacing between the arrangedView and the UIStackView
  • [X] Works with all UIStackView’s existing functionalities. including inserting and removing arrangedSubviews, getting arrangedSubviews, even animating spacing changes. Everything just works.

Requirements

  • iOS 9.0 and above
  • Swift 4.2
  • Auto Layout

How to use

import LRCustomSpacingStackView

stackView.lr_addArrangedSubview(view1)
view1.lr_stackSpacing = UIEdgeInsets(top: 20, left: 30, bottom: 10, right: 0)
  1. Set up your stack view and subviews using Auto Layout. For more, see Auto Layout with UIStackView
  2. Use extension methods provided by this library, instead of UIStackView‘s builtin methods, to add UIViews to UIStackView
  3. custom UIView‘s spacing by setting its lr_stackSpacing property, instead of setCustomSpacing(_:after:)

Simply speaking, use APIs on the left each time you want to use APIs on the right, and everything else would be covered for you.

This library’s extensions UIStackView
init(lr_arrangedSubviews:) UIStackView.init(arrangedSubviews:)
lr_arrangedSubviews UIStackView.arrangedSubviews
lraddArrangedSubview(:) UIStackView.addArrangedSubview(_:)
lrremoveArrangedSubview(:) UIStackView.removeArrangedSubview(_:)
lrinsertArrangedSubview(:at:) UIStackView.insertArrangedSubview(_:at:)
UIView.lr_stackSpacing UIStackView.setCustomSpacing(_:after:)

See Wiki for a detailed documentation (Not completed yet)

Installation with CocoaPods

CocoaPods is a dependency manager for Objective-C and Swift, which automates and simplifies the process of using 3rd-party libraries in your projects. See the Get Started section for more details.

Podfile

platform: ios, '9.0'

pod 'LRCustomSpacingStackView', '~> 1.0.0'

Manual Installation

Simply download UIStackView+LRCustomSpacing.swift, drag it to your project.

Note

This library is designed to support custom spacing for UIStackView without breaking any builtin behaviors, but custom spacing you specified in UIView‘s lr_stackSpacing property has the highest priority in the final layout. That is:

  1. You can set UIStackView.spacing to add a fixed spacing for all subviews, and then set some subviews’ lr_stackSpacing for extra spacings.

  2. You can still use setCustomSpacing(_:after:), although you don’t have to in almost all cases.

  3. It is still your responsibility to make sure your stack view is free of conflicts. Nothing is different from setting up a regular UIStackView using Auto Layout, except that a subview’s size in the eye of the stack view is actually the sum of the subview’s size and its lr_stackSpacing insets. This may cause conflicts sometimes. For example, if your stack view’s axis is vertical and width is 300, a subview’s width is also 300, in this case, this subview’s width + lr_stackSpacing.left + lr_stackSpacing.right must <= 300. Otherwise, the stack view considers this subview’s width is larger than its own width, which is a conflict for a vertical stack view. To prevent this, set up your subview’s size with a low priority (so that the stack view can resize subviews based on its axis, spacing, distribution and alignment), or make the stack view self-growing at its axis.

A good practice is to, always set up your stack view and subviews using regular UIStackView APIs, make sure it is free of conflicts, after that, replace builtin methods with this library’s

PRs and Issues are welcome.

Latest podspec

{
    "name": "LRCustomSpacingStackView",
    "version": "1.0.0",
    "summary": "An UIStackView extension to support custom (left, right, top, bottom) spacing for arrangedSubviews.",
    "description": "UIStackView supports custom spacing along its axis after iOS 11.0.nnThis library:n1. provides custom spacing support for iOS 9.0 +n2. provides a more flexible and powerful way to add custom spacing by giving UIView a UIEdgeInsetsn3. works well with all UIStackView's functionalitiesnnRequirements:n1. iOS 9.0 +n2. Swift 4.2n3. uses Auto Layout",
    "homepage": "https://github.com/lurui1029/LRCustomSpacingStackView",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Lu Rui": "[email protected]"
    },
    "platforms": {
        "ios": "9.0"
    },
    "source": {
        "git": "https://github.com/lurui1029/LRCustomSpacingStackView.git",
        "tag": "1.0.0"
    },
    "source_files": "*.swift",
    "frameworks": "UIKit",
    "swift_version": "4.2"
}

Pin It on Pinterest

Share This