YYKit源码探究（七十一） —— NSMutableAttributedString分类之Set character attribute as property（十）

版本记录

版本号	时间
V1.0	2018.04.01

前言

iOS圈内有几个人大家基本都知道，比如说王巍、唐巧，还有YYKit框架的作者现任职于滴滴的郭曜源 - ibireme等。这里有一篇唐巧对他的专访，还有他的 GitHub - Yaoyuan 和 博客，这里贴出来框架YYKit 框架。接下来几篇我们就一起来看一下这个框架。感兴趣的可以看上面写的几篇。
1. YYKit源码探究（一） —— 基本概览
2. YYKit源码探究（二） —— NSString分类之Hash（一）
3. YYKit源码探究（三） —— NSString分类之Encode and decode（二）
4. YYKit源码探究（四） —— NSString分类之Drawing（三）
5. YYKit源码探究（五） —— NSString分类之Regular Expression（四）
6. YYKit源码探究（六） —— NSString分类之NSNumber Compatible（五）
7. YYKit源码探究（七） —— NSString分类之Utilities（六）
8. YYKit源码探究（八） —— NSNumber分类（一）
9. YYKit源码探究（九） —— UIFont分类之架构分析和Font Traits（一）
10. YYKit源码探究（十） —— UIFont分类之Create font（二）
11. YYKit源码探究（十一） —— UIFont分类之Load and unload font（三）
12. YYKit源码探究（十二） —— UIFont分类之Dump font data（四）
13. YYKit源码探究（十三） —— UIImage分类之框架结构和Create image部分（一）
14. YYKit源码探究（十四） —— UIImage分类之Image Info（二）
15. YYKit源码探究（十五） —— UIImage分类之Modify Image（三）
16. YYKit源码探究（十六） —— UIImage分类之Image Effect（四）
17. YYKit源码探究（十七） —— UIImageView分类之架构和image部分（一）
18. YYKit源码探究（十八） —— UIImageView分类之highlight image部分（二）
19. YYKit源码探究（十九） —— UIScreen分类（一）
20. YYKit源码探究（二十） —— UIScrollView分类（一）
21. YYKit源码探究（二十一） —— UITableView分类（一）
22. YYKit源码探究（二十二） —— UITextField分类（一）
23. YYKit源码探究（二十三） —— UIView分类（一）
24. YYKit源码探究（二十四） —— UIPasteboard分类（一）
25. YYKit源码探究（二十五） —— UIGestureRecognizer分类（一）
26. YYKit源码探究（二十六） —— UIDevice分类框架及Device Information（一）
27. YYKit源码探究（二十七） —— UIDevice分类之Network Information（二）
28. YYKit源码探究（二十八） —— UIDevice分类之Disk Space（三）
29. YYKit源码探究（二十九） —— UIDevice分类之Memory Information（四）
30. YYKit源码探究（三十） —— UIDevice分类之CPU Information（五）
31. YYKit源码探究（三十一） —— UIControl分类（一）
32. YYKit源码探究（三十二） —— UIColor分类之Create a UIColor Object（一）
33. YYKit源码探究（三十三） —— UIColor分类之Get color's description（二）
34. YYKit源码探究（三十四） —— UIColor分类之Retrieving Color Information（三）
35. YYKit源码探究（三十五） —— UIButton分类之image（一）
36. YYKit源码探究（三十六） —— UIButton分类之background image（二）
37. YYKit源码探究（三十七） —— UIBezierPath分类（一）
38. YYKit源码探究（三十八） —— UIBarButtonItem分类（一）
39. YYKit源码探究（三十九） —— UIApplication分类（一）
40. YYKit源码探究（四十） —— NSTimer分类（一）
41. YYKit源码探究（四十一） —— NSParagraphStyle分类（一）
42. YYKit源码探究（四十二） —— NSObject分类之YYModel（一）
43. YYKit源码探究（四十三） —— NSObject分类之KVO（二）
44. YYKit源码探究（四十四） —— NSObject分类之Sending messages with variable parameters（三）
45. YYKit源码探究（四十五） —— NSObject分类之Swap method (Swizzling)（四）
46. YYKit源码探究（四十六） —— NSObject分类之Associate value（五）
47. YYKit源码探究（四十七） —— NSObject分类之Other（六）
48. YYKit源码探究（四十八） —— NSNotificationCenter分类（一）
49. YYKit源码探究（四十九） —— NSKeyedUnarchiver分类（一）
50. YYKit源码探究（五十） —— NSDictionary分类之Dictionary Convertor（一）
51. YYKit源码探究（五十一） —— NSDictionary分类之Dictionary Value Getter（二）
52. YYKit源码探究（五十二） —— NSDictionary分类之NSMutableDictionary（三）
53. YYKit源码探究（五十三） —— NSDate分类之Component Properties（一）
54. YYKit源码探究（五十四） —— NSDate分类之Date modify（二）
55. YYKit源码探究（五十五） —— NSDate分类之Date Format（三）
56. YYKit源码探究（五十六） —— NSData分类之Hash（一）
57. YYKit源码探究（五十七） —— NSData分类之Encrypt and Decrypt（二）
58. YYKit源码探究（五十八） —— NSData分类之Encode and decode（三）
59. YYKit源码探究（五十九） —— NSData分类之Inflate and deflate（四）
60. YYKit源码探究（六十） —— NSData分类之Others（五）
61. YYKit源码探究（六十一） —— NSBundle分类（一）
62. YYKit源码探究（六十二） —— NSAttributedString分类之基本（一）
63. YYKit源码探究（六十三） —— NSAttributedString分类之Retrieving character attribute information（二）
64. YYKit源码探究（六十四） —— NSAttributedString分类之Get character attribute as property（三）
65. YYKit源码探究（六十五） —— NSAttributedString分类之Get paragraph attribute as property（四）
66. YYKit源码探究（六十六） —— NSAttributedString分类之Get YYText attribute as property（五）
67. YYKit源码探究（六十七） —— NSAttributedString分类之Query for YYText（六）
68. YYKit源码探究（六十八） —— NSAttributedString分类之Create attachment string for YYText（七）
69. YYKit源码探究（六十九） —— NSAttributedString分类之Utility（八）
70. YYKit源码探究（七十） —— NSMutableAttributedString分类之Set character attribute（九）

