欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

iOS 自动布局框架 – Masonry 详解

程序员文章站 2023-10-06 17:31:16
masonry介绍 这篇文章只是简单介绍masonry,以及masonry的使用,并且会举一些例子出来。但并不会涉及到masonry的内部实现,以后会专门写篇文章来介绍其内部实现原理,包括顺便讲一下...

masonry介绍

这篇文章只是简单介绍masonry,以及masonry的使用,并且会举一些例子出来。但并不会涉及到masonry的内部实现,以后会专门写篇文章来介绍其内部实现原理,包括顺便讲一下链式语法。

什么是masonry

masonry是一个对nslayoutconstraint进行封装的第三方自动布局框架,采用链式的方式提供给开发者api。系统autolayout支持的操作,masonry都支持,相比系统api功能来说,masonry是有过之而无不及。

masonry采取了链式编程的方式,代码理解起来非常清晰易懂,而且写完之后代码量看起来非常少。之前用nslayoutconstraint写很多代码才能实现的布局,用masonry最少一行代码就可以搞定。下面看到masonry的代码就会发现,太简单易懂了。

masonry是同时支持mac和ios两个平台的,在这两个平台上都可以使用masonry进行自动布局。我们可以从masutilities.h文件中,看到下面的定义,这就是masonry通过宏定义的方式,区分两个平*有的一些关键字。

    #import
    #define mas_view uiview
    #define masedgeinsets uiedgeinsets
    #elif target_os_mac
    #import
    #define mas_view nsview
    #define masedgeinsets nsedgeinsets
    #endif

github地址:
https://github.com/snapkit/masonry

集成方式

masonry支持cocoapods,可以直接通过podfile文件进行集成,需要在cocoapods中添加下面代码:
pod 'masonry'

masonry学习建议

在ui开发中,纯代码和interface builder我都是用过的,在开发过程中也积累了一些经验。对于初学者学习纯代码autolayout,我建议还是先学会interface builder方式的autolayout,领悟苹果对自动布局的规则和思想,然后再把这套思想嵌套在纯代码上。这样学习起来更好入手,也可以避免踩好多坑。

在项目中设置的autolayout约束,起到对视图布局的标记作用。设置好约束之后,程序运行过程中创建视图时,会根据设置好的约束计算frame,并渲染到视图上。

所以在纯代码情况下,视图设置的约束是否正确,要以运行之后显示的结果和打印的log为准。

masonry中的坑

在使用masonry进行约束时,有一些是需要注意的。

在使用masonry添加约束之前,需要在addsubview之后才能使用,否则会导致崩溃。
在添加约束时初学者经常会出现一些错误,约束出现问题的原因一般就是两种:约束冲突和缺少约束。对于这两种问题,可以通过调试和log排查。
之前使用interface builder添加约束,如果约束有错误直接就可以看出来,并且会以红色或者黄色警告体现出来。而masonry则不会直观的体现出来,而是以运行过程中崩溃或者打印异常log体现,所以这也是手写代码进行autolayout的一个缺点。
这个问题只能通过多敲代码,积攒纯代码进行autolayout的经验,慢慢就用起来越来越得心应手了。

masonry基础使用

masonry基础api

mas_remakeconstraints()  移除之前的约束,重新添加新的约束
mas_updateconstraints()  更新约束

equalto()       参数是对象类型,一般是视图对象或者mas_width这样的坐标系对象
mas_equalto()   和上面功能相同,参数可以传递基础数据类型对象,可以理解为比上面的api更强大

width()         用来表示宽度,例如代表view的宽度
mas_width()     用来获取宽度的值。和上面的区别在于,一个代表某个坐标系对象,一个用来获取坐标系对象的值

auto boxing

上面例如equalto或者width这样的,有时候需要涉及到使用mas_前缀,这在开发中需要注意作区分。
如果在当前类引入#import “masonry.h”之前,用下面两种宏定义声明一下,就不需要区分mas_前缀。

