iOS 9 新增 UIStackView 官方文档翻译

1、继承关系、遵照协议、隶属框架及可用平台

UIStackView 类提供了一个高效的接口用于平铺一行或一列的视图组合。Stack视图使你依靠自动布局的能力，建立用户接口使得能够动态的调整设备朝向、屏幕尺寸及任何可用范围内的变化。Stack视图管理着全部在它的 arrangedSubviews 属性中的视图的布局。这些视图根据它们在 arrangedSubviews 数组中的顺序沿着 Stack 视图的轴向排列。精确的布局变量根据 Stack 视图的 axis, distribution, alignment, spacing, 和其它属性共同决定。

使用 stack 视图，打开一个你但愿编辑的 Storyboard，从对象库中拖拽出一个 Horizontal Stack View 或者一个 Vertical Stack View，并放置到你但愿的位置上。下一步，将控件或视图拖拽放置到 stack 中，若是须要你能够继续添加视图或者控件给指定的 stack。Interface Builder 将根据 stack 的内容自动调节尺寸。你也能够经过修改属性面板中 Stack视图的属性调整 stack 内容的外观。

注意：你须要负责指定 stack 视图的位置和尺寸（可选的）。而后 stack 视图将管理其内容的布局和尺寸。

2、Stack 视图与自动布局

Stack 视图使用自动布局来定位和控制其管理的视图的尺寸。stack 视图沿着它的轴向拼凑第一个和最后一个被管理视图，使其边界平齐。对于一个水平 stack 视图，这意味着第一个被管理视图的左边界是与 stack 的左边界平齐的，而且最后一个被管理视图右边界与 stack的右边界平齐。对于垂直 stack，上边界和下边界是各自平齐的。若是你设置了 stack 视图的 layoutMarginsRelativeArrangement 属性为 YES，stack 视图将使用相关的边距与其内容对齐，而不是边界。

对于除去 UIStackViewDistributionFillEqually 分布之外的分布方式，stack 视图使用被管理视图的 intrinsicContentSize 属性来计算沿着 stack 轴向的视图尺寸。UIStackViewDistributionFillEqually 分布将调节全部被管理视图的在 stack 轴向上拥有相同尺寸，以填充 stack 视图。若是可能，stack 视图将拉伸全部被管理视图，来匹配其在 stack 轴向上最长的原有尺寸（译注：保证长宽比的状况下根据 stack 轴向长度拉伸视图）。

对于除去 UIStackViewAlignmentFill 对齐方式之外的对齐方式，stack 视图使用其管理的视图的 intrinsicContentSize 属性来计算视图垂直于 stack 轴向的尺寸。 UIStackViewAlignmentFill 从新调节了全部其管理的视图，使这些视图填充 stack 视图垂直于其轴向空间。若是可能，stack 视图将拉伸其全部管理的视图来匹配其垂直于 stack 轴向的最大固有尺寸。

3、定位和调整 Stack 视图尺寸

当 Stack 视图容许你布局其内容而不直接使用自动布局，你将仍然须要使用自动布局来定位 stack 视图。一般状况下，这意味着须要拼凑至少两个边界相邻的stack来定义它的位置。没有额外约束的状况下，系统会为 stack 视图计算一个尺寸来适应其内容：

• 沿着 stack 视图轴向，其适应尺寸等于其管理的视图尺寸与间距的和；

• 垂直于 stack 视图轴向，其适应尺寸等于其管理的视图中最大的视图的尺寸；

• 若是 stack 视图的 layoutMarginsRelativeArrangement 属性设置为 YES，stack 视图的适应尺寸会包括边距空间。

你能够提供额外的约束来具体说明 stack 视图的高度、宽度或者二者兼有。在这些状况下，stack 视图调整了其管理的视图的布局和尺寸来填充指定区域。精确的布局变量根据 stack 视图的属性得到。能够经过查看 UIStackViewDistribution 和 UIStackViewAlignment 枚举，以得到一个完整的 stack 视图在其内容空间多余或空间不足状况下的处理描述。

你也能够根据 stack 视图的第一条或最后一条基线定位它，而不是使用顶部、底部或者中心的Y值。相似于 stack 视图的适应尺寸，这些基线都是基于 stack 视图的内容计算获得的。

• 一个水平的 stack 视图调用 viewForFirstBaselineLayout 方法或 viewForLastBaselineLayout 方法时返回它最高的视图。若是最高的视图也是一个 stack 视图，那么其返回的将是在嵌套的 stack 视图上调用 viewForFirstBaselineLayout 方法或 viewForLastBaselineLayout 方法的结果。

• 一个垂直的 stack 视图当调用 viewForFirstBaselineLayout 方法时返回的是其管理的第一个视图，当调用 viewForLastBaselineLayout 方法时返回的是其管理的最后一个视图。若是这两个视图之一也是 stack 视图，那么其返回的将是在嵌套的 stack 视图上对应调用 viewForFirstBaselineLayout 方法或 viewForLastBaselineLayout 方法的结果。

