iOS - Xib/Storyboard Helper

前言

---

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

更新日志

---

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传送门，喜欢的话给个小星星喔