// 定义这个常量,就可以不用在开发过程中使用"mas_"前缀。
#define mas_shorthand
// 定义这个常量,就可以让masonry帮我们自动把基础数据类型的数据,自动装箱为对象类型。
#define mas_shorthand_globals
修饰语句

masonry为了让代码使用和更容易理解,所以直接通过点语法就可以调用,还添加了and和with两个方法。这两个方法内部实际上什么都没干,只是在内部将self直接返回,功能就是为了更加方便阅读,对代码执行没有实际作用。
例如下面的例子:
make.top.and.bottom.equalto(self.containerview).with.offset(padding);
其内部代码实现,实际上就是直接将self返回。

- (masconstraint *)with {
return self;
}

更新约束和布局

关于更新约束布局相关的api,主要用以下四个api:
- (void)updateconstraintsifneeded 调用此方法,如果有标记 为需要重新布局的约束,则立即进行重新布局,内部会调用updateconstraints方法
- (void)updateconstraints 重写此方法,内部实现自定义布局过程
- (bool)needsupdateconstraints 当前是否需要重新布局,内部会判断当前有没有被标记的约束
- (void)setneedsupdateconstraints 标记需要进行重新布局
关于uiview重新布局相关的api,主要用以下三个api:
- (void)setneedslayout 标记为需要重新布局
- (void)layoutifneeded 查看当前视图是否被标记需要重新布局,有则在内部调用layoutsubviews方法进行重新布局
- (void)layoutsubviews 重写当前方法,在内部完成重新布局操作

masonry示例代码

masonry本质上就是对系统autolayout进行的封装,包括里面很多的api,都是对系统api进行了一次二次包装。
 

typedef ns_options(nsinteger, masattribute) {
masattributeleft = 1 << nslayoutattributeleft,
masattributeright = 1 << nslayoutattributeright,
masattributetop = 1 << nslayoutattributetop,
masattributebottom = 1 << nslayoutattributebottom,
masattributeleading = 1 << nslayoutattributeleading,
masattributetrailing = 1 << nslayoutattributetrailing,
masattributewidth = 1 << nslayoutattributewidth,
masattributeheight = 1 << nslayoutattributeheight,
masattributecenterx = 1 << nslayoutattributecenterx,
masattributecentery = 1 << nslayoutattributecentery,
masattributebaseline = 1 << nslayoutattributebaseline,};
常用方法
设置内边距

/**设置yellow视图和self.view等大,并且有10的内边距。
注意根据uiview的坐标系,下面right和bottom进行了取反。所以不能写成下面这样,否则right、bottom这两个方向会出现问题。
 

make.edges.equalto(self.view).with.offset(10);
除了下面例子中的offset()方法,还有针对不同坐标系的centeroffset()、sizeoffset()、valueoffset()之类的方法。
*/
[self.yellowview mas_makeconstraints:^(masconstraintmaker *make) {
make.left.equalto(self.view).with.offset(10);
make.top.equalto(self.view).with.offset(10);
make.right.equalto(self.view).with.offset(-10);
make.bottom.equalto(self.view).with.offset(-10);
}];

通过insets简化设置内边距的方式

// 下面的方法和上面例子等价,区别在于使用insets()方法。
[self.blueview mas_makeconstraints:^(masconstraintmaker *make) {
// 下、右不需要写负号,insets方法中已经为我们做了取反的操作了。
make.edges.equalto(self.view).with.insets(uiedgeinsetsmake(10, 10, 10, 10));
}];

更新约束

// 设置greenview的center和size,这样就可以达到简单进行约束的目的
[self.greenview mas_makeconstraints:^(masconstraintmaker *make) {
make.center.equalto(self.view);
// 这里通过mas_equalto给size设置了基础数据类型的参数,参数为cgsize的结构体
make.size.mas_equalto(cgsizemake(300, 300));
}];

// 为了更清楚的看出约束变化的效果,在显示两秒后更新约束。
dispatch_after(dispatch_time(dispatch_time_now, (int64_t)(2.f * nsec_per_sec)), dispatch_get_main_queue(), ^{
[self.greenview mas_updateconstraints:^(masconstraintmaker *make) {
make.centerx.equalto(self.view).offset(100);
make.size.mas_equalto(cgsizemake(100, 100));
}];
});

