iOS 富文本经常使用封装(NSAttributedString浅析)

最近常常遇到关于富文本的一些需求，特此封装了几个最经常使用的API分享给你们，但授之以鱼不如授之以渔，接下来会顺便谈谈NSAttributedString，确保你读了本篇文章可以本身封装关于富文本的API，本文封装API的示例Demo再此，拿去用吧！骚年们！

1、经常使用需求封装

• 需求：在咱们平常开发中，某些句子中会有改变某些字颜色的需求，固然颜色通常而言就是为了着重强调，常为同一种颜色，因此下面代码是单纯改变一句话中的某些字的颜色

/** * 单纯改变一句话中的某些字的颜色 * * @param color 须要改变成的颜色 * @param totalStr 总的字符串 * @param subArray 须要改变颜色的文字数组 * * @return 生成的富文本 */
+ (NSMutableAttributedString *)ls_changeCorlorWithColor:(UIColor *)color TotalString:(NSString *)totalStr SubStringArray:(NSArray *)subArray {

    NSMutableAttributedString *attributedStr = [[NSMutableAttributedString alloc] initWithString:totalStr];
    for (NSString *rangeStr in subArray) {

        NSRange range = [totalStr rangeOfString:rangeStr options:NSBackwardsSearch];
        [attributedStr addAttribute:NSForegroundColorAttributeName value:color range:range];
    }

    return attributedStr;
}复制代码

• 需求：须要更改字间距来适应总体UI

/** * 单纯改变句子的字间距（须要 <CoreText/CoreText.h>） * * @param totalString 须要更改的字符串 * @param space 字间距 * * @return 生成的富文本 */
+ (NSMutableAttributedString *)ls_changeSpaceWithTotalString:(NSString *)totalString Space:(CGFloat)space {

    NSMutableAttributedString *attributedStr = [[NSMutableAttributedString alloc] initWithString:totalString];
    long number = space;
    CFNumberRef num = CFNumberCreate(kCFAllocatorDefault,kCFNumberSInt8Type,&number);
    [attributedStr addAttribute:(id)kCTKernAttributeName value:(__bridge id)num range:NSMakeRange(0,[attributedStr length])];
    CFRelease(num);

    return attributedStr;
}复制代码

• 需求：须要改变行间距来适应总体UI

/** * 单纯改变段落的行间距 * * @param totalString 须要更改的字符串 * @param lineSpace 行间距 * * @return 生成的富文本 */
+ (NSMutableAttributedString *)ls_changeLineSpaceWithTotalString:(NSString *)totalString LineSpace:(CGFloat)lineSpace {

    NSMutableAttributedString *attributedStr = [[NSMutableAttributedString alloc] initWithString:totalString];

    NSMutableParagraphStyle * paragraphStyle = [[NSMutableParagraphStyle alloc] init];
    [paragraphStyle setLineSpacing:lineSpace];

    [attributedStr addAttribute:NSParagraphStyleAttributeName value:paragraphStyle range:NSMakeRange(0, [totalString length])];

    return attributedStr;
}复制代码

• 需求：同时更改行间距和字间距

/** * 同时更改行间距和字间距 * * @param totalString 须要改变的字符串 * @param lineSpace 行间距 * @param textSpace 字间距 * * @return 生成的富文本 */
+ (NSMutableAttributedString *)ls_changeLineAndTextSpaceWithTotalString:(NSString *)totalString LineSpace:(CGFloat)lineSpace textSpace:(CGFloat)textSpace {

    NSMutableAttributedString *attributedStr = [[NSMutableAttributedString alloc] initWithString:totalString];

    NSMutableParagraphStyle * paragraphStyle = [[NSMutableParagraphStyle alloc] init];
    [paragraphStyle setLineSpacing:lineSpace];

    [attributedStr addAttribute:NSParagraphStyleAttributeName value:paragraphStyle range:NSMakeRange(0, [totalString length])];

    long number = textSpace;
    CFNumberRef num = CFNumberCreate(kCFAllocatorDefault,kCFNumberSInt8Type,&number);
    [attributedStr addAttribute:(id)kCTKernAttributeName value:(__bridge id)num range:NSMakeRange(0,[attributedStr length])];
    CFRelease(num);

    return attributedStr;
}复制代码

• 需求：更改某些文字的颜色并修改其字体，突出重点强调

/** * 改变某些文字的颜色 并单独设置其字体 * * @param font 设置的字体 * @param color 颜色 * @param totalString 总的字符串 * @param subArray 想要变色的字符数组 * * @return 生成的富文本 */
+ (NSMutableAttributedString *)ls_changeFontAndColor:(UIFont *)font Color:(UIColor *)color TotalString:(NSString *)totalString SubStringArray:(NSArray *)subArray {

    NSMutableAttributedString *attributedStr = [[NSMutableAttributedString alloc] initWithString:totalString];

    for (NSString *rangeStr in subArray) {

        NSRange range = [totalString rangeOfString:rangeStr options:NSBackwardsSearch];

        [attributedStr addAttribute:NSForegroundColorAttributeName value:color range:range];
        [attributedStr addAttribute:NSFontAttributeName value:font range:range];
    }

    return attributedStr;
}复制代码

