Masonry -- 使用純代碼進行iOS應用的autolayout自適應佈局

簡介

簡化iOS應用使用純代碼機型自適應佈局的工做,使用一種簡潔高效的語法替代NSLayoutConstraints.

• 項目主頁: Masonry
• 最新示例: 點擊下載
• 項目簡議: 若是再看到關於純代碼,xib或storyboard,使用哪一種方式進行UI佈局更合適的討論,請推薦他們先試用下 Masonry. Masonry,像xib同樣快速,同時擁有做爲純代碼方式的靈活性 -- github關注度 7800 + 是有緣由的!

快速入門

安裝

使用 CocoaPods 安裝

pod 'Masonry'

推薦在你的在 prefix.pch 中引入頭文件:

// 定義這個常量,就能夠在使用Masonry沒必要總帶着前綴 `mas_`:
#define MAS_SHORTHAND

// 定義這個常量,以支持在 Masonry 語法中自動將基本類型轉換爲 object 類型:
#define MAS_SHORTHAND_GLOBALS

#import "Masonry.h"

使用

初始Masonry

這是使用MASConstraintMaker建立的約束:

/* 注意:view1應首先添加爲某個視圖的子視圖,superview是一個局部變量,指view1的父視圖. */

UIEdgeInsets padding = UIEdgeInsetsMake(10, 10, 10, 10);

[view1 mas_makeConstraints:^(MASConstraintMaker *make) {
    make.top.equalTo(superview.mas_top).offset(padding.top);
    make.left.equalTo(superview.mas_left).offset(padding.left);
    make.bottom.equalTo(superview.mas_bottom).offset(-padding.bottom);
    make.right.equalTo(superview.mas_right).offset(-padding.right);
}];

甚至能夠更短:

[view1 mas_makeConstraints:^(MASConstraintMaker *make) {
    make.edges.equalTo(superview).insets(padding);
}];

不止能夠表達相等關係

.equalTo 等價於 NSLayoutRelationEqual

.lessThanOrEqualTo 等價於 NSLayoutRelationLessThanOrEqual

.greaterThanOrEqualTo 等價於 NSLayoutRelationGreaterThanOrEqual

這三個表達相等關係的語句,能夠接受一個參數;此參數能夠爲如下任意一個:

1. MASViewAttribute

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

若是你須要 view.left 大於或等於label.left:

// 下面兩個約束是徹底等效的.
make.left.greaterThanOrEqualTo(label);
make.left.greaterThanOrEqualTo(label.mas_left);

3. NSNumber

自適應佈局容許將寬度或高度設置爲固定值. 若是你想要給視圖一個最小或最大值,你能夠這樣:

//width >= 200 && width <= 400
make.width.greaterThanOrEqualTo(@200);
make.width.lessThanOrEqualTo(@400)

可是自適應佈局不支持將 left,right, centerY等設爲固定值. 若是你給這些屬性傳遞一個常量, Masonry會自動將它們轉換爲相對於其父視圖的相對值:

//creates view.left = view.superview.left + 10
make.left.lessThanOrEqualTo(@10)

除了使用 NSNumber 外,你可使用基本數據類型或者結構體來建立約束:

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));

4. NSArray

一個數組,裏面能夠混合是前述三種類型的任意幾種:

// 表達三個視圖等高的約束.
make.height.equalTo(@[view1.mas_height, view2.mas_height]);
make.height.equalTo(@[view1, view2]);
make.left.equalTo(@[view1, @100, view3.right]);

約束的優先級

.priority 容許你指定一個精確的優先級,數值越大優先級越高.最高1000.

.priorityHigh 等價於 UILayoutPriorityDefaultHigh.優先級值爲 750.

.priorityMedium 介於高優先級和低優先級之間,優先級值在 250~750之間.

.priorityLow 等價於 UILayoutPriorityDefaultLow, 優先級值爲 250.

優先級能夠在約束的尾部添加:

make.left.greaterThanOrEqualTo(label.mas_left).with.priorityLow();

make.top.equalTo(label.mas_top).with.priority(600);

等比例自適應

.multipliedBy 容許你指定一個兩個視圖的某個屬性等比例變化