大于等于和小于等于某个值的约束

[self.textlabel mas_makeconstraints:^(masconstraintmaker *make) {
make.center.equalto(self.view);
// 设置宽度小于等于200
make.width.lessthanorequalto(@200);
// 设置高度大于等于10
make.height.greaterthanorequalto(@(10));
}];

self.textlabel.text = @"这是测试的字符串。能看到1、2、3个步骤,第一步当然是上传照片了,要上传正面近照哦。上传后,网站会自动识别你的面部,如果觉得识别的不准,你还可以手动修改一下。左边可以看到16项修改参数,最上面是整体修改,你也可以根据自己的意愿单独修改某项,将鼠标放到选项上面,右边的预览图会显示相应的位置。";

textlabel只需要设置一个属性即可

self.textlabel.numberoflines = 0;

使用基础数据类型当做参数

/**如果想使用基础数据类型当做参数,masonry为我们提供了"mas_xx"格式的宏定义。
这些宏定义会将传入的基础数据类型转换为nsnumber类型,这个过程叫做封箱(auto boxing)。
"mas_xx"开头的宏定义,内部都是通过masboxvalue()函数实现的。
这样的宏定义主要有四个,分别是mas_equalto()、mas_offset()和大于等于、小于等于四个。
*/
[self.redview mas_makeconstraints:^(masconstraintmaker *make) {
make.center.equalto(self.view);
make.width.mas_equalto(100);
make.height.mas_equalto(100);
}];
设置约束优先级

/**
masonry为我们提供了三个默认的方法,prioritylow()、prioritymedium()、priorityhigh(),这三个方法内部对应着不同的默认优先级。
除了这三个方法,我们也可以自己设置优先级的值,可以通过priority()方法来设置。
*/
[self.redview mas_makeconstraints:^(masconstraintmaker *make) {
make.center.equalto(self.view);
make.width.equalto(self.view).prioritylow();
make.width.mas_equalto(20).priorityhigh();
make.height.equalto(self.view).priority(200);
make.height.mas_equalto(100).priority(1000);
}];

masonry也帮我们定义好了一些默认的优先级常量,分别对应着不同的数值,优先级最大数值是1000。

static const maslayoutpriority maslayoutpriorityrequired = uilayoutpriorityrequired;
static const maslayoutpriority maslayoutprioritydefaulthigh = uilayoutprioritydefaulthigh;
static const maslayoutpriority maslayoutprioritydefaultmedium = 500;
static const maslayoutpriority maslayoutprioritydefaultlow = uilayoutprioritydefaultlow;
static const maslayoutpriority maslayoutpriorityfittingsizelevel = uilayoutpriorityfittingsizelevel;

设置约束比例

// 设置当前约束值乘以多少,例如这个例子是redview的宽度是self.view宽度的0.2倍。
[self.redview mas_makeconstraints:^(masconstraintmaker *make) {
make.center.equalto(self.view);
make.height.mas_equalto(30);
make.width.equalto(self.view).multipliedby(0.2);
}];
小练习
子视图等高练习
/**
下面的例子是通过给equalto()方法传入一个数组,设置数组中子视图及当前make对应的视图之间等高。
需要注意的是,下面block中设置边距的时候,应该用insets来设置,而不是用offset。
因为用offset设置right和bottom的边距时,这两个值应该是负数,所以如果通过offset来统一设置值会有问题。
*/
cgfloat padding = lxzviewpadding;
[self.redview mas_makeconstraints:^(masconstraintmaker *make) {
make.left.right.top.equalto(self.view).insets(uiedgeinsetsmake(padding, padding, 0, padding));
make.bottom.equalto(self.blueview.mas_top).offset(-padding);
}];
[self.blueview mas_makeconstraints:^(masconstraintmaker *make) {
make.left.right.equalto(self.view).insets(uiedgeinsetsmake(0, padding, 0, padding));
make.bottom.equalto(self.yellowview.mas_top).offset(-padding);
}];