注意：基线对齐方式只做用于那些高度匹配其本来内容高度的视图。若是视图被拉伸或压缩过，那么基线将出如今错误的位置上。

4、通用 Stack 视图布局

这有一些通用方法用于 stack 视图。这个清单是要高亮一些有用的示例来显示 stack 视图的灵活性。目前这还不是一个完整的清单。

• 只是定义位置。你能够经过固定两个与其父视图相邻的边界来定义 stack 视图的位置。在这里，stack 视图的尺寸将根据其管理的视图在两个维度上自由扩展。当你想要 stack 视图的内容展示其原有内容尺寸，和你想要管理其余与 stack 视图有关联的用户接口元素时是特别有用的。

举个例子，在 Figure 1中，stack 视图的左边界和上边界都已经相对固定于其父视图。这些标签将根据带有8个点的二者之间的空间做为第一基线校准。这对于相对于其自己左对齐的 stack 视图内容是有效的。

Figure 1.定义位置

• 定义沿着 stack 视图轴向的尺寸。这里，你固定了沿着 stack 视图轴向相对于其父视图的两个边界，定义了 stack 视图沿着其轴向的尺寸。你将须要固定其余边界中的一个来定义 stack 视图的位置。stack 视图将沿着其轴向改变尺寸和位置来填充定义的空间；然而，未固定的边界将根据其管理的最大视图的尺寸自由移动。

举例如 Figure 2，stack 视图的左、上、右边界都已经相对于其父视图固定了。使用 UIStackViewDistributionFill 分布使得其内容重设尺寸来填充它的宽度，而且从文本框有比标签更低的内容紧凑优先级开始，它将在必要的时候被拉伸。

Figure 2.定义沿着 stack 视图轴向的尺寸

• 定义垂直于 stack 视图轴向的尺寸。这相似于上一个示例，可是你固定了垂直于 stack 视图轴向的两个边界和沿着轴向的一个边界。这使得 stack 视图在你增长或移除其管理的视图时将沿着其轴向扩展或回缩。除非你使用了 UIStackViewDistributionFillEqually 分布，被管理的视图将根据其原有尺寸调节尺寸。垂直于其轴向的视图将根据其 stack 视图的对其模式在其定义的范围内平铺。

举例，Figure 3展现了一个包含了四个标签和一个按钮的垂直 stack 视图。这个 stack 视图使用了8个点的间隙和 UIStackViewAlignmentCenter 对齐方式。stack 视图的高度将根据 stack 内部的元素的增减而增大或回缩。

Figure 3.定义垂直于 stack 视图轴向的尺寸

• 同时定义 stack 视图的位置和尺寸。这里你固定了 stack 视图的全部四个边界。stack 视图将在提供的范围以内平铺其内容。举例，Figure 4展现了一个全部四个边界都相对于其父视图固定的垂直 stack 视图。经过使用 UIStackViewAlignmentCenter 对齐方式和 UIStackViewDistributionFill 分布方式，stack 视图确保其内容将水平和垂直居中填充屏幕。然而，得到想要的布局须要两个额外的步骤。默认状况下，stack视图会垂直拉伸标签而不是图片。要缩放图片控件，就要下降其内容紧凑优先级到低于标签。额外的，为了保持图片缩放时的长宽比，你必须设置图片视图的模式为 Aspect Fit。增长一个图片视图与 stack 视图间宽度相等约束将有助于确保图片将被缩放来填充可用范围。

Figure 4.同时定义 stack 视图的位置和尺寸

5、管理 Stack 视图的展示

UIStackView 是 UIView 的非渲染型子类。它没有提供其自有的任何用户接口。相反的，它只管理被其管理的视图的位置和尺寸。所以，有些属性(如 backgroundColor)在 stack 视图上是无效的。相似的，你没法重写 layerClass，drawRect: 或 drawLayer:inContext: 方法。

这里有一系列的属性来定义 stack 视图如何平铺其内容。

• axis(轴向) 属性决定了 stack 的朝向，只有垂直或水平；

• distribution(分布) 属性决定了其管理的视图在沿着其轴向上的布局；

• alignment(对齐) 属性决定了其管理的视图在垂直于其轴向上的布局；

• spacing(空隙) 属性决定了其管理的视图间的最小间隙；

• baselineRelativeArrangement 属性决定了其视图间的垂直间隙是否根据基线测量获得；

• layoutMarginsRelativeArrangement 属性决定了 stack 视图平铺其管理的视图时是否要参照它的布局边距

一般状况下，你会使用一个 stack 视图来布局小数量的视图。你能够经过在其余 stack 视图中嵌套多个 stack 视图的方式建立更加复杂的视图层次结构。举例，Figure 5展现了一个包含两个水平 stack 视图的垂直 stack 视图。每个水平 stack 视图各包含一个标签和一个文本框。

Figure 5.Stack 视图的嵌套

