KGViewSeparators 0.9.1

KGViewSeparators 0.9.1

测试已测试
语言语言 Obj-CObjective C
许可证 MIT
发布最后发布2016年6月

Krisjanis Gaidis维护。



  • 作者:
  • Krisjanis Gaidis

概览

KGViewSeparators 是一个轻量级的辅助库,可以帮助快速将分隔符插入视图。无需子类化!

易于使用和自定义仅仅是其中的好处。这个库在处理单元格复用时尤其有用:它可以防止多个分隔符添加到单个视图中,您可以为任何单元格显示/隐藏分隔符等。您只需指定您想显示/隐藏分隔符的时间,然后它就会自动运行。

当前该库允许修改分隔符的颜色、lineWidth 和内填充。

核心原则

  1. 易于使用
  2. 自定义
  3. 支持视图复用

安装

要使用 CocoaPods 安装,请将以下内容添加到您的项目 Podfile 中

pod 'KGViewSeparators'

或者,将 KGViewSeparators 文件夹中的所有文件拖放到您的 Xcode 项目中,并在需要时同意复制文件。

如何使用

导入

#import <UIView+KGViewSeparators.h>

使用

枚举

KGViewSeparatorTop
KGViewSeparatorBottom

Objective-C

[view kg_show:YES separator:KGViewSeparatorTop color:[UIColor blackColor] lineWidth:KGViewSeparatorLineWidth(1.0) insets:UIEdgeInsetsMake(0, 15.0, 0, 15.0)];

Swift

view.kg_show(true, separator: .Bottom, color:  UIColor.blackColor(), lineWidth: KGViewSeparatorLineWidth(1.0), insets: UIEdgeInsetsZero)

辅助函数

lineWidth 应该根据屏幕缩放比例进行分割,以获得适当的像素渲染。

CGFloat KGViewSeparatorLineWidth(CGFloat lineWidth);

推荐用法

创建您自己的类别以简化代码。

@interface UITableViewCell (Separators)
- (void)showTopSeparator:(BOOL)show;
- (void)showBottomSeparator:(BOOL)show;
@end
#import <UIView+KGViewSeparators.h>
@implementation UITableViewCell (Separators)
- (void)showTopSeparator:(BOOL)show {
    [self.contentView kg_show:show separator:KGViewSeparatorTop color:[UIColor blackColor] lineWidth:KGViewSeparatorLineWidth(1.0) insets:UIEdgeInsetsMake(0, 15.0, 0, 15.0)];
}
- (void)showBottomSeparator:(BOOL)show {
    [self.contentView kg_show:show separator:KGViewSeparatorBottom color:[UIColor blackColor] lineWidth:KGViewSeparatorLineWidth(1.0) insets:UIEdgeInsetsMake(0, 15.0, 0, 15.0)];
}
@end

重要提示

当向单元格添加分隔符时,重要的是向 contentView 添加分隔符。

Swift 支持

KGViewSeparators 与 Swift 一起工作!请查看“示例”文件夹中的 Swift 示例。

工作原理

KGViewSeparators 使用 关联对象 来存储分隔符视图,并通过 Auto Layout 进行布局。一旦存储,视图将简单地显示或隐藏。通过存储分隔符视图和自定义分隔符的配置,该库可以复用已经创建的内容。

致谢

由 Krisjanis Gaidis 创建和维护。

许可

KGViewSeparators 以 MIT 许可发布。有关详细信息,请参阅 LICENSE 文件。