# Masonry [![Build Status](https://travis-ci.org/SnapKit/Masonry.svg?branch=master)](https://travis-ci.org/SnapKit/Masonry) [![Coverage Status](https://img.shields.io/coveralls/SnapKit/Masonry.svg?style=flat-square)](https://coveralls.io/r/SnapKit/Masonry) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) ![Pod Version](https://img.shields.io/cocoapods/v/Masonry.svg?style=flat)
**Masonry is still actively maintained, we are committed to fixing bugs and merging good quality PRs from the wider community. However if you're using Swift in your project, we recommend using [SnapKit](https://github.com/SnapKit/SnapKit) as it provides better type safety with a simpler API.**
Masonry is a light-weight layout framework which wraps AutoLayout with a nicer syntax. Masonry has its own layout DSL which provides a chainable way of describing your NSLayoutConstraints which results in layout code that is more concise and readable.
Masonry supports iOS and Mac OS X.
For examples take a look at the **Masonry iOS Examples** project in the Masonry workspace. You will need to run `pod install` after downloading.
## What's wrong with NSLayoutConstraints?
Under the hood Auto Layout is a powerful and flexible way of organising and laying out your views. However creating constraints from code is verbose and not very descriptive.
Imagine a simple example in which you want to have a view fill its superview but inset by 10 pixels on every side
```obj-c
UIView *superview = self.view;
UIView *view1 = [[UIView alloc] init];
view1.translatesAutoresizingMaskIntoConstraints = NO;
view1.backgroundColor = [UIColor greenColor];
[superview addSubview:view1];
UIEdgeInsets padding = UIEdgeInsetsMake(10, 10, 10, 10);
[superview addConstraints:@[
//view1 constraints
[NSLayoutConstraint constraintWithItem:view1
attribute:NSLayoutAttributeTop
relatedBy:NSLayoutRelationEqual
toItem:superview
attribute:NSLayoutAttributeTop
multiplier:1.0
constant:padding.top],
[NSLayoutConstraint constraintWithItem:view1
attribute:NSLayoutAttributeLeft
relatedBy:NSLayoutRelationEqual
toItem:superview
attribute:NSLayoutAttributeLeft
multiplier:1.0
constant:padding.left],
[NSLayoutConstraint constraintWithItem:view1
attribute:NSLayoutAttributeBottom
relatedBy:NSLayoutRelationEqual
toItem:superview
attribute:NSLayoutAttributeBottom
multiplier:1.0
constant:-padding.bottom],
[NSLayoutConstraint constraintWithItem:view1
attribute:NSLayoutAttributeRight
relatedBy:NSLayoutRelationEqual
toItem:superview
attribute:NSLayoutAttributeRight
multiplier:1
constant:-padding.right],
]];
```
Even with such a simple example the code needed is quite verbose and quickly becomes unreadable when you have more than 2 or 3 views.
Another option is to use Visual Format Language (VFL), which is a bit less long winded.
However the ASCII type syntax has its own pitfalls and its also a bit harder to animate as `NSLayoutConstraint constraintsWithVisualFormat:` returns an array.
## Prepare to meet your Maker!
Heres the same constraints created using MASConstraintMaker
```obj-c
UIEdgeInsets padding = UIEdgeInsetsMake(10, 10, 10, 10);
[view1 mas_makeConstraints:^(MASConstraintMaker *make) {
make.top.equalTo(superview.mas_top).with.offset(padding.top); //with is an optional semantic filler
make.left.equalTo(superview.mas_left).with.offset(padding.left);
make.bottom.equalTo(superview.mas_bottom).with.offset(-padding.bottom);
make.right.equalTo(superview.mas_right).with.offset(-padding.right);
}];
```
Or even shorter
```obj-c
[view1 mas_makeConstraints:^(MASConstraintMaker *make) {
make.edges.equalTo(superview).with.insets(padding);
}];
```
Also note in the first example we had to add the constraints to the superview `[superview addConstraints:...`.
Masonry however will automagically add constraints to the appropriate view.
Masonry will also call `view1.translatesAutoresizingMaskIntoConstraints = NO;` for you.
## Not all things are created equal
> `.equalTo` equivalent to **NSLayoutRelationEqual**
> `.lessThanOrEqualTo` equivalent to **NSLayoutRelationLessThanOrEqual**
> `.greaterThanOrEqualTo` equivalent to **NSLayoutRelationGreaterThanOrEqual**
These three equality constraints accept one argument which can be any of the following:
#### 1. MASViewAttribute
```obj-c
make.centerX.lessThanOrEqualTo(view2.mas_left);
```
MASViewAttribute | NSLayoutAttribute
------------------------- | --------------------------
view.mas_left | NSLayoutAttributeLeft
view.mas_right | NSLayoutAttributeRight
view.mas_top | NSLayoutAttributeTop
view.mas_bottom | NSLayoutAttributeBottom
view.mas_leading | NSLayoutAttributeLeading
view.mas_trailing | NSLayoutAttributeTrailing
view.mas_width | NSLayoutAttributeWidth
view.mas_height | NSLayoutAttributeHeight
view.mas_centerX | NSLayoutAttributeCenterX
view.mas_centerY | NSLayoutAttributeCenterY
view.mas_baseline | NSLayoutAttributeBaseline
#### 2. UIView/NSView
if you want view.left to be greater than or equal to label.left :
```obj-c
//these two constraints are exactly the same
make.left.greaterThanOrEqualTo(label);
make.left.greaterThanOrEqualTo(label.mas_left);
```
#### 3. NSNumber
Auto Layout allows width and height to be set to constant values.
if you want to set view to have a minimum and maximum width you could pass a number to the equality blocks:
```obj-c
//width >= 200 && width <= 400
make.width.greaterThanOrEqualTo(@200);
make.width.lessThanOrEqualTo(@400)
```
However Auto Layout does not allow alignment attributes such as left, right, centerY etc to be set to constant values.
So if you pass a NSNumber for these attributes Masonry will turn these into constraints relative to the view’s superview ie:
```obj-c
//creates view.left = view.superview.left + 10
make.left.lessThanOrEqualTo(@10)
```
Instead of using NSNumber, you can use primitives and structs to build your constraints, like so:
```obj-c
make.top.mas_equalTo(42);
make.height.mas_equalTo(20);
make.size.mas_equalTo(CGSizeMake(50, 100));
make.edges.mas_equalTo(UIEdgeInsetsMake(10, 0, 10, 0));
make.left.mas_equalTo(view).mas_offset(UIEdgeInsetsMake(10, 0, 10, 0));
```
By default, macros which support [autoboxing](https://en.wikipedia.org/wiki/Autoboxing#Autoboxing) are prefixed with `mas_`. Unprefixed versions are available by defining `MAS_SHORTHAND_GLOBALS` before importing Masonry.
#### 4. NSArray
An array of a mixture of any of the previous types
```obj-c
make.height.equalTo(@[view1.mas_height, view2.mas_height]);
make.height.equalTo(@[view1, view2]);
make.left.equalTo(@[view1, @100, view3.right]);
````
## Learn to prioritize
> `.priority` allows you to specify an exact priority
> `.priorityHigh` equivalent to **UILayoutPriorityDefaultHigh**
> `.priorityMedium` is half way between high and low
> `.priorityLow` equivalent to **UILayoutPriorityDefaultLow**
Priorities are can be tacked on to the end of a constraint chain like so:
```obj-c
make.left.greaterThanO
没有合适的资源?快使用搜索试试~ 我知道了~
UIScrollView自适应高度或宽度
共80个文件
h:22个
m:18个
plist:8个
需积分: 1 0 下载量 62 浏览量
2023-04-28
17:15:22
上传
评论
收藏 130KB ZIP 举报
温馨提示
iOS-UIScrollView自适应高度或自适应宽度实现,内有技术关键点讲解及代码实现; 使用Objective-C实现,Swift亦可,实现自适应高度或宽度思想一致
资源推荐
资源详情
资源评论
收起资源包目录
UIScrollView自适应高度或宽度.zip (80个子文件)
UIScrollView自适应高度或宽度
.DS_Store 6KB
CSDN_day01_1.xcworkspace
xcshareddata
swiftpm
configuration
IDEWorkspaceChecks.plist 238B
contents.xcworkspacedata 230B
xcuserdata
curtis.xcuserdatad
UserInterfaceState.xcuserstate 34KB
Podfile 254B
CSDN_day01_1
SceneDelegate.m 2KB
ViewController.h 162B
Base.lproj
Main.storyboard 3KB
LaunchScreen.storyboard 2KB
AppDelegate.h 175B
AppDelegate.m 1KB
main.m 439B
CHWidthViewController.m 4KB
SceneDelegate.h 228B
CHHeightViewController.m 5KB
CHWidthViewController.h 269B
CHHeightViewController.h 271B
ViewController.m 3KB
Info.plist 681B
Assets.xcassets
Contents.json 63B
AppIcon.appiconset
Contents.json 177B
AccentColor.colorset
Contents.json 123B
CSDN_day01_1.xcodeproj
project.pbxproj 20KB
xcuserdata
curtis.xcuserdatad
xcschemes
xcschememanagement.plist 347B
project.xcworkspace
xcshareddata
swiftpm
configuration
IDEWorkspaceChecks.plist 238B
contents.xcworkspacedata 135B
xcuserdata
curtis.xcuserdatad
UserInterfaceState.xcuserstate 16KB
Pods
Pods.xcodeproj
project.pbxproj 40KB
xcuserdata
curtis.xcuserdatad
xcschemes
Masonry.xcscheme 2KB
xcschememanagement.plist 556B
Pods-CSDN_day01_1.xcscheme 2KB
Manifest.lock 237B
Local Podspecs
Headers
Target Support Files
Pods-CSDN_day01_1
Pods-CSDN_day01_1-frameworks-Debug-output-files.xcfilelist 63B
Pods-CSDN_day01_1-acknowledgements.markdown 1KB
Pods-CSDN_day01_1-dummy.m 138B
Pods-CSDN_day01_1-frameworks-Debug-input-files.xcfilelist 131B
Pods-CSDN_day01_1.modulemap 124B
Pods-CSDN_day01_1-frameworks-Release-output-files.xcfilelist 63B
Pods-CSDN_day01_1-frameworks-Release-input-files.xcfilelist 131B
Pods-CSDN_day01_1.debug.xcconfig 803B
Pods-CSDN_day01_1-Info.plist 854B
Pods-CSDN_day01_1-acknowledgements.plist 2KB
Pods-CSDN_day01_1.release.xcconfig 803B
Pods-CSDN_day01_1-umbrella.h 326B
Pods-CSDN_day01_1-frameworks.sh 8KB
Masonry
Masonry.debug.xcconfig 718B
Masonry.modulemap 104B
Masonry.release.xcconfig 718B
Masonry-Info.plist 854B
Masonry-umbrella.h 801B
Masonry-dummy.m 118B
Masonry-prefix.pch 195B
Masonry
LICENSE 1KB
README.md 16KB
Masonry
MASConstraint.h 8KB
MASViewAttribute.h 1KB
NSLayoutConstraint+MASDebugAdditions.h 326B
MASConstraintMaker.h 6KB
Masonry.h 802B
NSArray+MASAdditions.m 6KB
MASLayoutConstraint.m 227B
NSLayoutConstraint+MASDebugAdditions.m 6KB
MASConstraint+Private.h 2KB
MASConstraint.m 8KB
ViewController+MASAdditions.h 891B
MASCompositeConstraint.m 5KB
View+MASShorthandAdditions.h 5KB
NSArray+MASShorthandAdditions.h 1016B
MASViewConstraint.m 13KB
View+MASAdditions.h 5KB
MASUtilities.h 6KB
MASViewAttribute.m 1KB
MASConstraintMaker.m 10KB
NSArray+MASAdditions.h 3KB
MASLayoutConstraint.h 505B
View+MASAdditions.m 6KB
MASViewConstraint.h 1KB
MASCompositeConstraint.h 494B
ViewController+MASAdditions.m 1KB
Podfile.lock 237B
共 80 条
- 1
资源评论
CoderHuangHuang
- 粉丝: 0
- 资源: 3
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功