回顾

上一篇主要介绍了NSMutableAttributedString分类的Set character attribute部分，这一篇主要看一下NSMutableAttributedString分类的Set character attribute as property部分。

---

API

下面我们看一下API

1. @property (nullable, nonatomic, strong, readwrite) UIFont *font; 和 - (void)setFont:(nullable UIFont *)font range:(NSRange)range;

文本的字体，默认是Helvetica (Neue) 12。

方法实现

- (void)setFont:(UIFont *)font {
    /*
     In iOS7 and later, UIFont is toll-free bridged to CTFontRef,
     although Apple does not mention it in documentation.
     
     In iOS6, UIFont is a wrapper for CTFontRef, so CoreText can alse use UIfont,
     but UILabel/UITextView cannot use CTFontRef.
     
     We use UIFont for both CoreText and UIKit.
     */
    [self setFont:font range:NSMakeRange(0, self.length)];
}

- (void)setFont:(UIFont *)font range:(NSRange)range {
    /*
     In iOS7 and later, UIFont is toll-free bridged to CTFontRef,
     although Apple does not mention it in documentation.
     
     In iOS6, UIFont is a wrapper for CTFontRef, so CoreText can alse use UIfont,
     but UILabel/UITextView cannot use CTFontRef.
     
     We use UIFont for both CoreText and UIKit.
     */
    [self setAttribute:NSFontAttributeName value:font range:range];
}

2. @property (nullable, nonatomic, strong, readwrite) NSNumber *kern; 和 - (void)setKern:(nullable NSNumber *)kern range:(NSRange)range;

字距调整，默认是标准字距。 kerning属性表示后面的字符应该从其当前字符的字体定义的默认偏移量中移动多少个点; 整数的kern指示更远的移位，而负值kern指示更接近当前的字符的移位。 如果此属性不存在，则将使用标准字距。 如果此属性设置为0.0，则根本不会执行字距调整。

方法实现

- (void)setKern:(NSNumber *)kern {
    [self setKern:kern range:NSMakeRange(0, self.length)];
}

- (void)setKern:(NSNumber *)kern range:(NSRange)range {
    [self setAttribute:NSKernAttributeName value:kern range:range];
}

3. @property (nullable, nonatomic, strong, readwrite) UIColor *color; 和 - (void)setColor:(nullable UIColor *)color range:(NSRange)range;

获取foreground color，默认是black。

方法实现

- (void)setColor:(UIColor *)color {
    [self setColor:color range:NSMakeRange(0, self.length)];
}

