iOS第三方库 ATStackView 2.0的介绍

之前的写 ATStackView 1.0 版本由于是继承UIStackView的,考虑该组件的缺陷而引发的一些性能上、实用性、可扩展性上的问题,决定对该组件进行底部重构。升级2.0摆脱了UIStackView的包袱,同时不再使用约束进行布局。优化布局算法等操作。

ATStackView 1.0 介绍

ATStackView 1.0缺陷:

  1. UIStackView是iOS9.0推出的,这将意味着无法支持更低版本的iOS系统。

  2. ATStackView 1.0 和 UIStackView都是基于自动布局的,频繁地使用它们会产生大量约束代码,而约束代码最终通过线性方程求解得出frame值,虽然苹果公司在iOS12对自动布局算法进行了优化,但是还是不能解决低版本的iOS系统下约束性能的问题。

  3. 继承UIStackView虽然带来了一些布局上的便利,但是它的可扩展性很低,并且由于它的源码是未知的,使得添加新特性比较困难。比如说,ATStackView 1.0 有个方法可以将元素从尾部开始添加,这个过程的实现实际上是通过添加一个约束优先级比较低的自伸长view,将头部和尾部连接(撑)起来,由于它的高度是0,所以用户感觉不到它。这个功能看似很酷,但是本来只要添加两个view的操作,结果添加了三个view。万一开发者需要调用subviews进行操作,那后果岂不是不堪设想...。

基于这些问题的存在,决定重构ATStackView,ATStackView 2.0将继承NSObject,进行轻量级改造。

github链接: https://github.com/AutoJiang/ATStackView

ATStackView 2.0的使用介绍:

1. 导入头文件

#import "UIView+ATStack.h" 

2. 快速创建一个横向布局或者纵向布局的栈(ATVerStack或 ATHorStack)。

ATVerStack *stack = [self.view getStackVer];

创建一个和 self.view 等大,纵向排列的栈。

/**快速创建一个垂直方向、子控件从上到下布局的栈*/
-(ATVerStack *)getStackVer;

/**快速创建一个水平方向、子控件从左到右布局的栈*/
-(ATHorStack *)getStackHor;

/**快速创建一个水平方向、子控件均分的栈*/
-(ATHorStack *)getStackHorEqual;

/**快速创建一个垂直方向、子控件均分的栈*/
-(ATVerStack *)getStackVerEqual;

当然,如果我们不想stack和view一样大,我们可以调用以下方法:

//inset代表内间距
-(ATVerStack *)getStackVerWithInset:(UIEdgeInsets)inset;

-(ATHorStack *)getStackHorWithInset:(UIEdgeInsets)inset;

-(ATHorStack *)getStackHorEqualWithInset:(UIEdgeInsets)inset;

-(ATVerStack *)getStackVerEqualWithInset:(UIEdgeInsets)inset;

通过设置inset来控制stack和view的间距。(注:这里的stack并不像V1.0那样是一个UIStackView实体,它实际上只是一个虚拟的 frame,所以它并没有在view上面添加这个stack)

通过调用view分类的方法生成一个stack,
接下来,我们往这个stack里面添加元素即可。

3. 添加元素(添加控件,或者其他栈)

这种方式直接添加view,view内部必须有高度上面的约束。

[stack addArrangedSubview:view];

推荐使用以下方式:(height 代表的约束height = 30 , isFill = true代表宽度和stack一样宽,isFill = false代表控件使用自适应的宽)

UIView *view = [UIView new];
[stack addArrangedSubview:view height:30 isFill:true];

4. 添加spacing

默认的ATStackView的spacing是0,一旦设置了stack.spacing = 10之后,栈内所有元素之间的间距都是10。

ATVerStackView *stack = [ATVerStackView getStackVer];
stack.spacing = 10;

当然你还可以添加额外的间距。以下代码代表下一个元素和上一个元素之间的间距为30。如果你同时设置了stack.spacing = 10,那么它们的间距就是40。

[stack addSpacing:30];

如果你不想从头部插入元素,而是想从其他位置插入时,你可以调用以下方法:

-(void)addArrangedSubview:(UIView*)view height:(CGFloat)height isFill:(BOOL)isFill position:(ATStackViewPosition)position;
typedef enum ATStackViewPosition: NSUInteger {
/**从头部添加元素*/
    ATStackViewPositionHead = 0,
/**从中间添加元素*/
    ATStackViewPositionCenter,
/**从尾部添加元素*/
    ATStackViewPositionTail,
} ATStackViewPosition;

ATSackView支持从头部,中间,或尾部添加元素。
通过设置 position = ATStackViewPositionTail 属性,可以将元素添加至头部,或者尾部(默认是添加至头部)。

想要ATStackView能从底部或中间添加元素必须得满足以下1个条件:

  1. 父视图不是UIScrollView类型。
    因为UIScrollView内部是无限大的,ATStackView并不知道它的底部在哪儿。如果一定要用,布局
    会当作内部大小和UIScrollView的frame一致计算。

5. 调用布局方法

    [stack layoutFrame];

在添加完元素以后,只有调用了layoutFrame方法,才能对内部元素开始进行布局。当内部有多层嵌套栈的时候,只需要调用最外层的layoutFrame方法即可,布局算法会遍历所有元素去执行layoutFrame。

实战:

微信-发现

50多行代码轻松实现“微信-发现”页面的简单布局。

微信-发现代码截图.png

运行结果:


image.png

九宫格:

九宫格代码截图

运行结果:


image.png

(UIView+ATStack.h)扩展方法和属性介绍:

//添加分割线
-(UIView *)addLineSeparate;
//返回的分割线可自定义颜色和高度
-(UIView *)addLineSeparateWithLelfPadding:(CGFloat)leftPadding;

//隐藏元素,同时改变其他元素的位置
-(void)setAt_hidden:(BOOL)hidden;

-(BOOL)at_hidden;

-(void)setAt_width:(CGFloat)width;

-(CGFloat)at_width;

-(void)setAt_height:(CGFloat)height;

-(CGFloat)at_height;

熟悉UIStackView的人肯定知道,子控件设置hidden = true的时候,这个控件不仅会隐藏,后面的元素位置也会自动向前移动。这里的at_hidden属性就是这样的作用。

demo演示:

demo.gif

demo地址

希望这一套布局方案能为大家的开发带来便利!

你可能感兴趣的:(iOS第三方库 ATStackView 2.0的介绍)