PureLayout API速查表：掌握iOS/OS X布局开发精髓-优快云博客

PureLayout API速查表：掌握iOS/OS X布局开发精髓

【免费下载链接】PureLayout The ultimate API for iOS & OS X Auto Layout — impressively simple, immensely powerful. Objective-C and Swift compatible. 项目地址: https://gitcode.com/gh_mirrors/pu/PureLayout

还在为iOS/OS X Auto Layout冗长的代码而烦恼？PureLayout提供了一套简洁而强大的API，让布局开发从繁琐变得轻松。本文将带你快速掌握这个"终极布局API"的核心用法，从基础设置到高级约束，让你在实际项目中效率倍增。

项目概述

PureLayout是一个Objective-C编写的布局框架，同时兼容Swift，通过类别(Category)扩展了UIView/NSView、NSArray和NSLayoutConstraint，提供了直观的Auto Layout接口。它的设计理念是"惊人的简单，强大的功能"，让开发者无需编写复杂的约束代码即可实现精确定位。

核心特性

支持iOS 9.0+、OS X 10.9+和tvOS 9.0+
同时兼容Objective-C和Swift
提供链式API，简化约束创建流程
支持安全区域(Safe Area)和边距(Margin)布局
高效轻量，仅添加薄层高封装代码

项目源码结构清晰，主要包含三个核心类别：

ALView+PureLayout.h - 视图布局扩展
NSArray+PureLayout.h - 数组布局扩展
NSLayoutConstraint+PureLayout.h - 约束管理扩展

快速开始

环境配置

通过CocoaPods集成PureLayout到你的项目：

pod 'PureLayout', '~> 3.1.9'

对于Swift项目，需要创建桥接头文件(Bridging Header)并导入：

#import "PureLayout.h"

基础设置

使用PureLayout的第一步是创建支持Auto Layout的视图。框架提供了便捷的初始化方法：

// Objective-C
UIView *view = [UIView newAutoLayoutView];
// 或对已有视图进行配置
[existingView configureForAutoLayout];

// Swift
let view = UIView.newAutoLayoutView()
// 或对已有视图进行配置
existingView.configureForAutoLayout()

这两个方法会自动禁用translatesAutoresizingMaskIntoConstraints属性，避免自动转换导致的约束冲突。

核心API详解

视图定位

边缘约束

PureLayout提供了丰富的边缘约束方法，让你轻松将视图固定到父视图或其他视图的边缘。最常用的是将视图边缘固定到父视图边缘：

// 将所有边缘固定到父视图，无内边距
[view autoPinEdgesToSuperviewEdges];

// 带内边距的边缘固定
[view autoPinEdgesToSuperviewEdgesWithInsets:UIEdgeInsetsMake(10, 20, 30, 40)];

// 固定部分边缘，排除顶部
[view autoPinEdgesToSuperviewEdgesWithInsets:UIEdgeInsetsZero excludingEdge:ALEdgeTop];

对于iOS 9+项目，推荐使用安全区域布局：

// 使用安全区域固定边缘
[view autoPinEdgesToSuperviewSafeAreaWithInsets:UIEdgeInsetsMake(16, 16, 16, 16)];

居中对齐

居中视图是常见需求，PureLayout提供了简洁的居中方法：

// 在父视图中水平和垂直居中
[view autoCenterInSuperview];

// 仅水平居中
[view autoAlignAxisToSuperviewAxis:ALAxisHorizontal];

// 仅垂直居中
[view autoAlignAxisToSuperviewAxis:ALAxisVertical];

尺寸约束

控制视图尺寸同样简单直观：

// 设置固定尺寸
[view autoSetDimensionsToSize:CGSizeMake(100, 50)];

// 设置单一维度尺寸
[view autoSetDimension:ALDimensionWidth toSize:200];
[view autoSetDimension:ALDimensionHeight toSize:300];

// 相对尺寸 - 宽度为父视图的0.5倍
[view autoMatchDimension:ALDimensionWidth toDimension:ALDimensionWidth ofView:superview withMultiplier:0.5];

多视图布局

当需要排列多个视图时，NSArray的类别方法非常实用：

// 垂直等间距排列视图
[views autoDistributeViewsAlongAxis:ALAxisVertical alignedTo:ALAxisHorizontal withFixedSpacing:10 insetSpacing:YES];