- (void)setColor:(UIColor *)color range:(NSRange)range {
    [self setAttribute:(id)kCTForegroundColorAttributeName value:(id)color.CGColor range:range];
    [self setAttribute:NSForegroundColorAttributeName value:color range:range];
}

- (void)setAttribute:(NSString *)name value:(id)value range:(NSRange)range {
    if (!name || [NSNull isEqual:name]) return;
    if (value && ![NSNull isEqual:value]) [self addAttribute:name value:value range:range];
    else [self removeAttribute:name range:range];
}

4. @property (nullable, nonatomic, strong, readwrite) UIColor *backgroundColor; 和 - (void)setBackgroundColor:(nullable UIColor *)backgroundColor range:(NSRange)range;

获取background color，默认是nil，没有背景色。

方法实现

- (void)setBackgroundColor:(UIColor *)backgroundColor {
    [self setBackgroundColor:backgroundColor range:NSMakeRange(0, self.length)];
}

- (void)setBackgroundColor:(UIColor *)backgroundColor range:(NSRange)range {
    [self setAttribute:NSBackgroundColorAttributeName value:backgroundColor range:range];
}

5. @property (nullable, nonatomic, strong, readwrite) NSNumber *strokeWidth; 和 - (void)setStrokeWidth:(nullable NSNumber *)strokeWidth range:(NSRange)range;

获取描边的线宽。默认值是0，此属性解释为字体点值的百分比，用于控制文本绘图模式：正值仅影响绘图描边；负值是描边和填充。 轮廓文本的典型值为3.0。

方法实现

- (void)setStrokeWidth:(NSNumber *)strokeWidth {
    [self setStrokeWidth:strokeWidth range:NSMakeRange(0, self.length)];
}

- (void)setStrokeWidth:(NSNumber *)strokeWidth range:(NSRange)range {
    [self setAttribute:NSStrokeWidthAttributeName value:strokeWidth range:range];
}

6. @property (nullable, nonatomic, strong, readwrite) UIColor *strokeColor; 和 - (void)setStrokeColor:(nullable UIColor *)strokeColor range:(NSRange)range;

获取描边的颜色。默认是nil，(same as foreground color)。

方法实现

- (void)setStrokeColor:(UIColor *)strokeColor {
    [self setStrokeColor:strokeColor range:NSMakeRange(0, self.length)];
}

- (void)setStrokeColor:(UIColor *)strokeColor range:(NSRange)range {
    [self setAttribute:(id)kCTStrokeColorAttributeName value:(id)strokeColor.CGColor range:range];
    [self setAttribute:NSStrokeColorAttributeName value:strokeColor range:range];
}

7. @property (nullable, nonatomic, strong, readwrite) NSShadow *shadow; 和 - (void)setShadow:(nullable NSShadow *)shadow range:(NSRange)range;

获取的是文本阴影，默认值是nil，没有阴影。

方法实现

- (void)setShadow:(NSShadow *)shadow {
    [self setShadow:shadow range:NSMakeRange(0, self.length)];
}

- (void)setShadow:(NSShadow *)shadow range:(NSRange)range {
    [self setAttribute:NSShadowAttributeName value:shadow range:range];
}

8. @property (nonatomic, readwrite) NSUnderlineStyle strikethroughStyle; 和 - (void)setStrikethroughStyle:(NSUnderlineStyle)strikethroughStyle range:(NSRange)range;

获取strikethrough style，默认值是NSUnderlineStyleNone。

方法实现

- (void)setStrikethroughStyle:(NSUnderlineStyle)strikethroughStyle {
    [self setStrikethroughStyle:strikethroughStyle range:NSMakeRange(0, self.length)];
}

- (void)setStrikethroughStyle:(NSUnderlineStyle)strikethroughStyle range:(NSRange)range {
    NSNumber *style = strikethroughStyle == 0 ? nil : @(strikethroughStyle);
    [self setAttribute:NSStrikethroughStyleAttributeName value:style range:range];
}

9. @property (nullable, nonatomic, strong, readwrite) UIColor *strikethroughColor; 和 - (void)setStrikethroughColor:(nullable UIColor *)strikethroughColor range:(NSRange)range

获取strikethrough color，默认值是nil，(same as foreground color)。

方法实现

- (void)setStrikethroughColor:(UIColor *)strikethroughColor {
    [self setStrikethroughColor:strikethroughColor range:NSMakeRange(0, self.length)];
}