item1.attribute1 = multiplier × item2.attribute2 + constant,此爲約束的計算公式, .multipliedBy本質上是用來限定 multiplier的

注意,由於編程中的座標系從父視圖左上頂點開始,因此指定基於父視圖的left或者top的multiplier是沒有意義的,由於父視圖的left和top總爲0.

若是你須要一個視圖隨着父視圖的寬度和高度,位置自動變化,你應該同時指定 right,bottom,width,height與父視圖對應屬性的比例(基於某個尺寸下的相對位置計算出的比例),而且constant必須爲0.

// 指定寬度爲父視圖的 1/4.
make.width.equalTo(superview).multipliedBy(0.25);

工具方法

Masonry提供了一些工具方法來進一步簡化約束的建立.

edges 邊界

//使 top, left, bottom, right等於 view2
make.edges.equalTo(view2);

//使 top = superview.top + 5, left = superview.left + 10,
//      bottom = superview.bottom - 15, right = superview.right - 20
make.edges.equalTo(superview).insets(UIEdgeInsetsMake(5, 10, 15, 20))

size 尺寸

// 使寬度和高度大於或等於 titleLabel
make.size.greaterThanOrEqualTo(titleLabel)

//使 width = superview.width + 100, height = superview.height - 50
make.size.equalTo(superview).sizeOffset(CGSizeMake(100, -50))

center 中心

//使 centerX和 centerY = button1
make.center.equalTo(button1)

//使 centerX = superview.centerX - 5, centerY = superview.centerY + 10
make.center.equalTo(superview).centerOffset(CGPointMake(-5, 10))

你可使用鏈式語法來加強代碼可讀性:

// 除top外,其餘約束都與父視圖相等.
make.left.right.bottom.equalTo(superview);
make.top.equalTo(otherView);

更新約束

有時,你須要修改已經存在的約束來實現動畫效果或者移除/替換已有約束. 在 Masonry 中,有幾種不一樣的更新視圖約束的途徑:

1. References 引用

你能夠把 Masonry 語法返回的約束或約束數組,存儲到一個局部變量或者類的屬性中,以供後續操做某個約束.

// 聲明屬性
@property (nonatomic, strong) MASConstraint *topConstraint;

...

// when making constraints
[view1 mas_makeConstraints:^(MASConstraintMaker *make) {
    self.topConstraint = make.top.equalTo(superview.mas_top).with.offset(padding.top);
    make.left.equalTo(superview.mas_left).with.offset(padding.left);
}];

...
// 而後你就能夠操做這個屬性.
[self.topConstraint uninstall];

2. mas_updateConstraints

若是你只是想添加新的約束,你可使用便利方法mas_updateConstraints,不須要使用 mas_makeConstraints. mas_updateConstraints,不會移除已經存在的約束(即便新舊約束間相互衝突).

// 重寫視圖的updateConstraints方法: 這是Apple推薦的添加/更新約束的位置.
// 這個方法能夠被屢次調用以響應setNeedsUpdateConstraints方法.
// setNeedsUpdateConstraints 能夠被UIKit內部調用或者由開發者在本身的代碼中調用以更新視圖約束. 
- (void)updateConstraints {
    [self.growingButton mas_updateConstraints:^(MASConstraintMaker *make) {
        make.center.equalTo(self);
        make.width.equalTo(@(self.buttonSize.width)).priorityLow();
        make.height.equalTo(@(self.buttonSize.height)).priorityLow();
        make.width.lessThanOrEqualTo(self);
        make.height.lessThanOrEqualTo(self);
    }];

    //根據apple機制,最後應調用父類的updateConstraints方法.
    [super updateConstraints];
}

3. mas_remakeConstraints

mas_remakeConstraints與mas_updateConstraints類似,不一樣之處在於: mas_remakeConstraints 會先移除視圖上已有的約束,再去建立新的約束.

- (void)changeButtonPosition {
    [self.button mas_remakeConstraints:^(MASConstraintMaker *make) {
        make.size.equalTo(self.buttonSize);

        if (topLeft) {
        	make.top.and.left.offset(10);
        } else {
        	make.bottom.and.right.offset(-10);
        }
    }];
}