示例说明
查看demo
使用介绍
let att = NSMutableAttributedString.init(string: text)
// 设置字体大小
att.mc_addFont(UIFont.systemFont(ofSize: 20), on: NSRange.init(location: 0, length: 4))
// 设置字体颜色
att.mc_addForegroundColor(UIColor.red, range: NSRange.init(location: 5, length: 4))
// 设置背景颜色
att.mc_addBackgroundColor(UIColor.yellow, range: NSRange.init(location: 10, length: 4))
moduleOneLabel.attributedText = att
具体实现
extension NSMutableAttributedString {
// =========================字体的设置=========================//
/// 设置字体大小
public func mc_addFont(_ font: UIFont, on range: NSRange) {
if self.length < range.location + range.length { return }
let attrs = [NSAttributedString.Key.font: font]
self.addAttributes(attrs, range: range)
}
/// 设置字体颜色
public func mc_addForegroundColor(_ color: UIColor, range: NSRange) {
if self.length < range.location + range.length {
return
}
let attrs = [NSAttributedString.Key.foregroundColor: color]
self.addAttributes(attrs, range: range)
}
/// 设置字体的背景颜色
public func mc_addBackgroundColor(_ color: UIColor, range: NSRange) {
if self.length < range.location + range.length {
return
}
let attrs = [NSAttributedString.Key.backgroundColor: color]
self.addAttributes(attrs, range: range)
}
}
extension NSMutableAttributedString {
//=========================文本的处理==========================//
/// 字符间距的设置 字符间距 正值间距加宽，负值间距变窄
public func mc_addKern(_ kern: Int, range: NSRange) {
if self.length < range.location + range.length { return }
let attrs = [NSAttributedString.Key.kern: kern]
self.addAttributes(attrs, range: range)
}
/// 设置字体倾斜度，正值右倾，负值左倾
public func mc_addObliqueness(_ obliqueness: CGFloat, range: NSRange) {
if self.length < range.location + range.length { return }
let attrs = [NSAttributedString.Key.obliqueness: obliqueness]
self.addAttributes(attrs, range: range)
}
/// 设置字体的横向拉伸，正值拉伸 ，负值压缩
public func mc_addExpansion(_ expansion: CGFloat, range: NSRange) {
if self.length < range.location + range.length { return }
let attrs = [NSAttributedString.Key.expansion: expansion]
self.addAttributes(attrs, range: range)
}
/// 文字书写方向
public func mc_addWritingDirection(_ direction: NSWritingDirection, range: NSRange) {
if self.length < range.location + range.length { return }
var value: (Int) = (0)
if direction == .leftToRight {
if #available(iOS 9.0, *) {
value = (NSWritingDirectionFormatType.override.rawValue | NSWritingDirection.leftToRight.rawValue)
} else {
// Fallback on earlier versions
}
} else {
if #available(iOS 9.0, *) {
value = (NSWritingDirectionFormatType.override.rawValue | NSWritingDirection.rightToLeft.rawValue)
} else {
// Fallback on earlier versions
}
}
/**
NSAttributedString.Key.writingDirection接收的是一个数组
*/
/**
//@[@(NSWritingDirectionLeftToRight | NSWritingDirectionEmbedding)]
//@[@(NSWritingDirectionLeftToRight | NSWritingDirectionOverride)]
//@[@(NSWritingDirectionRightToLeft | NSWritingDirectionEmbedding)]
//@[@(NSWritingDirectionRightToLeft | NSWritingDirectionOverride)]
// NSWritingDirectionOverride 和 NSWritingDirectionEmbedding 是指定Unicode双向定义的格式控制算法（具体的没太搞清楚）
*/
let attrs = [NSAttributedString.Key.writingDirection: [value]]
self.addAttributes(attrs, range: range)
}
}
extension NSMutableAttributedString {
//=========================删除线==========================//
/// 设置删除线 NSUnderlineStyle: none不设置，single单细线删除，thick粗单线， Double双细线
public func mc_addStrikethrough(style: NSUnderlineStyle = .single, color: UIColor? = nil, range: NSRange) {
if self.length < range.location + range.length {
return
}
let attr1 = [NSAttributedString.Key.strikethroughStyle: style.rawValue]
self.addAttributes(attr1, range: range)
if let tempColor = color {
let attr2 = [NSAttributedString.Key.strikethroughColor: tempColor]
self.addAttributes(attr2, range: range)
}
}
//=========================下划线==========================//
/// 设置下划线 NSUnderlineStyle: none不设置，single单细线删除，thick粗单线， Double双细线
public func mc_addUnderLine(style: NSUnderlineStyle = .single, color: UIColor? = nil, range: NSRange) {
if self.length < range.location + range.length {
return
}
let attrs = [NSAttributedString.Key.underlineStyle: NSUnderlineStyle.single.rawValue]
self.addAttributes(attrs, range: range)
if let tempColor = color {
let attr2 = [NSAttributedString.Key.underlineColor: tempColor]
self.addAttributes(attr2, range: range)
}
}
}
extension NSMutableAttributedString {
//=========================文字的效果==========================//
/// 设置文字的描边
public func mc_addStroke(color: UIColor, width: CGFloat, range: NSRange) {
/**
设置文字描边颜色，需要NSStrokeWidthAttributeName设置描边宽度，这样就能使文字空心.
NSStrokeWidthAttributeName,该值改变笔画宽度（相对于字体 size 的百分比），负值填充效果，正值中空效果，默认为 0，即不改变。正数只改变描边宽度。负数同时改变文字的描边和填充宽度。例如，对于常见的空心字，这个值通常为 3.0。
同时设置了空心描边和文字前景两个属性，并且NSStrokeWidthAttributeName 属性设置为整数，文字前景色就无效果了
*/
if self.length < range.location + range.length { return }
let attrs = [
NSAttributedString.Key.strokeWidth: width,
NSAttributedString.Key.strokeColor: color
] as [NSAttributedString.Key : Any]
self.addAttributes(attrs, range: range)
}
/// 阴影
public func mc_addShadow(_ shadow: NSShadow, range: NSRange) {
if self.length < range.location + range.length { return }
let attrs = [NSAttributedString.Key.shadow: shadow]
self.addAttributes(attrs, range: range)
}
/// 设置文字的特殊NSAttributedString.Key这一个凸版印刷效果)
public func mc_addTextEffect(effect: NSAttributedString.TextEffectStyle = .letterpressStyle, range: NSRange) {
if self.length < range.location + range.length { return }
let attrs = [NSAttributedString.Key.textEffect: effect]
self.addAttributes(attrs, range: range)
}
}
extension NSMutableAttributedString {
//=========================偏移量==========================//
/// 设置上下偏移量 正数上移，负数下移
public func mc_addBaselineOffset(_ offset: CGFloat, range: NSRange) {
if self.length < range.location + range.length { return }
let attrs = [NSAttributedString.Key.baselineOffset: offset]
self.addAttributes(attrs, range: range)
}
/// 设置行间距
public func mc_addLineSpacing(_ style: NSMutableParagraphStyle, range: NSRange) {
/**
具体请看： https://www.jianshu.com/p/b0afc45bb642
NSAttributedString.Key.paragraphStyle 设置文本段落排版，为NSParagraphStyle对象
paragraphStyle.lineSpacing = 0.0; //增加行高
paragraphStyle.headIndent = 0; //头部缩进，相当于左padding
paragraphStyle.tailIndent = 0; //相当于右padding
paragraphStyle.lineHeightMultiple = 0; //行间距是多少倍
paragraphStyle.alignment = NSTextAlignmentLeft;//对齐方式
paragraphStyle.firstLineHeadIndent = 0; //首行头缩进
paragraphStyle.paragraphSpacing = 0; //段落后面的间距
paragraphStyle.paragraphSpacingBefore = 0; //段落之前的间距
*/
if self.length < range.location + range.length { return }
let attrs = [NSAttributedString.Key.paragraphStyle: style]
self.addAttributes(attrs, range: range)
}
}
extension NSMutableAttributedString {
/// 插入图片
public func mc_addTextAttachment(image: UIImage?, imageFrame: CGRect, atIndex index: Int) {
let attachment = NSTextAttachment.init()
attachment.image = image
attachment.bounds = imageFrame
let att = NSAttributedString(attachment: attachment)
self.insert(att, at: index)
}
}