- (void)setStrikethroughColor:(UIColor *)strikethroughColor range:(NSRange)range {
    if (kSystemVersion >= 7) {
        [self setAttribute:NSStrikethroughColorAttributeName value:strikethroughColor range:range];
    }
}

10. @property (nonatomic, readwrite) NSUnderlineStyle underlineStyle; 和 - (void)setUnderlineStyle:(NSUnderlineStyle)underlineStyle range:(NSRange)range;

获取下划线样式，默认值是NSUnderlineStyleNone，没有下划线。

方法实现

- (void)setUnderlineStyle:(NSUnderlineStyle)underlineStyle {
    [self setUnderlineStyle:underlineStyle range:NSMakeRange(0, self.length)];
}

- (void)setUnderlineStyle:(NSUnderlineStyle)underlineStyle range:(NSRange)range {
    NSNumber *style = underlineStyle == 0 ? nil : @(underlineStyle);
    [self setAttribute:NSUnderlineStyleAttributeName value:style range:range];
}

11. @property (nullable, nonatomic, strong, readwrite) UIColor *underlineColor; 和 - (void)setUnderlineColor:(nullable UIColor *)underlineColor range:(NSRange)range;

获取下划线颜色，默认值是nil。

方法实现

- (void)setUnderlineColor:(UIColor *)underlineColor {
    [self setUnderlineColor:underlineColor range:NSMakeRange(0, self.length)];
}

- (void)setUnderlineColor:(UIColor *)underlineColor range:(NSRange)range {
    [self setAttribute:(id)kCTUnderlineColorAttributeName value:(id)underlineColor.CGColor range:range];
    if (kSystemVersion >= 7) {
        [self setAttribute:NSUnderlineColorAttributeName value:underlineColor range:range];
    }
}

12. @property (nullable, nonatomic, strong, readwrite) NSNumber *ligature; 和 - (void)setLigature:(nullable NSNumber *)ligature range:(NSRange)range;

获取Ligature formation control。

默认值为int值1，ligature属性确定显示字符串时应使用哪种ligature。 值为0表示只应使用正确呈现文本所必需的ligature，1表示应使用标准ligature，而2表示应使用所有可用ligature。 哪些ligature是标准的，取决于脚本和可能的字体。

方法实现

- (void)setLigature:(NSNumber *)ligature {
    [self setLigature:ligature range:NSMakeRange(0, self.length)];
}

- (void)setLigature:(NSNumber *)ligature range:(NSRange)range {
    [self setAttribute:NSLigatureAttributeName value:ligature range:range];
}

13. @property (nullable, nonatomic, strong, readwrite) NSString *textEffect; 和 - (void)setTextEffect:(nullable NSString *)textEffect range:(NSRange)range

获取文本效果，默认值是nil，当前支持的值是NSTextEffectLetterpressStyle。

方法实现

- (void)setTextEffect:(NSString *)textEffect {
    [self setTextEffect:textEffect range:NSMakeRange(0, self.length)];
}

- (void)setTextEffect:(NSString *)textEffect range:(NSRange)range {
    if (kSystemVersion >= 7) {
        [self setAttribute:NSTextEffectAttributeName value:textEffect range:range];
    }
}

14. @property (nullable, nonatomic, strong, readwrite) NSNumber *obliqueness; 和 - (void)setObliqueness:(nullable NSNumber *)obliqueness range:(NSRange)range

要应用于字形的倾斜，默认值是0，没有倾斜。

方法实现

- (void)setObliqueness:(NSNumber *)obliqueness {
    [self setObliqueness:obliqueness range:NSMakeRange(0, self.length)];
}

- (void)setObliqueness:(NSNumber *)obliqueness range:(NSRange)range {
    if (kSystemVersion >= 7) {
        [self setAttribute:NSObliquenessAttributeName value:obliqueness range:range];
    }
}

15. @property (nullable, nonatomic, strong, readwrite) NSNumber *expansion; 和 - (void)setExpansion:(nullable NSNumber *)expansion range:(NSRange)range

要应用于字形的扩展因子的日志，默认值是0，没有扩展。

方法实现

- (void)setExpansion:(NSNumber *)expansion {
    [self setExpansion:expansion range:NSMakeRange(0, self.length)];
}

- (void)setExpansion:(NSNumber *)expansion range:(NSRange)range {
    if (kSystemVersion >= 7) {
        [self setAttribute:NSExpansionAttributeName value:expansion range:range];
    }
}

