版本記錄

前言

iOS圈內(nèi)有幾個(gè)人大家基本都知道，比如說(shuō)王巍、唐巧，還有YYKit框架的作者現(xiàn)任職于滴滴的郭曜源 - ibireme等。這里有一篇唐巧對(duì)他的專訪，還有他的 GitHub - Yaoyuan 和 博客，這里貼出來(lái)框架YYKit 框架。接下來(lái)幾篇我們就一起來(lái)看一下這個(gè)框架。感興趣的可以看上面寫的幾篇。
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分類之架構(gòu)分析和Font Traits（一）
10. YYKit源碼探究（十） —— UIFont分類之Create font（二）
11. YYKit源碼探究（十一） —— UIFont分類之Load and unload font（三）
12. YYKit源碼探究（十二） —— UIFont分類之Dump font data（四）
13. YYKit源碼探究（十三） —— UIImage分類之框架結(jié)構(gòu)和Create image部分（一）
14. YYKit源碼探究（十四） —— UIImage分類之Image Info（二）
15. YYKit源碼探究（十五） —— UIImage分類之Modify Image（三）
16. YYKit源碼探究（十六） —— UIImage分類之Image Effect（四）
17. YYKit源碼探究（十七） —— UIImageView分類之架構(gòu)和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（九）
71. YYKit源碼探究（七十一） —— NSMutableAttributedString分類之Set character attribute as property（十）
72. YYKit源碼探究（七十二） —— NSMutableAttributedString分類之Set paragraph attribute as property（十一）
73. YYKit源碼探究（七十三） —— NSMutableAttributedString分類之Set YYText attribute as property（十二）
74. YYKit源碼探究（七十四） —— NSMutableAttributedString分類之Set discontinuous attribute for range（十三）
75. YYKit源碼探究（七十五） —— NSMutableAttributedString分類之Convenience methods for text highlight（十四）

回顧

上一篇主要介紹了NSMutableAttributedString分類的Convenience methods for text highlight部分，這一篇主要看一下NSMutableAttributedString分類的Utilities部分。

API

下面我們看一下API

/**
 Inserts into the receiver the characters of a given string at a given location.
 The new string inherit the attributes of the first replaced character from location.
 
 @param string  The string to insert into the receiver, must not be nil.
 @param location The location at which string is inserted. The location must not 
    exceed the bounds of the receiver.
 @throw Raises an NSRangeException if the location out of bounds.
 */
- (void)insertString:(NSString *)string atIndex:(NSUInteger)location;

/**
 Adds to the end of the receiver the characters of a given string.
 The new string inherit the attributes of the receiver's tail.
 
 @param string  The string to append to the receiver, must not be nil.
 */
- (void)appendString:(NSString *)string;

/**
 Set foreground color with [UIColor clearColor] in joined-emoji range.
 Emoji drawing will not be affected by the foreground color.
 
 @discussion In iOS 8.3, Apple releases some new diversified emojis. 
 There's some single emoji which can be assembled to a new 'joined-emoji'.
 The joiner is unicode character 'ZERO WIDTH JOINER' (U+200D).
 For example: ???????? -> ???????????.
 
 When there are more than 5 'joined-emoji' in a same CTLine, CoreText may render some
 extra glyphs above the emoji. It's a bug in CoreText, try this method to avoid.
 This bug is fixed in iOS 9.
 */
- (void)setClearColorToJoinedEmoji;

/**
 Removes all discontinuous attributes in a specified range.
 See `allDiscontinuousAttributeKeys`.
 
 @param range A text range.
 */
- (void)removeDiscontinuousAttributesInRange:(NSRange)range;

/**
 Returns all discontinuous attribute keys, such as RunDelegate/Attachment/Ruby.
 
 @discussion These attributes can only set to a specified range of text, and
 should not extend to other range when editing text.
 */
+ (NSArray<NSString *> *)allDiscontinuousAttributeKeys;

下面我們就詳細(xì)的看一下這個(gè)API

1. - (void)insertString:(NSString *)string atIndex:(NSUInteger)location;

在給定位置插入給定字符串的字符。 新字符串繼承位置中第一個(gè)替換字符的屬性。

注意：當(dāng)location越界會(huì)引起NSRangeException異常。

方法實(shí)現(xiàn)

- (void)insertString:(NSString *)string atIndex:(NSUInteger)location {
    [self replaceCharactersInRange:NSMakeRange(location, 0) withString:string];
    [self removeDiscontinuousAttributesInRange:NSMakeRange(location, string.length)];
}

- (void)removeDiscontinuousAttributesInRange:(NSRange)range {
    NSArray *keys = [NSMutableAttributedString allDiscontinuousAttributeKeys];
    for (NSString *key in keys) {
        [self removeAttribute:key range:range];
    }
}

