ORStackView 使用教程

ORStackView 使用教程

ORStackViewVertically stack views using Auto Layout, with an order specific subclass that uses view tags for ordering.项目地址:https://gitcode.com/gh_mirrors/or/ORStackView

1、项目介绍

ORStackView 是一个用于垂直堆叠视图的 Auto Layout 子类，它使用视图标签来指定顺序。尽管 UIStackView 已经存在，但 ORStackView 在某些方面仍然有其独特的优势，例如视图控制器和内部边距的设置。然而，考虑到未来的兼容性和发展，建议在新项目中谨慎使用 ORStackView。

2、项目快速启动

安装

ORStackView 可以通过 CocoaPods 进行安装。在你的 Podfile 中添加以下行：

pod 'ORStackView'

然后运行 pod install。

基本使用

以下是一个简单的示例，展示如何创建一个 ORStackView 并添加子视图：

#import "ORStackView.h"

- (void)loadView {
    self.view = [[ORStackView alloc] init];
}

- (void)viewDidLoad {
    ORStackView *stackView = (ORStackView *)self.view;
    
    UIView *view1 = [[UIView alloc] init];
    view1.backgroundColor = [UIColor redColor];
    [stackView addSubview:view1 withPrecedingMargin:10 sideMargin:10];
    
    UIView *view2 = [[UIView alloc] init];
    view2.backgroundColor = [UIColor blueColor];
    [stackView addSubview:view2 withPrecedingMargin:10 sideMargin:10];
}

3、应用案例和最佳实践

案例1：动态添加和删除视图

ORStackView 允许动态添加和删除视图，这在需要根据用户交互调整界面布局时非常有用。

- (void)addView {
    UIView *newView = [[UIView alloc] init];
    newView.backgroundColor = [UIColor greenColor];
    [(ORStackView *)self.view addSubview:newView withPrecedingMargin:10 sideMargin:10];
}

- (void)removeView {
    ORStackView *stackView = (ORStackView *)self.view;
    [stackView.subviews enumerateObjectsUsingBlock:^(UIView *view, NSUInteger idx, BOOL *stop) {
        if (view.tag == 3) {
            [view removeFromSuperview];
        }
    }];
}

最佳实践

• 避免过度使用：尽管 ORStackView 在某些场景下非常有用，但在新项目中应优先考虑使用 UIStackView。
• 注意兼容性：确保你的项目在未来的 iOS 版本中仍然能够正常运行。

4、典型生态项目

ORStackView 主要用于需要垂直堆叠视图的场景，例如表单、设置页面等。它与 FLKAutoLayout 等布局库结合使用，可以进一步简化布局代码。

结合 FLKAutoLayout

FLKAutoLayout 是一个简化 Auto Layout 使用的库，与 ORStackView 结合使用可以进一步简化布局代码。

#import "FLKAutoLayout.h"

- (void)viewDidLoad {
    ORStackView *stackView = [[ORStackView alloc] init];
    [self.view addSubview:stackView];
    [stackView alignTop:@"20" leading:@"20" bottom:@"-20" trailing:@"-20" toView:self.view];
    
    UIView *view1 = [[UIView alloc] init];
    view1.backgroundColor = [UIColor redColor];
    [stackView addSubview:view1 withPrecedingMargin:10 sideMargin:10];
    
    UIView *view2 = [[UIView alloc] init];
    view2.backgroundColor = [UIColor blueColor];
    [stackView addSubview:view2 withPrecedingMargin:10 sideMargin:10];
}

通过结合 FLKAutoLayout，可以更简洁地设置 ORStackView 的约束。

ORStackViewVertically stack views using Auto Layout, with an order specific subclass that uses view tags for ordering.项目地址:https://gitcode.com/gh_mirrors/or/ORStackView