/**下面设置make.height的数组是关键,通过这个数组可以设置这三个视图高度相等。其他例如宽度之类的,也是类似的方式。*/
[self.yellowview mas_makeconstraints:^(masconstraintmaker *make) {
make.left.right.bottom.equalto(self.view).insets(uiedgeinsetsmake(0, padding, padding, padding));
make.height.equalto(@[self.blueview, self.redview]);
}];
子视图垂直居中练习
/**要求:(这个例子是在其他人博客里看到的,然后按照要求自己写了下面这段代码)
两个视图相对于父视图垂直居中,并且两个视图以及父视图之间的边距均为10,高度为150,两个视图宽度相等。*/
cgfloat padding = 10.f;
[self.blueview mas_makeconstraints:^(masconstraintmaker *make) {
make.centery.equalto(self.view);
make.left.equalto(self.view).mas_offset(padding);
make.right.equalto(self.redview.mas_left).mas_offset(-padding);
make.width.equalto(self.redview);
make.height.mas_equalto(150);
}];
[self.redview mas_makeconstraints:^(masconstraintmaker *make) {
make.centery.equalto(self.view);
make.right.equalto(self.view).mas_offset(-padding);
make.width.equalto(self.blueview);
make.height.mas_equalto(150);
}];

uitableview动态cell高度

在ios ui开发过程中,uitableview的动态cell高度一直都是个问题。实现这样的需求,实现方式有很多种,只是实现起来复杂程度和性能的区别。

在不考虑性能的情况下,tableview动态cell高度,可以采取估算高度的方式。如果通过估算高度的方式实现的话,无论是纯代码还是interface builder,都只需要两行代码就可以完成cell自动高度适配。

实现方式:
需要设置tableview的rowheight属性,这里设置为自动高度,告诉系统cell的高度是不固定的,需要系统帮我们进行计算。然后设置tableview的estimatedrowheight属性,设置一个估计的高度。(我这里用的代理方法,实际上都一样)

原理:
这样的话,在tableview被创建之后,系统会根据estimatedrowheight属性设置的值,为tableview设置一个估计的值。然后在cell显示的时候再获取cell的高度,并刷新tableview的contentsize。

- (void)tableviewconstraints {
[self.tableview mas_makeconstraints:^(masconstraintmaker *make) {
make.edges.equalto(self.view);
}];
}

- (nsinteger)tableview:(uitableview *)tableview numberofrowsinsection:(nsinteger)section {
return self.datalist.count;
}

- (masonrytableviewcell *)tableview:(uitableview *)tableview cellforrowatindexpath:(nsindexpath *)indexpath {
masonrytableviewcell *cell = [tableview dequeuereusablecellwithidentifier:lxztableviewcellidentifier];
[cell reloadviewwithtext:self.datalist[indexpath.row]];
return cell;
}

// 需要注意的是,这个代理方法和直接返回当前cell高度的代理方法并不一样。
// 这个代理方法会将当前所有cell的高度都预估出来,而不是只计算显示的cell,所以这种方式对性能消耗还是很大的。
// 所以通过设置estimatedrowheight属性的方式,和这种代理方法的方式,最后性能消耗都是一样的。

- (cgfloat)tableview:(uitableview *)tableview estimatedheightforrowatindexpath:(nsindexpath *)indexpath {
return 50.f;
}

- (uitableview *)tableview {
if (!_tableview) {
_tableview = [[uitableview alloc] initwithframe:cgrectzero style:uitableviewstyleplain];
_tableview.delegate = self;
_tableview.datasource = self;
// 设置tableview自动高度
_tableview.rowheight = uitableviewautomaticdimension;
[_tableview registerclass:[masonrytableviewcell class] forcellreuseidentifier:lxztableviewcellidentifier];
[self.view addsubview:_tableview];
}
return _tableview;
}

uiscrollview自动布局