// 水平等宽排列视图
[views autoDistributeViewsAlongAxis:ALAxisHorizontal alignedTo:ALAxisVertical withFixedSize:80 insetSpacing:YES];

约束优先级

PureLayout允许设置约束优先级，处理约束冲突：

[NSLayoutConstraint autoSetPriority:UILayoutPriorityDefaultLow forConstraints:^{
    [view autoSetDimension:ALDimensionHeight toSize:200];
}];

实际应用示例

登录界面布局

下面是一个使用PureLayout构建的简单登录界面布局示例：

// 创建用户名输入框
UITextField *usernameField = [UITextField newAutoLayoutView];
usernameField.borderStyle = UITextBorderStyleRoundedRect;
[self.view addSubview:usernameField];

// 创建密码输入框
UITextField *passwordField = [UITextField newAutoLayoutView];
passwordField.borderStyle = UITextBorderStyleRoundedRect;
passwordField.secureTextEntry = YES;
[self.view addSubview:passwordField];

// 创建登录按钮
UIButton *loginButton = [UIButton newAutoLayoutView];
[loginButton setTitle:@"登录" forState:UIControlStateNormal];
[loginButton setBackgroundColor:[UIColor blueColor]];
[self.view addSubview:loginButton];

// 用户名输入框约束
[usernameField autoPinEdgesToSuperviewEdgesWithInsets:UIEdgeInsetsMake(0, 30, 0, 30) excludingEdge:ALEdgeBottom];
[usernameField autoSetDimension:ALDimensionHeight toSize:40];
[usernameField autoPinEdge:ALEdgeBottom toEdge:ALEdgeTop ofView:passwordField withOffset:-20];

// 密码输入框约束
[passwordField autoAlignAxisToSuperviewAxis:ALAxisHorizontal];
[passwordField autoMatchDimension:ALDimensionWidth toDimension:ALDimensionWidth ofView:usernameField];
[passwordField autoSetDimension:ALDimensionHeight toSize:40];
[passwordField autoPinEdge:ALEdgeBottom toEdge:ALEdgeTop ofView:loginButton withOffset:-30];

// 登录按钮约束
[loginButton autoAlignAxisToSuperviewAxis:ALAxisHorizontal withOffset:50];
[loginButton autoSetDimensionsToSize:CGSizeMake(120, 44)];
[loginButton autoCenterInSuperviewAxis:ALAxisHorizontal];

这个示例展示了如何使用PureLayout的各种约束方法创建一个清晰的登录界面布局，代码简洁易读，比原生Auto Layout API减少了大量模板代码。

高级技巧

约束标识符

为约束添加标识符有助于调试：

NSLayoutConstraint *constraint = [view autoSetDimension:ALDimensionWidth toSize:100];
constraint.identifier = @"view_width_constraint";

约束更新与移除

PureLayout提供了约束更新和移除的便捷方法：

// 更新约束常数
[view autoSetDimension:ALDimensionWidth toSize:150];
[view layoutIfNeeded];

// 移除所有约束
[view autoRemoveConstraintsAffectingView];

批量约束操作

使用autoSetPriority:forConstraints:可以为一组约束设置优先级：

[NSLayoutConstraint autoSetPriority:UILayoutPriorityDefaultHigh forConstraints:^{
    [view autoPinEdge:ALEdgeLeft toEdge:ALEdgeLeft ofView:superview withInset:20];
    [view autoPinEdge:ALEdgeRight toEdge:ALEdgeRight ofView:superview withInset:20];
}];

总结

PureLayout通过直观的API设计，将复杂的Auto Layout操作简化为链式调用，极大提高了布局代码的可读性和可维护性。无论是简单的居中对齐还是复杂的多视图排列，PureLayout都能提供简洁高效的解决方案。

掌握这些API后，你将能够:

减少60%以上的布局代码量
避免Auto Layout常见的约束冲突问题
快速实现响应式界面设计
轻松适配不同屏幕尺寸和设备方向

建议结合官方示例项目Example-iOS和Example-Mac深入学习，这些示例包含了11个不同场景的布局实现，从基础到高级覆盖全面。

立即将PureLayout集成到你的项目中，体验布局开发的新方式！关注我们获取更多PureLayout高级技巧和最佳实践。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考