iOS - Xib/Storyboard Helper

前言

对于 UI 界面的编写工作，是否应该用 xib/storyboard 完成，一直是iOS开发中的争议，然而本文并参与讨论这个话题。（手动笑脸）
有兴趣的朋友可以参考唐巧的这篇文章
本文只是为喜欢使用或是想去使用 xib/storyboard 的朋友，提供一个强大的工具。在使用 xib/storyboard的时候，更加方便灵活，同时也为 xib/storyboard在添加约束，适配屏幕上做了一些改进，使之使用起来更加简单有效

更新日志

2019-04-01 ~ cocoapods version 1.2.3

由于 xcode 10 对xib/storyboard 的渲染支持性较之前版本更差(有猜测对设备的要求更高)，故将常用属性提到Basis文件夹
建议使用以下方式导入
```
 //pod 导入
 pod 'IBProperty/Basis'
```

2018-10-30 ~ cocoapods version 1.2.0

解决因为IBProperty 引起的 Failed to render and update auto layout 错误，这是一个渲染错误，并不会影响程序的运行。

2018-07-07 ~ cocoapods version 1.1.9

解决极少部分block循环引用的问题

2018-06-18 ~ cocoapods version 1.1.8

CornerRadius：移除mask实现方式，因为mask会触发离屏渲染。恢复并优化了Core Graphics绘制圆角
解决渐变和圆角同时设置偶尔会发生冲突的问题
AdaptXBottowConstant：加入iPhone X底部约束适配

2018-06-11 ~ cocoapods version 1.1.7

截图：此前有一张截图中的iPhone SE 显示不完整，是由于因为款 mac-pro 上 se模拟器缩放到最小，引发的渲染问题，类似于tableView的横线。感谢网友limingLiuBaBa指出
Gradient：为所有视图加入了简单的渐变色处理，细节见文末。
CornerRadius：由layer的mask 替换之前的Core Graphics绘制。

所有属性见文末Property

IBProperty

下图为IBProperty通过Storyboard搭建的效果图

图1.png

图2.png

IBProperty 通过IB_DESIGNABLE 和 IBInspectable 以类目的形式为xib/storyboard 添加了一些简单有效的新属性，如阴影、圆角、毛玻璃等（具体见本文最后）
在xib/storyboard上要做到完美适配，需要添加很多较为复杂的约束，如果需要让约束的常量适配的话，就需要通过代码去设置了；字体的适配也是如此，通过IBProperty只需要在xib/storyboard设置一个属性就OK了。这些适配不仅体现在约束和字体上，IBProperty还提供了一系列适配方式，让xib/storyboard 在屏幕适配上也更加简单。

安装

（oc、swift 无区别）

使用cocoapods (推荐)
```
pod 'IBProperty'  
```
手动下载
从Github地址下载项目，然后将IBProperty 和 Aspects(如果项目中已经集成则不需要) 文件夹拖入到工程中即可

使用

IBProperty只需要集成到项目中就可以为xib/storyboard服务了

然后你就可以在xib/storyboard 选中对象赋值了（具体属性及含义参照本文最后）
比如你要适配一个约束（图3），或是为UITextView加上placeholder（图4）

图3.png

图4.png

IBProperty不需要引用任何头文件，除非确实需要在代码中使用（事实上，并不推荐这么做）
因为IBProperty旨在服务于xib/storyboard，其中大部分属性都只是计算型属性，少部分属性无法间接获取的，通过getter 也将无法获取它，因为并没有为它真正开辟内存。此外，在代码中使用IBProperty，对同一个属性做多次赋值，可能会多次适配，导致一些奇怪的bug。总之，如果确实需要在代码中使用IBProperty，一定要对源码比较熟悉才行

Property

UIView

//border
ib_borderWidth;
ib_borderColor;

//cornerRadius
ib_cornerRadius;
//视图的 cornerRadius 始终保持高度的一半
ib_cornerCircle;

//shadow
ib_shadowOffset;
ib_shadowColor;
ib_shadowOpacity;
ib_shadowRadius;

/*
 * 渐变开始颜色 - 渐变结束颜色
   只设置开始颜色 渐变将由alpha 0.3 - 0.1； 只设置结束颜色 渐变将由alpha 0.1 - 0.3
 */
ib_gradientStartColor;
ib_gradientEndColor;

注: IBProperty仅对图片视图的圆角(ib_cornerRadius、ib_cornerCircle) 做了离屏渲染处理
下图（图5）上为只设置ib_gradientStartColor，下为只设置ib_gradientEndColor

图5.png

UILabel

// 根据屏幕的宽度 适配 字体大小
ib_adaptFont;
// 给文字添加 下划线
ib_underLine;
// 给文字添加中间横线
ib_middleLine;

UIButton

// 根据屏幕的宽度 适配 字体大小
ib_adaptFont;
// 根据屏幕的宽度 适配 contentEdgeInsets、titleEdgeInsets、imageEdgeInsets
ib_adaptInsets;

UIControl

// 禁止重复点击（2秒内不能重复点击）
ib_reClickEnabled;

UITextField

// 根据屏幕的宽度 适配 字体大小
ib_adaptFont;

UITextView

// 根据屏幕的宽度 适配 字体大小
ib_adaptFont;
// 类似于UITextField的placeholder
ib_placeholder;

UIImageView

// 亮色模糊效果（毛玻璃）
ib_darkEffect;
// 暗色色模糊效果
ib_lightEffect;
// 模糊效果不透明度
ib_effectOpacity;

UICollectionViewFlowLayout

// 根据屏幕的宽度 适配 itemSize
ib_adaptSize;
// collectionView每行显示的item的个数,自动适配屏幕 
ib_numberItemsForRow;

NSLayoutConstraint

// 根据屏幕的宽度 适配 约束常量 constant
ib_adaptConstant;
// 若为YES constant将不会适配比例，而是在iPhone X 上加上24pt, 常用于 为自定义导航栏的子视图添加约束 
ib_adaptXTopConstant;
//若为YES constant将不会适配比例，而是在iPhone X 上加上34pt, 常用于某些底部弹窗
ib_adaptXBottowConstant

后续

IBProperty处于不间断更新当中，读者有较好的建议或意见，都可以在GitHub或是本文评论区提出issue，每次更新都会在GitHub和本文上记录更新日志。
最后是GitHub传送门，喜欢的话给个小星星喔