TestsTested | ✗ |
LangLanguage | SwiftSwift |
License | MIT |
ReleasedLast Release | Mar 2017 |
SwiftSwift Version | 3.0 |
SPMSupports SPM | ✗ |
Maintained by devedbox.
AXBadgeView-Swift是一个badge view管理类,是之前我写的AXBadgeView的Swift版本(以下的介绍中统一使用AXBadgeView),在新版本中没有太大的改动,主要的是把原有的功能实用swift实现了,使用方法是一样的。
AXBadgeView是一个badge view视图,继承于UILabel,子类的实现完成了UI的自动布局,自动计算content的bounds大小并可以通过指定minSize
实现badge view最终的bounds大小。
AXBadgeView使用的是自动布局来控制显示的位置的,为什么要用自动布局呢?在我之前做的一个项目中,我使用的是第三方的badge view管理类,在GitHub上的星星还是很多的,但是我使用了之后发现,布局是有问题的,在发现问题之后我就去看了看源码,结果问题显而易见,那个类使用的不是自动布局。那么在这样一个对布局精准度要求较高的地方的话,使用自动布局可以减少很多布局上面的隐患,其实这点来说,我也推荐是用自动布局,因为自动布局的强大之处已经不用我来多说了。
AXBadgeView中怎样控制badge view显示的偏移量呢?通过设置badge instance的offSets
属性来控制,offSets
的默认值采用了CGFloat.max
和CGFloat.min
两个值,max表示就是x的最大值或者y的最小值,min就用来表示x的最小值和y的最小值。offSets
的默认值是(CGFloat.max, CGFloat.min)
,表示x的最右边和y的最上边,也就是superView的右上角。那么,在使用的过程中,如果想表示边界值的话就通过以上两个值来表示,就不用手动去计算superView的高宽了。同样的,如果想给定指定的offSets
值的话,就可以设置这个属性,坐标系就是iOS的默认坐标系。
以上已经对AXBadgeView做了一定的介绍了,那么这里将做一些总结性的东西,出了以上介绍的几点之外,AXBadgeView还具有以下特性:
- 设置数字显示
99+
的样式,可以自定义显示的数字.- 自定义显示的样式.
- 自定义动画效果.
- 当内容为
0
的时候可以设置隐藏.- 当内容更新的时候,是否动画更新内容.
AXBadgeView默认提供了4样式,每一种样式显示的内容都有所区别,在使用的过程中可以根据需求设置不同的样式以达到不痛的效果。样式默认为:.Normal
。使用的过程中可以指定style
来确定显示的样式和内容:
enum AXBadgeViewStyle: Int {
/// Normal shows a red dot.
case Normal
/// Number shows a number form text.
case Number
/// Text shows a custom text.
case Text
/// New shows a new text.
case New
}
new
文本.通过代码实现更改样式:
objective-c:
_showsView.badgeView.style = AXBadgeViewNew;
swift:
showsView.badgeView.style = AXBadgeViewStyle.New
AXBadgeView提供了4种动画,每一种动画都有不同的显示效果。在使用的过程中可以设置不同的动画类型来实现不同的显示效果。动画默认为.None
即无动画,那么在设置相应的动画类型的话可以通过设置animation
来指定响应的动画类型:
enum AXBadgeViewAnimation: Int {
/// Animation none, badge view stay still.
case None
/// Animation scale.
case Scale
/// Animation shake.
case Shake
/// Animation bounce.
case Bounce
/// Animation breathe.
case Breathe
}
代码示例:
objective-c:
_showsView.badgeView.animation = AXBadgeViewAnimationScale
swift:
showsView.badgeView.animation = AXBadgeViewAnimation.Scale
我在写这个工具类的时候就考虑到API友好的这个实际问题了,那么这样的一个工具应该怎样去设计它的API接口呢?在软件开发中,耦合度越低对我们整个项目的研发和维护是有很大帮助的,所以我们在设计一个API的时候,就要尽量去考虑到耦合度的因素。
AXBadgeView接口很简单,在使用的过程中过我们只需要关心显示
和隐藏
的接口就行了,其他的细节已经处理好了:
show(animated:inView:)
hide(animated:completion:)
AXBadgeView采用了协议和类扩展的形式,直接在UIView
、UIBarButtonItem
、UITabBarItem
中直接添加并实现了相应的接口,使用起来很方便。在OC中使用了运行时添加Associated Objects的方式添加了badgeView属性和相关的饿方法。那么在Swift中的话就有点差别,Swift中在添加了以上三个类的扩展以外,还实现了对应的协议:
protocol AXBadgeViewDelegate {
/// Badge view property.
var badgeView: AXBadgeView {get set}
/// Animated to show the badge view.
func showBadge(animated animated: Bool) -> Void
/// Animated to hide the badge view.
func clearBadge(animated animated: Bool) -> Void
}
直接引用就是直接在GitHub下载代码源文件AXBadgeView-Swift—–>Objective-C版,并将下载的源文件导入工程:
swift直接使用.
oc在需要使用的地方#import "AXBadgeView.h"
.
This code is distributed under the terms and conditions of the MIT license.