示例说明

查看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)
    }
}