前言
对于 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搭建的效果图
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)
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
-
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传送门,喜欢的话给个小星星喔