JKSwiftExtension，测试用例在 UILabelExtensionViewController.swift 里面
目录：
1、链式编程
2、其他的基本扩展
一、链式编程
// MARK:- 一、链式编程
public extension UILabel {
// MARK: 1.1、设置文字
/// 设置文字
/// - Parameter text: 文字内容
/// - Returns: 返回自身
@discardableResult
func text(_ text: String) -> Self {
self.text = text
return self
}
// MARK: 1.2、设置文字行数
/// 设置文字行数
/// - Parameter number: 行数
/// - Returns: 返回自身
@discardableResult
func line(_ number: Int) -> Self {
numberOfLines = number
return self
}
// MARK: 1.3、设置文字对齐方式
/// 设置文字对齐方式
/// - Parameter alignment: 对齐方式
/// - Returns: 返回自身
@discardableResult
func textAlignment(_ alignment: NSTextAlignment) -> Self {
textAlignment = alignment
return self
}
// MARK: 1.4、设置富文本文字
/// 设置富文本文字
/// - Parameter attributedText: 富文本文字
/// - Returns: 返回自身
@discardableResult
func attributedText(_ attributedText: NSAttributedString) -> Self {
self.attributedText = attributedText
return self
}
// MARK: 1.5、设置文本颜色
/// 设置文本颜色
/// - Parameter color: 颜色
/// - Returns: 返回自身
@discardableResult
func color(_ color: UIColor) -> Self {
textColor = color
return self
}
// MARK: 1.6、设置文本颜色（十六进制字符串）
/// 设置文本颜色（十六进制字符串）
/// - Parameter hex: 十六进制字符串
/// - Returns: 返回自身
@discardableResult
func color(_ hex: String) -> Self {
textColor = UIColor.hexStringColor(hexString: hex)
return self
}
// MARK: 1.7、设置字体的大小
/// 设置字体的大小
/// - Parameter font: 字体的大小
/// - Returns: 返回自身
@discardableResult
func font(_ font: UIFont) -> Self {
self.font = font
return self
}
// MARK: 1.8、设置字体的大小
/// 设置字体的大小
/// - Parameter fontSize: 字体的大小
/// - Returns: 返回自身
@discardableResult
func font(_ fontSize: CGFloat) -> Self {
font = UIFont.systemFont(ofSize: fontSize)
return self
}
// MARK: 1.9、设置字体的大小（粗体）
/// 设置字体的大小（粗体）
/// - Parameter fontSize: 字体的大小
/// - Returns: 返回自身
@discardableResult
func boldFont(_ fontSize: CGFloat) -> Self {
font = UIFont.boldSystemFont(ofSize: fontSize)
return self
}
}
二、其他的基本扩展
// MARK:- 二、其他的基本扩展
public extension UILabel {
// MARK: 2.1、获取已知 frame 的 label 的文本行数 & 每一行内容
/// 获取已知 frame 的 label 的文本行数 & 每一行内容
/// - Parameters:
/// - lineSpace: 行间距
/// - textSpace: 字间距，默认为0.0
/// - paraSpace: 段间距，默认为0.0
/// - Returns: label 的文本行数 & 每一行内容
func linesCountAndLinesContent(lineSpace: CGFloat, textSpace: CGFloat = 0.0, paraSpace: CGFloat = 0.0) -> (Int?, [String]?) {
return linesCountAndLinesContent(accordWidth: frame.size.width, lineSpace: lineSpace, textSpace: textSpace, paraSpace: paraSpace)
}
// MARK: 2.2、获取已知 width 的 label 的文本行数 & 每一行内容
/// 获取已知 width 的 label 的文本行数 & 每一行内容
/// - Parameters:
/// - accordWidth: label 的 width
/// - lineSpace: 行间距
/// - textSpace: 字间距，默认为0.0
/// - paraSpace: 段间距，默认为0.0
/// - Returns: description
func linesCountAndLinesContent(accordWidth: CGFloat, lineSpace: CGFloat, textSpace: CGFloat = 0.0, paraSpace: CGFloat = 0.0) -> (Int?, [String]?) {
guard let t = text, let f = font else {return (0, nil)}
let align = textAlignment
let c_fn = f.fontName as CFString
let fp = f.pointSize
let c_f = CTFontCreateWithName(c_fn, fp, nil)
let contentDict = UILabel.genTextStyle(text: t as NSString, linebreakmode: NSLineBreakMode.byCharWrapping, align: align, font: f, lineSpace: lineSpace, textSpace: textSpace, paraSpace: paraSpace)
let attr = NSMutableAttributedString(string: t)
let range = NSRange(location: 0, length: attr.length)
attr.addAttributes(contentDict, range: range)
attr.addAttribute(NSAttributedString.Key.font, value: c_f, range: range)
let frameSetter = CTFramesetterCreateWithAttributedString(attr as CFAttributedString)
let path = CGMutablePath()
/// 2.5 是经验误差值
path.addRect(CGRect(x: 0, y: 0, width: accordWidth - 2.5, height: CGFloat(MAXFLOAT)))
let framef = CTFramesetterCreateFrame(frameSetter, CFRangeMake(0, 0), path, nil)
let lines = CTFrameGetLines(framef) as NSArray
var lineArr = [String]()
for line in lines {
let lineRange = CTLineGetStringRange(line as! CTLine)
let lineString = t.sub(start: lineRange.location, length: lineRange.length)
lineArr.append(lineString as String)
}
return (lineArr.count, lineArr)
}
// MARK: 2.3、获取第一行内容
/// 获取第一行内容
var firstLineString: String? {
return self.linesCountAndLinesContent(lineSpace: 0.0).1?.first
}
// MARK: 2.4、改变行间距
/// 改变行间距
/// - Parameter space: 行间距大小
func changeLineSpace(space: CGFloat) {
if self.text == nil || self.text == "" {
return
}
let text = self.text
let attributedString = NSMutableAttributedString(string: text!)
let paragraphStyle = NSMutableParagraphStyle()
paragraphStyle.lineSpacing = space
attributedString.addAttribute(NSAttributedString.Key.paragraphStyle, value: paragraphStyle, range: .init(location: 0, length: text!.count))
self.attributedText = attributedString
self.sizeToFit()
}
// MARK: 2.5、改变字间距
/// 改变字间距
/// - Parameter space: 字间距大小
func changeWordSpace(space: CGFloat) {
if self.text == nil || self.text == "" {
return
}
let text = self.text
let attributedString = NSMutableAttributedString(string: text!, attributes: [NSAttributedString.Key.kern:space])
let paragraphStyle = NSMutableParagraphStyle()
attributedString.addAttribute(NSAttributedString.Key.paragraphStyle, value: paragraphStyle, range: .init(location: 0, length: text!.count))
self.attributedText = attributedString
self.sizeToFit()
}
// MARK: 2.6、改变字间距和行间距
/// 改变字间距和行间距
/// - Parameters:
/// - lineSpace: 行间距
/// - wordSpace: 字间距
func changeSpace(lineSpace: CGFloat, wordSpace: CGFloat) {
if self.text == nil || self.text == "" {
return
}
let text = self.text
let attributedString = NSMutableAttributedString(string: text!, attributes: [NSAttributedString.Key.kern:wordSpace])
let paragraphStyle = NSMutableParagraphStyle()
paragraphStyle.lineSpacing = lineSpace
attributedString.addAttribute(NSAttributedString.Key.paragraphStyle, value: paragraphStyle, range: .init(location: 0, length: text!.count))
self.attributedText = attributedString
self.sizeToFit()
}
// MARK: 设置文本样式
/// 设置文本样式
/// - Parameters:
/// - text: 文字内容
/// - linebreakmode: 结尾部分的内容以……方式省略 ( "...wxyz" ,"abcd..." ,"ab...yz")
/// - align: 文本对齐方式：（左，中，右，两端对齐，自然）
/// - font: 字体大小
/// - lineSpace: 字体的行间距
/// - textSpace: 设定字符间距，取值为 NSNumber 对象（整数），正值间距加宽，负值间距变窄
/// - paraSpace: 段与段之间的间距
/// - Returns: 返回样式 [NSAttributedString.Key : Any]
private class func genTextStyle(text: NSString, linebreakmode: NSLineBreakMode, align: NSTextAlignment, font: UIFont, lineSpace: CGFloat, textSpace: CGFloat, paraSpace: CGFloat) -> [NSAttributedString.Key : Any] {
let style = NSMutableParagraphStyle()
// 结尾部分的内容以……方式省略 ( "...wxyz" ,"abcd..." ,"ab...yz")
/**
case byWordWrapping = 0 // 以单词为显示单位显示，后面部分省略不显示
case byCharWrapping = 1 // 以字符为显示单位显示，后面部分省略不显示
case byClipping = 2 // 剪切与文本宽度相同的内容长度，后半部分被删除
case byTruncatingHead = 3 // 前面部分文字以……方式省略，显示尾部文字内容
case byTruncatingTail = 4 // 中间的内容以……方式省略，显示头尾的文字内容
case byTruncatingMiddle = 5 // 结尾部分的内容以……方式省略，显示头的文字内容
*/
style.lineBreakMode = linebreakmode
// 文本对齐方式：（左，中，右，两端对齐，自然）
style.alignment = align
// 字体的行间距
style.lineSpacing = lineSpace
// 连字属性 在iOS，唯一支持的值分别为0和1
style.hyphenationFactor = 1.0
// 首行缩进
style.firstLineHeadIndent = 0.0
// 段与段之间的间距
style.paragraphSpacing = paraSpace
// 段首行空白空间
style.paragraphSpacingBefore = 0.0
// 整体缩进(首行除外)
style.headIndent = 0.0
// 文本行末缩进距离
style.tailIndent = 0.0
/*
// 一组NSTextTabs。 内容应按位置排序。 默认值是一个由12个左对齐制表符组成的数组，间隔为28pt ？？？？？
style.tabStops =
// 一个布尔值，指示系统在截断文本之前是否可以收紧字符间间距 ？？？？？
style.allowsDefaultTighteningForTruncation = true
// 文档范围的默认选项卡间隔 ？？？？？
style.defaultTabInterval = 1
// 最低行高（设置最低行高后，如果文本小于20行，会通过增加行间距达到20行的高度）
style.minimumLineHeight = 10;
// 最高行高（设置最高行高后，如果文本大于10行，会通过降低行间距达到10行的高度）
style.maximumLineHeight = 20;
//从左到右的书写方向
style.baseWritingDirection = .leftToRight
// 在受到最小和最大行高约束之前，自然线高度乘以该因子（如果为正） 多少倍行间距
style.lineHeightMultiple = 15
*/
let dict = [
NSAttributedString.Key.font : font, NSAttributedString.Key.paragraphStyle : style, NSAttributedString.Key.kern : textSpace] as [NSAttributedString.Key : Any]
return dict
}
}
