Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nsomar/OAStackView
Porting UIStackView to iOS 7+
https://github.com/nsomar/OAStackView
Last synced: about 1 month ago
JSON representation
Porting UIStackView to iOS 7+
- Host: GitHub
- URL: https://github.com/nsomar/OAStackView
- Owner: nsomar
- License: mit
- Created: 2015-06-15T23:35:18.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-03-28T19:25:32.000Z (almost 8 years ago)
- Last Synced: 2024-10-29T17:59:20.286Z (3 months ago)
- Language: Objective-C
- Homepage:
- Size: 5.02 MB
- Stars: 2,141
- Watchers: 65
- Forks: 191
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios-star - OAStackView - OAStackView tries to port back the stackview to iOS 7+. OAStackView aims at replicating all the features in UIStackView. (UI / Font)
- awesome-ios - OAStackView - OAStackView tries to port back the stackview to iOS 7+. OAStackView aims at replicating all the features in UIStackView. (UI / Font)
README
# OAStackView
[](https://travis-ci.org/oarrabi/OAStackView)
[](http://cocoapods.org/pods/OAStackView)
[](http://cocoapods.org/pods/OAStackView)
[](http://cocoapods.org/pods/OAStackView)
iOS 9 introduced the very cool [UIStackView](https://developer.apple.com/library/prerelease/ios/documentation/UIKit/Reference/UIStackView_Class_Reference/), UIStackView can be used to easily create simple and complex layouts.
As expected `UIStackView` can only be used for iOS 9 and up. This project tries to port back the stackview to iOS 7+.
`OAStackView` aims at replicating all the features in `UIStackView`
## Usage
To run the example project, clone the repo, and run `pod install` from the Example directory first.
Since `OAStackView` mimics the interface of `UIStackView`, the usage of `OAStackView` is similar to `UIStackView`.
`OAStackView` Can be either used from the Interface builder, or from code.
### Interface Builder
Drag a a UIView into your view controller, and add some views to it.
Change the class to `OAStackView`
(Optional) Change the stack Axis (set Axis Value to 0 for Horizontal or 1 for Vertical), Spacing, Alignment or distribution.
Run the project!
### From Code
To use `OAStackView` from code, Please refer to [UIStackView](https://developer.apple.com/library/prerelease/ios/documentation/UIKit/Reference/UIStackView_Class_Reference/) for proper documentation.
As a quick example on its usage do the following:
Create a couple of views to be stacked:
```objc
UILabel *l1 = [[UILabel alloc] init];
l1.text = @"Label 1";
UILabel *l2 = [[UILabel alloc] init];
l2.text = @"Label 2";
```
Create the stack view passing the array of views:
```objc
OAStackView *stackView = [[OAStackView alloc] initWithArrangedSubviews:@[l1, l2]];
stackView.translatesAutoresizingMaskIntoConstraints = NO;
```
Add the stack view to `self.view`
```objc
[self.view addSubview:stackView];
[self.view addConstraints:[NSLayoutConstraint constraintsWithVisualFormat:@"V:|-30-[stackView]"
options:0
metrics:0
views:NSDictionaryOfVariableBindings(stackView)]];
[self.view addConstraints:[NSLayoutConstraint constraintsWithVisualFormat:@"H:|-10-[stackView]"
options:0
metrics:0
views:NSDictionaryOfVariableBindings(stackView)]];
```
## Installation
OAStackView is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod "OAStackView"
```
## Tests
Since `OAStackView` has been built from reverse engineering `UIStackView`, and since I intend to keep updating and refactoring `OAStackView`, tests was one of the requirements going forward.
The following a [human readable](https://raw.githubusercontent.com/oarrabi/OAStackView/master/Example/Tests/tests.transcript.txt?token=ABZLPOoXoCREu-BpaaIEVcTY5i1icbkrks5ViJ_9wA%3D%3D) text subscript (generated with [specipy](https://github.com/oarrabi/specipy)).
## Contribution
All contributions in any form are welcomed, if you find the project helpful, and you want to contribute then please do.
## Known Issues, and future improvements
### Missing functionality
`OAStackView` implements most of the features from `UIStackView` except the following:
- [ ] `baselineRelativeArrangement`
@property(nonatomic,getter=isBaselineRelativeArrangement) BOOL baselineRelativeArrangement;
- [x] `layoutMarginsRelativeArrangement`
@property(nonatomic,getter=isLayoutMarginsRelativeArrangement) BOOL layoutMarginsRelativeArrangement;
`UIStackViewDistribution` is also partially implemented (2 elements out of 5 are still not implemented)
- [x] `UIStackViewDistributionFill`
- [x] `UIStackViewDistributionFillEqually`
- [x] `UIStackViewDistributionFillProportionally`
- [ ] `UIStackViewDistributionEqualSpacing`
- [ ] `UIStackViewDistributionEqualCentering`
Please refer to [UIStackView](https://developer.apple.com/library/prerelease/ios/documentation/UIKit/Reference/UIStackView_Class_Reference/) for proper documentation.
### Future improvements
The following would be nice to have for future versions
- [ ] Covering the remaining functionality from `UIStackView`
- [ ] Better Documentation
- [ ] Better test coverage for some edge cases
- [ ] Rewrite in swift, or more swift friendly
## Author
Omar Abdelhafith, [email protected]
## License
OAStackView is available under the MIT license. See the LICENSE file for more info.