2. - (void)appendString:(NSString *)string;

在給定字符串末尾拼接字符串。

方法實(shí)現(xiàn)

- (void)appendString:(NSString *)string {
    NSUInteger length = self.length;
    [self replaceCharactersInRange:NSMakeRange(length, 0) withString:string];
    [self removeDiscontinuousAttributesInRange:NSMakeRange(length, string.length)];
}

3. - (void)setClearColorToJoinedEmoji;

在joined-emoji范圍內(nèi)使用[UIColor clearColor]設(shè)置foreground color。 Emoji繪制不會(huì)受到foreground color的影響。

在iOS 8.3中，Apple發(fā)布了一些新的多元化表情符號(hào)。 有一些單獨(dú)的表情符號(hào)可以組裝成新的joined-emoji。 joiner是unicode字符ZERO WIDTH JOINER'(U+200D)。 例如：???????? - >???????????。

當(dāng)同一個(gè)CTLine中有超過(guò)5個(gè)joined-emoji時(shí)，CoreText可能會(huì)在emoji之上渲染一些額外的字形。 這是CoreText中的一個(gè)bug，請(qǐng)嘗試使用此方法來(lái)避免。 這個(gè)bug在iOS 9中修復(fù)。

方法實(shí)現(xiàn)

- (void)setClearColorToJoinedEmoji {
    NSString *str = self.string;
    if (str.length < 8) return;
    
    // Most string do not contains the joined-emoji, test the joiner first.
    BOOL containsJoiner = NO;
    {
        CFStringRef cfStr = (__bridge CFStringRef)str;
        BOOL needFree = NO;
        UniChar *chars = NULL;
        chars = (void *)CFStringGetCharactersPtr(cfStr);
        if (!chars) {
            chars = malloc(str.length * sizeof(UniChar));
            if (chars) {
                needFree = YES;
                CFStringGetCharacters(cfStr, CFRangeMake(0, str.length), chars);
            }
        }
        if (!chars) { // fail to get unichar..
            containsJoiner = YES;
        } else {
            for (int i = 0, max = (int)str.length; i < max; i++) {
                if (chars[i] == 0x200D) { // 'ZERO WIDTH JOINER' (U+200D)
                    containsJoiner = YES;
                    break;
                }
            }
            if (needFree) free(chars);
        }
    }
    if (!containsJoiner) return;
    
    // NSRegularExpression is designed to be immutable and thread safe.
    static NSRegularExpression *regex;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        regex = [NSRegularExpression regularExpressionWithPattern:@"((???????????|???????????|???????????|???????????|???????????|???????????|???????????|???????????|???????????)+|(????????|????????|????????|????????|????????))" options:kNilOptions error:nil];
    });
    
    UIColor *clear = [UIColor clearColor];
    [regex enumerateMatchesInString:str options:kNilOptions range:NSMakeRange(0, str.length) usingBlock:^(NSTextCheckingResult *result, NSMatchingFlags flags, BOOL *stop) {
        [self setColor:clear range:result.range];
    }];
}

4. - (void)removeDiscontinuousAttributesInRange:(NSRange)range;

在指定的范圍內(nèi)，移除所有的discontinuous屬性，參考allDiscontinuousAttributeKeys。

方法實(shí)現(xiàn)

- (void)removeDiscontinuousAttributesInRange:(NSRange)range {
    NSArray *keys = [NSMutableAttributedString allDiscontinuousAttributeKeys];
    for (NSString *key in keys) {
        [self removeAttribute:key range:range];
    }
}

5. + (NSArray<NSString *> *)allDiscontinuousAttributeKeys;

返回所有的discontinuous attribute keys，例如RunDelegate/Attachment/Ruby，在編輯文本時(shí)，這些屬性可以設(shè)置指定區(qū)間內(nèi)的文本，不應(yīng)該擴(kuò)展到其他區(qū)間。

方法實(shí)現(xiàn)

+ (NSArray *)allDiscontinuousAttributeKeys {
    static NSMutableArray *keys;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        keys = @[(id)kCTSuperscriptAttributeName,
                 (id)kCTRunDelegateAttributeName,
                 YYTextBackedStringAttributeName,
                 YYTextBindingAttributeName,
                 YYTextAttachmentAttributeName].mutableCopy;
        if (kiOS8Later) {
            [keys addObject:(id)kCTRubyAnnotationAttributeName];
        }
        if (kiOS7Later) {
            [keys addObject:NSAttachmentAttributeName];
        }
    });
    return keys;
}

后記

本文主要介紹了NSMutableAttributedString分類之Utilities，感興趣的給個(gè)贊或者關(guān)注~~~~