你也能够经过增长被管理的视图的额外约束来完美的调节一个被管理视图的展示。举例说明，你可使用约束类设置视图的最小或最大的高度或宽度。或者你能够定义一个长宽比。当平铺其内容时，stack 视图将使用这些约束。举例来讲，在Figure 4中，当图片被缩放时，图片视图的一个长宽比约束被强行赋予了一个长宽比常数。

注意：当给一个 stack 视图内的视图增长约束时要特别注意避免传入冲突。做为惯例，若是一个视图的尺寸在一个指定的维度上默认回到其本来内容尺寸，那么你能够安全的在这个维度上增长约束。

6、维护其管理的视图与子视图之间的统一性

Stack 视图确保它的 arrangedSubviews 属性将一直是其 subviews 属性的子集合。明确的说，stack 视图强制实施了如下规定：

• 不管什么时候 stack 视图增长了一个视图到它的 arrangedSubviews 数组，其也将把这个视图做为子视图增长，若是还未增长的话。

• 不管什么时候一个子视图从 stack 视图中被移除，那么 stack 视图也将将其从 arrangedSubviews 数组中移除。

• 从 arrangedSubviews 移除一个视图并不会将其做为子视图移除。stack 视图将再也不管理该视图的尺寸和位置，可是该视图仍将是视图结构的一部分，而且当其可见的状况下仍会被渲染到屏幕上。

当 arrangedSubviews 数组一直包含着 subviews 数组的子集合，这些数组间的顺序仍然是独立的。

• arrangedSubviews 数组的顺序定义了展示在 stack 中的视图的顺序。对于水平 stack 视图，这些视图将以阅读顺序平铺，即较小索引的视图在较大索引视图的左侧。对于垂直 stack 视图，这些视图是从上到下平铺的，及较小索引的视图在较大索引视图的上方。

• subviews 数组中的顺序定义了子视图在Z轴上是顺序。若是视图重叠，有较小索引的子视图将出如今有较大索引的子视图后方。

7、动态改变 Stack 视图内容

当视图被加入、移出或插入 arrangedSubviews 数组时，或当一个被管理的子视图的 hidden 属性改变时，stack 视图都会自动更新它的布局。

OC代码以下：

1 2 3 4

// Appears to remove the first arranged view from the stack. // The view is still inside the stack, it's just no longer visible, and no longer contributes to the layout. UIView * firstView = self.stackView.arrangedSubviews[0]; firstView.hidden = YES;

Swift代码以下：

1 2 3 4

// Appears to remove the first arranged view from the stack. // The view is still inside the stack, it's just no longer visible, and no longer contributes to the layout. let firstView = stackView.arrangedSubviews[0] firstView.hidden = true

stack 视图也会自动响应其任何属性的改变。举例，你能够更新 stack 视图的 axis 属性来动态改变的朝向。

OC代码以下：

1 2 3 4 5 6

// Toggle between a vertical and horizontal stack if (self.stackView.axis == UILayoutConstraintAxisHorizontal) {     self.stackView.axis = UILayoutConstraintAxisVertical; }else {     self.stackView.axis = UILayoutConstraintAxisHorizontal; }

Swift代码以下：

1 2 3 4 5 6

// Toggle between a vertical and horizontal stack if stackView.axis == .Horizontal {     stackView.axis = .Vertical }else {     stackView.axis = .Horizontal }

对于被管理的子视图的 hidden 属性的变化和 stack 视图属性的变化，你能够经过将这些改变内置到一个动画块代码的方式以动画方式展示。

OC代码以下：

1 2 3 4 5

// Animates removing the first item in the stack. [UIView animateWithDuration:0.25 animations:^{     UIView * firstView = self.stackView.arrangedSubviews[0];     firstView.hidden = YES; }];

Swift代码以下：

1 2 3 4

// Animates removing the first item in the stack. UIView.animateWithDuration(0.25) { () -> Void in     let firstView = stackView.arrangedSubviews[0]     firstView.hidden = true}

最后，你能够直接在Interface Builder中给不少 stack 视图属性定义特定的 “尺寸类” 类型值。系统将在 stack 视图的尺寸类改变时动画展示这些改变。

8、经常使用的方法

建立 Stack 视图

1	- initWithArrangedSubviews:  (New in iOS 9.0)

管理安排的子视图

1 2 3 4

- addArrangedSubview: (New in iOS 9.0)   arrangedSubviews Property (New in iOS 9.0) - insertArrangedSubview:atIndex: (New in iOS 9.0) - removeArrangedSubview: (New in iOS 9.0)

设置布局

1 2 3 4 5 6

alignment Property  (New in iOS 9.0) axis Property  (New in iOS 9.0) baselineRelativeArrangement Property  (New in iOS 9.0) distribution Property  (New in iOS 9.0) layoutMarginsRelativeArrangement Property  (New in iOS 9.0) spacing Property  (New in iOS 9.0)

常量

1 2	UIStackViewDistribution UIStackViewAlignment

本文原文及图片来源：UIStackView Class Reference