需要记录的一点:
1.简介
基于NSLayoutConstraint封装的第三方布局框架,实现自动布局,采用链式编程的方式提供给开发者API。系统AutoLayout支持的操作,Masonry都支持。
2.Github地址:
https://github.com/SnapKit/Masonry
3. 集成方式
Masonry支持CocoaPods,可以直接通过podfile文件进行集成,需要在CocoaPods中添加下面代码:
pod 'Masonry'
4.基本用法
--- mas_makeConstraints() 添加约束
--- mas_remakeConstraints() 移除之前的约束,重新添加新的约束
--- mas_updateConstraints() 更新约束,写哪条更新哪条,其他约束不变
--- equalTo() 参数是对象类型,一般是视图对象或者mas_width这样的坐标系对象
-- mas_equalTo() 和上面功能相同,参数可以传递基础数据类型对象,可以理解为比上面的API更强大
--- width() 用来表示宽度,例如代表view的宽度
--- mas_width() 用来获取宽度的值。和上面的区别在于,一个代表某个坐标系对象,一个用来获取坐标系对象的值
asonry为了让代码使用和阅读更容易理解,所以直接通过点语法就可以调用,还添加了and和with两个方法。这两个方法内部实际上什么都没干,只是在内部将self直接返回,功能就是为了更加方便阅读,对代码执行没有实际作用。
例如下面的例子:
make.top.and.bottom.equalTo(self.containerView).with.offset(padding);
其内部代码实现,实际上就是直接将self返回。
-(MASConstraint*)with{
return self;
}
5.更新约束和布局
关于更新约束布局相关的API,主要用以下四个API:
-(void)updateConstraintsIfNeeded 调用此方法,如果有标记为需要重新布局的约束,则立即进行重新布局,内部会调用updateConstraints方法-(void)updateConstraints 重写此方法,内部实现自定义布局过程-(BOOL)needsUpdateConstraints 当前是否需要重新布局,内部会判断当前有没有被标记的约束-(void)setNeedsUpdateConstraints 标记需要进行重新布局
6.UIview 重新布局
-(void)setNeedsLayout 标记为需要重新布局
-(void)layoutIfNeeded 查看当前视图是否被标记需要重新布局,有则在内部调用layoutSubviews方法进行重新布局-(void)layoutSubviews 重写当前方法,在内部完成重新布局操作
7.用法举例
7.1 /**
设置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);}
];
7.2 通过insets简化设置内边距的方式
// 下面的方法和上面例子等价,区别在于使用insets()方法。
[self.blueView mas_makeConstraints:^(MASConstraintMaker*make){
// 下、右不需要写负号,insets方法中已经为我们做了取反的操作了。make.edges.equalTo(self.view).with.insets(UIEdgeInsetsMake(10,10,10,10));}
];
7.3 更新约束
// 设置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(),^{
// 指定更新size,其他约束不变。
[self.greenView mas_updateConstraints:^(MASConstraintMaker*make){
make.size.mas_equalTo(CGSizeMake(100,100));}];
});
7.4 大于等于和小于等于某个值的约束
[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;
7.5 使用基础数据类型当做参数
/**
如果想使用基础数据类型当做参数,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);// make.height.equalTo(@(100));
}];
7.6 设置约束优先级
/**
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;staticconstMASLayoutPriority MASLayoutPriorityDefaultHigh=UILayoutPriorityDefaultHigh;staticconstMASLayoutPriority MASLayoutPriorityDefaultMedium=500;staticconstMASLayoutPriority MASLayoutPriorityDefaultLow=UILayoutPriorityDefaultLow;staticconstMASLayoutPriority MASLayoutPriorityFittingSizeLevel=UILayoutPriorityFittingSizeLevel;
7.7 设置约束比例
// 设置当前约束值乘以多少,例如这个例子是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);
}];
8.自适应高度
需求举例:父视图上有N个子视图,从上到下依次排列,最下面是一个label,高度根据文案来定,最多X行。
8.1 label自适应高度:
设置label的其他约束,但是不设置高度,只设置举例底部的距离即可。
[self.label mas_makeConstraints:^(MASConstraintMaker *make) {
make.top.equalTo(self.imgView.mas_bottom).offset(11);
make.left.equalTo(self.imgView);
make.right.equalTo(@(-15));
make.bottom.equalTo(@(0));
}];
8.2 父视图自适应子视图的高度:
父视图不设置高度,会自动根据子视图最终的高度来设置好高度。
[self.contentView mas_makeConstraints:^(MASConstraintMaker *make) {
make.left.right.equalTo(@0);
make.bottom.equalTo(@(-24);
}];
3.不能立即拿到frame
masonry是建立在autolayout之上的。你没获取到正确的值,那是因为约束还没布局完成。相当于就是我们给一定的约束,系统内部自己去根据约束条件转成对应的frame,而这需要一个过程。
想要拿到正确的frame最好的就是让autolayout完成之后,什么时候完成呢?那就是在layoutsubviews for view or didlayoutsubviews for controller 里获取,当然在控制器的viewdidappear里也拿得到,但是正确做法和最佳做法还是在控制器里的viewdidlayout里获取最好~因为autolayout会根据约束,不停的去改变frame,这方法里最后拿到的frame就是最终姿势.
Masonry的block的回调是立即的;
想立即拿到,需要调用:
[xx.superView layoutIfNeeded];
可以发现,调用[superview layoutIfNeeded];时回调了viewDidLayoutSubviews方法。这就是调用[xx.superView layoutIfNeeded]后能获取到正确frame的原因。
4. 动画更新
和一般动画不同的是,使用Masonry这样放入到动画的block中不能直接让动画生效,只是直接造成控件位移,经过尝试,应当添加如下操作
-(void)beginAnimate{
//告知需要更改约束
[self.view setNeedsUpdateConstraints];
[UIView animateWithDuration:3 animations:^{
[btn mas_updateConstraints:^(MASConstraintMaker *make) {
make.right.mas_equalTo(view.mas_right).offset(-100);
}];
//告知父类控件绘制,不添加注释的这两行的代码无法生效
[btn.superview layoutIfNeeded];
}];
}
其中[btn.superview layoutIfNeeded];是关键的一行,该行必须在动画的block中才能实现动画效果。
注意:多个地方更新不同控件的约束,如果有的需要动画,有的不需要动画,动画会影响其他不做动画的控件,
解决办法是:更新不需要使用动画的控件 也调用下 [superview layoutIfNeeded];
5. 可以和frame混着用
可以某些控件使用 frame,某些控件使用 约束,只要方便就可以。