Objective-C的UIStackView学习笔记

UIStackView

UIStackView能够利用自动布局的功能，创建能够动态适应设备方向、屏幕大小和可用空间中任何更改的用户界面。UIStackView管理其arrangedSubviews属性中所有视图的布局。这些视图是根据它们在arrangedSubviews数组中的顺序沿堆栈视图的轴线排列的。具体布局因UIStackView的轴线、分布、对齐、间距和其他特性而异。我们负责定义UIStackView的位置和大小(可选)，UIStackView管理其内容的布局和大小。

$\color{red}{UIStackView使用的简单示例：}$

- (void)viewDidLoad {
    [super viewDidLoad];
    UIButton *redButton = [UIButton buttonWithType:UIButtonTypeCustom];
    [redButton setTitle:@"红色按钮" forState:UIControlStateNormal];
    redButton.backgroundColor = [UIColor redColor];
    
    UIButton *greenButton = [UIButton buttonWithType:UIButtonTypeCustom];
    [greenButton setTitle:@"绿色按钮" forState:UIControlStateNormal];
    greenButton.backgroundColor = [UIColor greenColor];

    UIButton *blueButton = [UIButton buttonWithType:UIButtonTypeCustom];
    [blueButton setTitle:@"蓝色按钮" forState:UIControlStateNormal];
    blueButton.backgroundColor = [UIColor blueColor];
    
    UIStackView *stackView = [[UIStackView alloc]initWithArrangedSubviews:@[redButton,greenButton,blueButton]];
    stackView.backgroundColor = [UIColor yellowColor];
    stackView.alignment = UIStackViewAlignmentCenter;
    stackView.axis = UILayoutConstraintAxisHorizontal;
    stackView.distribution = UIStackViewDistributionFill;
    [self.view addSubview:stackView];
    
    stackView.translatesAutoresizingMaskIntoConstraints = NO;
    [self.view addConstraints:@[
        [stackView.centerYAnchor constraintEqualToAnchor:self.view.centerYAnchor],
        [stackView.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
    ]];
}

显示如下：

截屏2022-04-01 上午9.31.26.png

当设置蓝色视图隐藏时，显示如下：

截屏2022-04-01 上午9.36.28.png

当修改UIStackView约束，限制UIStackView大小时，显示如下：

stackView.translatesAutoresizingMaskIntoConstraints = NO;
[self.view addConstraints:@[
     [stackView.centerYAnchor constraintEqualToAnchor:self.view.centerYAnchor],
     [stackView.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
     [stackView.heightAnchor constraintEqualToConstant:100],
     [stackView.widthAnchor constraintEqualToConstant:300],
 ]];

截屏2022-04-01 上午10.08.52.png

当修改子视图约束，限制子视图大小时，显示如下：

stackView.translatesAutoresizingMaskIntoConstraints = NO;
    [self.view addConstraints:@[
        [stackView.centerYAnchor constraintEqualToAnchor:self.view.centerYAnchor],
        [stackView.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
    ]];
    
    redButton.translatesAutoresizingMaskIntoConstraints = NO;
    [stackView addConstraints:@[
        [redButton.heightAnchor constraintEqualToConstant:50],
        [redButton.widthAnchor constraintEqualToConstant:100],
    ]];
    
    greenButton.translatesAutoresizingMaskIntoConstraints = NO;
    [stackView addConstraints:@[
        [greenButton.heightAnchor constraintEqualToConstant:50],
        [greenButton.widthAnchor constraintEqualToConstant:80],
    ]];
    
    blueButton.translatesAutoresizingMaskIntoConstraints = NO;
    [stackView addConstraints:@[
        [blueButton.heightAnchor constraintEqualToConstant:50],
        [blueButton.widthAnchor constraintEqualToConstant:120],
    ]];

截屏2022-04-01 上午10.43.49.png

既限制UIStackView约束，又限制子视图约束时，至少有一个子视图可以由UIStackView进行调整，显示如下：

- (void)viewDidLoad {
    [super viewDidLoad];
    UIButton *redButton = [UIButton buttonWithType:UIButtonTypeCustom];
    [redButton setTitle:@"红色按钮" forState:UIControlStateNormal];
    redButton.backgroundColor = [UIColor redColor];
    
    UIButton *greenButton = [UIButton buttonWithType:UIButtonTypeCustom];
    [greenButton setTitle:@"绿色按钮" forState:UIControlStateNormal];
    greenButton.backgroundColor = [UIColor greenColor];

    UIButton *blueButton = [UIButton buttonWithType:UIButtonTypeCustom];
    [blueButton setTitle:@"蓝色按钮" forState:UIControlStateNormal];
    blueButton.backgroundColor = [UIColor blueColor];
    
    UIStackView *stackView = [[UIStackView alloc]initWithArrangedSubviews:@[redButton,greenButton,blueButton]];
    stackView.backgroundColor = [UIColor yellowColor];
    stackView.alignment = UIStackViewAlignmentCenter;
    stackView.axis = UILayoutConstraintAxisHorizontal;
    stackView.distribution = UIStackViewDistributionFill;
    [self.view addSubview:stackView];
    
    stackView.translatesAutoresizingMaskIntoConstraints = NO;
    [self.view addConstraints:@[
        [stackView.centerYAnchor constraintEqualToAnchor:self.view.centerYAnchor],
        [stackView.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
        [stackView.heightAnchor constraintEqualToConstant:100],
        [stackView.widthAnchor constraintEqualToConstant:200],
    ]];
    
    redButton.translatesAutoresizingMaskIntoConstraints = NO;
    [stackView addConstraints:@[
        [redButton.heightAnchor constraintEqualToConstant:50],
        [redButton.widthAnchor constraintEqualToConstant:80],
    ]];
    
    greenButton.translatesAutoresizingMaskIntoConstraints = NO;
    [stackView addConstraints:@[
        [greenButton.heightAnchor constraintEqualToConstant:50],
        [greenButton.widthAnchor constraintEqualToConstant:80],
    ]];
    
    blueButton.translatesAutoresizingMaskIntoConstraints = NO;
    NSLayoutConstraint *blueButtonWidthAnchor = [blueButton.widthAnchor constraintEqualToConstant:120];
    blueButtonWidthAnchor.priority = UILayoutPriorityDefaultLow;
    [stackView addConstraints:@[
        [blueButton.heightAnchor constraintEqualToConstant:50],
        blueButtonWidthAnchor,
    ]];
}

截屏2022-04-01 下午4.37.00.png

UIStackView就像一个自动适应其子视图约束或管理其子视图约束的容器视图，可以大量的节省设置或更新约束的代码。我们需要在某一方面放权给UIStackView，如果我们严格限制UIStackView的约束，就应当给予UIStackView自动调整其子视图约束的权力，如果我们严格限制其子视图约束，就应当给予UIStackView自动调整自身约束的权力，如果我们既严格限制UIStackView的约束，又严格限制其子视图约束，我们会得到约束冲突，这是来自UIStackView的抗议。

常用属性

@property(nonatomic) UILayoutConstraintAxis axis;

属性描述 ：设置UIStackView排列视图时所沿的轴线方向。UILayoutConstraintAxis提供了两个枚举值，UILayoutConstraintAxisHorizontal（水平排列）与UILayoutConstraintAxisVertical（垂直排列），默认为UILayoutConstraintAxisHorizontal。

UILayoutConstraintAxis提供的枚举值：

typedef NS_ENUM(NSInteger, UILayoutConstraintAxis) {
    //水平排列
    UILayoutConstraintAxisHorizontal = 0,
    //垂直排列
    UILayoutConstraintAxisVertical = 1
};

@property(nonatomic) UIStackViewDistribution distribution;

属性描述 ： 设置UIStackView沿指定轴线方向布局子视图的方式。

UIStackViewDistribution提供的布局子视图的方式如下：

typedef NS_ENUM(NSInteger, UIStackViewDistribution) {
    
    /* 一种布局，其中UIStackView调整其排列的视图的大小，以便它们沿着UIStackView的轴线方向填充可用空间。
       当排列的视图不适合(上溢) UIStackView时，它会根据视图的抗压优先级缩小视图。
       如果排列的视图没有填充(下溢) UIStackView时，它会根据视图的拥抱优先级拉伸视图。
       如果存在任何歧义，UIStackView将根据排列的子视图数组中的索引调整排列的视图的大小。
       即将UIStackView填充满。
   */
    UIStackViewDistributionFill = 0,
    
    /*一种布局，其中堆栈视图调整其排列视图的大小，以便它们沿着UIStackView的轴线方向均匀的填充可用空间。
      即子视图以相同大小填充UIStackView
    */
    UIStackViewDistributionFillEqually,
    
    /* 一种布局，其中堆栈视图调整其排列视图的大小，以便它们沿着UIStackView的轴线方向按比例调整大小填充可用空。
      即子视图以比例大小填充UIStackView。
     */
    UIStackViewDistributionFillProportionally,
    
    /* 一种布局，其中UIStackView定位其排列视图，以便它们沿着UIStackView的轴线方向填充可用空间。
       当排列的视图没有填充UIStackView时(下溢)，它会均匀地填充视图之间的间距。
       如果排列的视图不适合UIStackView时(上溢)，它会根据视图的抗压优先级缩小视图。
       如果存在任何歧义，堆栈视图将根据视图在arrangedSubviews数组中的索引缩小视图。
       即子视图等间距填充UIStackView，间距为UIStackView调整，spacing属性限制了最小间距，但不限制最大间距。
     */
    UIStackViewDistributionEqualSpacing,
    
    /* 一种布局，试图定位排列视图，使其沿UIStackView的轴线方向具以相等的中心间距填充可用空间。
        当排列的视图没有填充UIStackView时(下溢)，如果未设置spacing属性，则自动插入间距，并调整间距以满足排列的子视图有相等的中心间距。
        如果设置spacing属性，在维持以spacing属性设置间距值为最小间距的同时，它会根据视图的抗压优先级缩小视图以满足排列的子视图有相等的中心间距。
        当排列的视图不适合UIStackView时(上溢)，如果未设置spacing属性，它会根据视图的抗压优先级缩小视图以满足排列的子视图有相等的中心间距。
        如果设置spacing属性，在维持以spacing属性设置间距值为最小间距的同时，它会根据视图的抗压优先级缩小视图以满足排列的子视图有相等的中心间距。
        即子视图等中心间距填充UIStackView，间距为UIStackView调整，spacing属性限制了最小间距，但不限制最大间距。
     */
    UIStackViewDistributionEqualCentering,
} API_AVAILABLE(ios(9.0));

@property(nonatomic) UIStackViewAlignment alignment;

属性描述 ：UIStackView排列的子视图的对齐方式，其对齐方式受UIStackView排列视图时所沿的轴线方向影响。

UIStackViewAlignment提供的对齐子视图的方式如下：

typedef NS_ENUM(NSInteger, UIStackViewAlignment) {
    /* 填充式布局，如果UIStackView为水平排列，则子视图顶部与底部对齐UIStackView。
       如果UIStackView为垂直排列，则子视图前部与后部对齐UIStackView。
     */
    UIStackViewAlignmentFill，
    
    /* 前部对齐式布局，UIStackView为垂直排列有效。
     */
    UIStackViewAlignmentLeading,
    /* 顶部对齐式布局，UIStackView为水平排列有效。
     */
    UIStackViewAlignmentTop = UIStackViewAlignmentLeading,
    /*按照第一个子视图的第一行文文本基线对齐，且高度最大的子视图底部对齐。UIStackView为水平排列有效。
    */
    UIStackViewAlignmentFirstBaseline, 
    
    /* 子视图沿轴线方向剧中对齐
     */
    UIStackViewAlignmentCenter,
    
    /* 后部对齐式布局，UIStackView为垂直排列有效。
     */
    UIStackViewAlignmentTrailing,
    /*底部对齐式布局，UIStackView为水平排列有效。
    */
    UIStackViewAlignmentBottom = UIStackViewAlignmentTrailing,
    /*按照第一个子视图的最后一行文文本基线对齐，且高度最大的子视图顶部对齐。UIStackView为水平排列有效。
    */
    UIStackViewAlignmentLastBaseline, // Valid for horizontal axis only
} API_AVAILABLE(ios(9.0));

@property(nonatomic) CGFloat spacing;

属性描述 ：UIStackView排列子视图相邻边之间的间距。此属性定义了UIStackViewDistributionFill、UIStackViewDistributionFillEqually、UIStackViewDistributionFillProportionally布局的排列视图之间的严格间距，UIStackViewDistributionEqualSpace和UIStackViewDistributionEqualCenter布局的最小间距。使用负值允许重叠。默认值为0.0。

@property(nonatomic,getter=isBaselineRelativeArrangement) BOOL baselineRelativeArrangement;

属性描述 ：一个布尔值，默认值为NO，用于确定是否从视图的基线测量视图之间的垂直间距。如果为YES，视图之间的垂直间距将从基于文本的视图的最后一条基线到其下方视图的第一条基线进行测量。顶部和底部视图的定位也使其最近的基线距离堆栈视图的边缘指定的距离。此属性仅由垂直排列的UIStackView视图使用。水平排列的UIStackView可以使用alignment属性控制。

@property(nonatomic,getter=isLayoutMarginsRelativeArrangement) BOOL layoutMarginsRelativeArrangement;

属性描述 ：如果为YES，UIStackView将相对于其布局边距布局其排列视图。如果为NO，它将相对于其边界布置排列的视图。默认为NO。

@property(nonatomic,readonly,copy) NSArray<__kindof UIView *> *arrangedSubviews;

属性描述 ：由UIStackView排列的视图数组。UIStackView确保了arrangedSubviews数组总是它的子视图数组(subviews)的一个子集。每当调用addArrangedSubview:方法时，如果尚未添加该子视图，UIStackView都会将该视图添加为子视图，每当调用removeFromSuperview:方法时，UIStackView也会将其从arrangedSubviews中删除。

常用函数

- (instancetype)initWithFrame:(CGRect)frame NS_DESIGNATED_INITIALIZER;
- (instancetype)initWithCoder:(NSCoder *)coder NS_DESIGNATED_INITIALIZER;

函数描述 ：初始化UIStackView。

- (instancetype)initWithArrangedSubviews:(NSArray<__kindof UIView *> *)views;

函数描述 ：返回管理所提供的视图的UIStackView对象。UIStackView将所有需要排列的视图添加到其arrangedSubviews组中，并这些视图添加为子视图。如果arrangedSubviews数组中包含的任何视图收到removeFromSuperview的方法调用，UIStackView也会将其从arrangedSubviews中删除。

参数：

views ：要由UIStackView排列的视图数组。

返回值：一个新的UIStackView对象。

- (void)addArrangedSubview:(UIView *)view;

函数描述 ：将视图添加到arrangedSubviews数组的末尾。UIStackView确保了arrangedSubviews数组总是它的子视图数组(subviews)的一个子集。如果尚未添加该子视图，此方法会自动将提供的视图添加为UIStackView的子视图，如果已经添加该子视图，此函数不做操作。

参数：

view ：要添加到由UIStackView排列的视图数组中的视图。

- (void)removeArrangedSubview:(UIView *)view;

函数描述 ：此方法从UIStackView的arrangedSubviews数组中删除提供的视图。视图的位置和大小将不再由堆栈视图管理。但是，此方法不会从堆栈的子视图数组中(subviews)删除提供的视图，因此视图仍然显示为视图层次的一部分，视图仍显示在屏幕上，需要通过调用视图的removeFromSuperview方法从子视图数组中显式删除视图。

- (void)insertArrangedSubview:(UIView *)view atIndex:(NSUInteger)stackIndex;

函数描述 ：将提供的视图添加到排列的子视图数组中指定的索引处。如果索引已被占用，UIStackView会增加arrangedSubviews数组的大小，并将其被占用的索引及被占用的索引以上位置的所有内容移动到数组中更高的空间(索引后移)，然后UIStackView将提供的视图存储在索引处。如果插入的视图尚未添加到UIStackView，此方法会自动将提供的视图添加为UIStackView的子视图，但插入的索引位置仅影响arrangedSubviews数组中视图的顺序，它不会影响子视图数组(subviews)中视图的顺序，也就是说插入的视图仍旧添加到子视图数组(subviews)的末尾。

参数：

view ：要插入到由UIStackView排列的视图数组中的视图。

stackIndex ：其在arrangedSubviews数组中插入新视图的索引，此值不得大于此数组中当前的视图数，如果索引超出范围，此方法将抛出NSInternalInconsistencyException异常。

- (void)setCustomSpacing:(CGFloat)spacing afterView:(UIView *)arrangedSubview API_AVAILABLE(ios(11.0),tvos(11.0));

函数描述 ：水平排列时，在指定视图后缘应用自定义间距。垂直排列时，在指定视图下缘应用自定义间距。

参数：

spacing ：自定义间距。

arrangedSubview ：指定视图。

- (CGFloat)customSpacingAfterView:(UIView *)arrangedSubview API_AVAILABLE(ios(11.0),tvos(11.0));

函数描述 ：水平排列时，返回指定视图后缘应用自定义间距。垂直排列时，返回指定视图下缘自定义间距。

参数：

arrangedSubview : 指定视图。

最后编辑于：2023.01.29 11:36:06

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 212,185评论 6赞 493
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 90,445评论 3赞 385
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 157,684评论 0赞 348
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 56,564评论 1赞 284
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 65,681评论 6赞 386
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 49,874评论 1赞 290
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 39,025评论 3赞 408
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 37,761评论 0赞 268
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 44,217评论 1赞 303
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 36,545评论 2赞 327
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 38,694评论 1赞 341
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 34,351评论 4赞 332
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 39,988评论 3赞 315
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 30,778评论 0赞 21
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 32,007评论 1赞 266
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 46,427评论 2赞 360
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 43,580评论 2赞 349

Objective-C的UIStackView学习笔记

UIStackView

常用属性

常用函数

推荐阅读更多精彩内容