之前听很多人说过uiscrollview很麻烦,然而我并没有感觉到有多麻烦(并非装逼)。我感觉说麻烦的人可能根本就没试过吧,只是觉得很麻烦而已。
我这里就讲一下两种进行uiscrollview自动布局的方案,并且会讲一下自动布局的技巧,只要掌握技巧,布局其实很简单。

布局小技巧:
给uiscrollview添加的约束是定义其frame,设置contentsize是定义其内部大小。uiscrollview进行addsubview操作,都是将其子视图添加到contentview上。
所以,添加到uiscrollview上的子视图,对uiscrollview添加的约束都是作用于contentview上的。只需要按照这样的思路给uiscrollview设置约束,就可以掌握设置约束的技巧了。

提前设置contentsize

// 提前设置好uiscrollview的contentsize,并设置uiscrollview自身的约束
self.scrollview.contentsize = cgsizemake(1000, 1000);
[self.scrollview mas_makeconstraints:^(masconstraintmaker *make) {
make.edges.equalto(self.view);
}];

// 虽然redview的get方法内部已经执行过addsubview操作,但是uiview始终以最后一次添加的父视图为准,也就是redview始终是在最后一次添加的父视图上。
[self.scrollview addsubview:self.redview];
[self.redview mas_makeconstraints:^(masconstraintmaker *make) {
make.left.top.equalto(self.scrollview);
make.width.height.mas_equalto(200);
}];

[self.scrollview addsubview:self.blueview];
[self.blueview mas_makeconstraints:^(masconstraintmaker *make) {
make.left.equalto(self.redview.mas_right);
make.top.equalto(self.scrollview);
make.width.height.equalto(self.redview);
}];

[self.scrollview addsubview:self.greenview];
[self.greenview mas_makeconstraints:^(masconstraintmaker *make) {
make.left.equalto(self.scrollview);
make.top.equalto(self.redview.mas_bottom);
make.width.height.equalto(self.redview);
}];

自动contentsize

上面的例子是提前设置好uiscrollview的contentsize的内部size,然后直接向里面addsubview。但是这有个要求就是,需要提前知道contentsize的大小,不然没法设置。
这个例子中将会展示动态改变contentsize的大小,内部视图有多少contentsize就自动扩充到多大。

这种方式的实现,主要是依赖于创建一个containerview内容视图,并添加到uiscrollview上作为子视图。uiscrollview原来的子视图都添加到containerview上,并且和这个视图设置约束。
因为对uiscrollview进行addsubview操作的时候,本质上是往其contentview上添加。也就是containerview的父视图是contentview,通过containerview撑起contentview视图的大小,以此来实现动态改变contentsize。

// 在进行约束的时候,要对containerview的上下左右都添加和子视图的约束,以便确认containerview的边界区域。
[self.scrollview mas_makeconstraints:^(masconstraintmaker *make) {
make.edges.equalto(self.view);
}];

cgfloat padding = lxzviewpadding;
[self.containerview mas_makeconstraints:^(masconstraintmaker *make) {
make.edges.equalto(self.scrollview).insets(uiedgeinsetsmake(padding, padding, padding, padding));
}];

[self.containerview addsubview:self.greenview];
[self.greenview mas_makeconstraints:^(masconstraintmaker *make) {
make.top.left.equalto(self.containerview).offset(padding);
make.size.mas_equalto(cgsizemake(250, 250));
}];

[self.containerview addsubview:self.redview];
[self.redview mas_makeconstraints:^(masconstraintmaker *make) {
make.top.equalto(self.containerview).offset(padding);
make.left.equalto(self.greenview.mas_right).offset(padding);
make.size.equalto(self.greenview);
make.right.equalto(self.containerview).offset(-padding);
}];

[self.containerview addsubview:self.yellowview];
[self.yellowview mas_makeconstraints:^(masconstraintmaker *make) {
make.left.equalto(self.containerview).offset(padding);
make.top.equalto(self.greenview.mas_bottom).offset(padding);
make.size.equalto(self.greenview);
make.bottom.equalto(self.containerview).offset(-padding);
}];