16. @property (nullable, nonatomic, strong, readwrite) NSNumber *baselineOffset; 和 - (void)setBaselineOffset:(nullable NSNumber *)baselineOffset range:(NSRange)range NS_AVAILABLE_IOS(7_0);

字符基线的偏移量，以点为单位。默认值是0。

方法实现

- (void)setBaselineOffset:(NSNumber *)baselineOffset {
    [self setBaselineOffset:baselineOffset range:NSMakeRange(0, self.length)];
}

- (void)setBaselineOffset:(NSNumber *)baselineOffset range:(NSRange)range {
    if (kSystemVersion >= 7) {
        [self setAttribute:NSBaselineOffsetAttributeName value:baselineOffset range:range];
    }
}

17. @property (nonatomic, readwrite) BOOL verticalGlyphForm; 和 - (void)setVerticalGlyphForm:(BOOL)verticalGlyphForm range:(NSRange)range;

获取Glyph orientation control，默认值为NO。NO的值表示要使用水平字形，YES表示要使用垂直字形。

方法实现

- (void)setVerticalGlyphForm:(BOOL)verticalGlyphForm {
    [self setVerticalGlyphForm:verticalGlyphForm range:NSMakeRange(0, self.length)];
}

- (void)setVerticalGlyphForm:(BOOL)verticalGlyphForm range:(NSRange)range {
    NSNumber *v = verticalGlyphForm ? @(YES) : nil;
    [self setAttribute:NSVerticalGlyphFormAttributeName value:v range:range];
}

18. @property (nullable, nonatomic, strong, readwrite) NSString *language; 和 - (void)setLanguage:(nullable NSString *)language range:(NSRange)range

指定文本语言。

值必须是包含区域设置标识符的NSString。 默认值未设置。 当这个属性被设置为一个有效的标识符时，它将被用来选择本地化的字形（如果字体支持）和特定于语言环境的换行规则。

方法实现

- (void)setLanguage:(NSString *)language {
    [self setLanguage:language range:NSMakeRange(0, self.length)];
}

- (void)setLanguage:(NSString *)language range:(NSRange)range {
    if (kSystemVersion >= 7) {
        [self setAttribute:(id)kCTLanguageAttributeName value:language range:range];
    }
}

19. @property (nullable, nonatomic, strong, readwrite) NSArray *writingDirection; 和 - (void)setWritingDirection:(nullable NSArray *)writingDirection range:(NSRange)range;

Specifies a bidirectional override or embedding

可以参考NSWritingDirection和 NSWritingDirectionAttributeName。

方法实现

- (void)setWritingDirection:(NSArray *)writingDirection {
    [self setWritingDirection:writingDirection range:NSMakeRange(0, self.length)];
}

- (void)setWritingDirection:(NSArray *)writingDirection range:(NSRange)range {
    [self setAttribute:(id)kCTWritingDirectionAttributeName value:writingDirection range:range];
}

20. @property (nullable, nonatomic, strong, readwrite) NSParagraphStyle *paragraphStyle; 和 - (void)setParagraphStyle:(nullable NSParagraphStyle *)paragraphStyle range:(NSRange)range;

一个NSParagraphStyle对象，用于指定类似line alignment、tab rulers, writing direction等事情。

方法实现

- (void)setParagraphStyle:(NSParagraphStyle *)paragraphStyle {
    /*
     NSParagraphStyle is NOT toll-free bridged to CTParagraphStyleRef.
     
     CoreText can use both NSParagraphStyle and CTParagraphStyleRef,
     but UILabel/UITextView can only use NSParagraphStyle.
     
     We use NSParagraphStyle in both CoreText and UIKit.
     */
    [self setParagraphStyle:paragraphStyle range:NSMakeRange(0, self.length)];
}

- (void)setParagraphStyle:(NSParagraphStyle *)paragraphStyle range:(NSRange)range {
    /*
     NSParagraphStyle is NOT toll-free bridged to CTParagraphStyleRef.
     
     CoreText can use both NSParagraphStyle and CTParagraphStyleRef,
     but UILabel/UITextView can only use NSParagraphStyle.
     
     We use NSParagraphStyle in both CoreText and UIKit.
     */
    [self setAttribute:NSParagraphStyleAttributeName value:paragraphStyle range:range];
}

后记

本篇主要介绍了NSMutableAttributedString分类的Set character attribute as property，感兴趣的给个赞或者关注~~~