以上几种API综合效果图以下

2、谈谈NSAttributedString

一、初始化方法

- (instancetype)initWithString:(NSString *)str;
- (instancetype)initWithString:(NSString *)str attributes:(nullable NSDictionary<NSString *, id> *)attrs;
- (instancetype)initWithAttributedString:(NSAttributedString *)attrStr;复制代码

• 第一种使用字符串初始化初始化富文本
• 第二种使用字符串及属性字典（就是配置富文本的相关属性）初始化富文本
• 第三种就是用其余富文本初始化富文本

二、经常使用操做API

• 为某一范围内文字添加某个属性

- (void)addAttribute:(NSString *)name value:(id)value range:(NSRange)range;复制代码

示例：

• 为某一范围内文字添加多个属性（两个API效果与格式同样）

- (void)addAttributes:(NSDictionary<NSString *, id> *)attrs range:(NSRange)range;

- (void)setAttributes:(nullable NSDictionary<NSString *, id> *)attrs range:(NSRange)range;复制代码

示例：

• 移除某范围内的某个属性（可与添加属性API对照，不在示例）

- (void)removeAttribute:(NSString *)name range:(NSRange)range;复制代码

• 其余部分API（见名知意，可与NSString对照不在赘述）

- (void)replaceCharactersInRange:(NSRange)range withAttributedString:(NSAttributedString *)attrString;
- (void)insertAttributedString:(NSAttributedString *)attrString atIndex:(NSUInteger)loc;
- (void)appendAttributedString:(NSAttributedString *)attrString;
- (void)deleteCharactersInRange:(NSRange)range;
- (void)setAttributedString:(NSAttributedString *)attrString;复制代码

三、相关可设置属性对照

经过API咱们能够知道，对于富文原本说添加单个属性和添加属性字典称为其核心方法，就是一个key对应一个Value，只要能了解各类属性所对应效果就能够随意组合，搞出适合各类需求的封装API。

• NSFontAttributeName ：字体字号 value值：UIFont类型
• NSParagraphStyleAttributeName ： 段落样式
  value值：NSParagraphStyle类型（其属性以下）
  • lineSpacing 行间距(具体用法可查看上面的设置行间距API)
  • paragraphSpacing 段落间距
  • alignment 对齐方式
  • firstLineHeadIndent 指定段落开始的缩进像素
  • headIndent 调整所有文字的缩进像素
• NSForegroundColorAttributeName 字体颜色 value值：UIColor类型
• NSBackgroundColorAttributeName 背景颜色 value值：UIColor类型
• NSObliquenessAttributeName 字体粗倾斜 value值：NSNumber类型
• NSExpansionAttributeName 字体加粗 value值：NSNumber类型(比例) 0就是不变 1增长一倍
• NSKernAttributeName 字间距 value值：CGFloat类型
• NSUnderlineStyleAttributeName 下划线 value值：1或0
• NSUnderlineColorAttributeName 下划线颜色 value值：UIColor类型
• NSStrikethroughStyleAttributeName 删除线 value值：1或0
• NSStrikethroughColorAttributeName 删除线颜色 value值：UIColor类型
• NSStrokeColorAttributeName 字体颜色 value值：UIColor类型
• NSStrokeWidthAttributeName 字体描边 value值：CGFloat
• NSLigatureAttributeName 连笔字 value值：1或0
• NSShadowAttributeName 阴影 value值：NSShawdow类型（下面是其属性）
  • shadowOffset 影子与字符串的偏移量
  • shadowBlurRadius 影子的模糊程度
  • shadowColor 影子的颜色
• NSTextEffectAttributeName 设置文本特殊效果,目前只有图版印刷效果可用 value值：NSString类型
• NSAttachmentAttributeName 设置文本附件 value值：NSTextAttachment类型（没研究过，可自行百度研究）
• NSLinkAttributeName 连接 value值：NSURL (preferred) or NSString类型
• NSBaselineOffsetAttributeName 基准线偏移 value值：NSNumber类型
• NSWritingDirectionAttributeName 文字方向 分别表明不一样的文字出现方向 value值：@[@(1),@(2)]
• NSVerticalGlyphFormAttributeName 水平或者竖直文本 在iOS没卵用，不支持竖版 value值：1竖直 0水平

3、示例Demo讲解

Demo在此，点击可跳转

• API路径地址以下：

/YiDing/Class/Helpers/LSCoreToolCenter复制代码

截图以下：

• 使用示例路径以下：

/YiDing/Class/Sections/LSSection/NSMutableAttributedString复制代码

截图以下

4、更新

7.18晚更新：有童鞋想要能够将全部相同的子字符串均可以进行操做，因此添加了一个获取位置数组的方法并封装在内，效果图已经更新，感兴趣的能够去Demo查看。

本文由做者 王隆帅 编写，转载请保留版权网址，感谢您的理解与分享，让生活变的更美好!