版本記錄

前言

iOS圈內(nèi)有幾個(gè)人大家基本都知道，比如說王巍、唐巧，還有YYKit框架的作者現(xiàn)任職于滴滴的郭曜源 - ibireme等。這里有一篇唐巧對(duì)他的專訪，還有他的 GitHub - Yaoyuan 和 博客，這里貼出來框架YYKit 框架。接下來幾篇我們就一起來看一下這個(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（六）

回顧

上一篇主要介紹了NSAttributedString分類的Query for YYText部分，這一篇主要看一下NSAttributedString分類的Create attachment string for YYText部分。

API

下面我們看一下API

/**
 Creates and returns an attachment.
 
 @param content      The attachment (UIImage/UIView/CALayer).
 @param contentMode  The attachment's content mode.
 @param width        The attachment's container width in layout.
 @param ascent       The attachment's container ascent in layout.
 @param descent      The attachment's container descent in layout.
 
 @return An attributed string, or nil if an error occurs.
 @since YYKit:6.0
 */
+ (NSMutableAttributedString *)attachmentStringWithContent:(nullable id)content
                                               contentMode:(UIViewContentMode)contentMode
                                                     width:(CGFloat)width
                                                    ascent:(CGFloat)ascent
                                                   descent:(CGFloat)descent;

/**
 Creates and returns an attachment.
 
 
 Example: ContentMode:bottom Alignment:Top.
 
      The text      The attachment holder
         ↓                ↓
     ─────────┌──────────────────────┐───────
        / \   │                      │ / ___|
       / _ \  │                      │| |
      / ___ \ │                      │| |___     ←── The text line
     /_/   \_\│    ██████████████    │ \____|
     ─────────│    ██████████████    │───────
              │    ██████████████    │
              │    ██████████████ ←───────────────── The attachment content
              │    ██████████████    │
              └──────────────────────┘

 @param content        The attachment (UIImage/UIView/CALayer).
 @param contentMode    The attachment's content mode in attachment holder
 @param attachmentSize The attachment holder's size in text layout.
 @param fontSize       The attachment will align to this font.
 @param alignment      The attachment holder's alignment to text line.
 
 @return An attributed string, or nil if an error occurs.
 @since YYKit:6.0
 */
+ (NSMutableAttributedString *)attachmentStringWithContent:(nullable id)content
                                               contentMode:(UIViewContentMode)contentMode
                                            attachmentSize:(CGSize)attachmentSize
                                               alignToFont:(UIFont *)font
                                                 alignment:(YYTextVerticalAlignment)alignment;

/**
 Creates and returns an attahment from a fourquare image as if it was an emoji.
 
 @param image     A fourquare image.
 @param fontSize  The font size.
 
 @return An attributed string, or nil if an error occurs.
 @since YYKit:6.0
 */
+ (nullable NSMutableAttributedString *)attachmentStringWithEmojiImage:(UIImage *)image
                                                              fontSize:(CGFloat)fontSize;

下面我們一起詳細(xì)的看一下。

1. + (NSMutableAttributedString *)attachmentStringWithContent:(nullable id)content contentMode:(UIViewContentMode)contentMode width:(CGFloat)width ascent:(CGFloat)ascent descent:(CGFloat)descent;

創(chuàng)建并返回一個(gè)附件。

• content：附件(UIImage/UIView/CALayer)
• contentMode：附件的內(nèi)容模式
• width：布局中附件容器的寬
• ascent：布局中附件容器的ascent
• descent：布局中附件容器的descent

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

下面我們就看一下方法實(shí)現(xiàn)。

+ (NSMutableAttributedString *)attachmentStringWithContent:(id)content
                                               contentMode:(UIViewContentMode)contentMode
                                                     width:(CGFloat)width
                                                    ascent:(CGFloat)ascent
                                                   descent:(CGFloat)descent {
    NSMutableAttributedString *atr = [[NSMutableAttributedString alloc] initWithString:YYTextAttachmentToken];
    
    YYTextAttachment *attach = [YYTextAttachment new];
    attach.content = content;
    attach.contentMode = contentMode;
    [atr setTextAttachment:attach range:NSMakeRange(0, atr.length)];
    
    YYTextRunDelegate *delegate = [YYTextRunDelegate new];
    delegate.width = width;
    delegate.ascent = ascent;
    delegate.descent = descent;
    CTRunDelegateRef delegateRef = delegate.CTRunDelegate;
    [atr setRunDelegate:delegateRef range:NSMakeRange(0, atr.length)];
    if (delegate) CFRelease(delegateRef);
    
    return atr;
}

2. + (NSMutableAttributedString *)attachmentStringWithContent:(nullable id)content contentMode:(UIViewContentMode)contentMode attachmentSize:(CGSize)attachmentSize alignToFont:(UIFont *)font alignment:(YYTextVerticalAlignment)alignment;

創(chuàng)建并返回附件。

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

下面我們就看一下方法實(shí)現(xiàn)。

+ (NSMutableAttributedString *)attachmentStringWithContent:(id)content
                                               contentMode:(UIViewContentMode)contentMode
                                            attachmentSize:(CGSize)attachmentSize
                                               alignToFont:(UIFont *)font
                                                 alignment:(YYTextVerticalAlignment)alignment {
    NSMutableAttributedString *atr = [[NSMutableAttributedString alloc] initWithString:YYTextAttachmentToken];
    
    YYTextAttachment *attach = [YYTextAttachment new];
    attach.content = content;
    attach.contentMode = contentMode;
    [atr setTextAttachment:attach range:NSMakeRange(0, atr.length)];
    
    YYTextRunDelegate *delegate = [YYTextRunDelegate new];
    delegate.width = attachmentSize.width;
    switch (alignment) {
        case YYTextVerticalAlignmentTop: {
            delegate.ascent = font.ascender;
            delegate.descent = attachmentSize.height - font.ascender;
            if (delegate.descent < 0) {
                delegate.descent = 0;
                delegate.ascent = attachmentSize.height;
            }
        } break;
        case YYTextVerticalAlignmentCenter: {
            CGFloat fontHeight = font.ascender - font.descender;
            CGFloat yOffset = font.ascender - fontHeight * 0.5;
            delegate.ascent = attachmentSize.height * 0.5 + yOffset;
            delegate.descent = attachmentSize.height - delegate.ascent;
            if (delegate.descent < 0) {
                delegate.descent = 0;
                delegate.ascent = attachmentSize.height;
            }
        } break;
        case YYTextVerticalAlignmentBottom: {
            delegate.ascent = attachmentSize.height + font.descender;
            delegate.descent = -font.descender;
            if (delegate.ascent < 0) {
                delegate.ascent = 0;
                delegate.descent = attachmentSize.height;
            }
        } break;
        default: {
            delegate.ascent = attachmentSize.height;
            delegate.descent = 0;
        } break;
    }
    
    CTRunDelegateRef delegateRef = delegate.CTRunDelegate;
    [atr setRunDelegate:delegateRef range:NSMakeRange(0, atr.length)];
    if (delegate) CFRelease(delegateRef);
    
    return atr;
}

3. + (nullable NSMutableAttributedString *)attachmentStringWithEmojiImage:(UIImage *)image fontSize:(CGFloat)fontSize;

從foursquare圖像創(chuàng)建并返回附件，就好像它是表情符號(hào)emoji一樣

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

+ (NSMutableAttributedString *)attachmentStringWithEmojiImage:(UIImage *)image
                                                     fontSize:(CGFloat)fontSize {
    if (!image || fontSize <= 0) return nil;
    
    BOOL hasAnim = NO;
    if (image.images.count > 1) {
        hasAnim = YES;
    } else if ([image conformsToProtocol:@protocol(YYAnimatedImage)]) {
        id <YYAnimatedImage> ani = (id)image;
        if (ani.animatedImageFrameCount > 1) hasAnim = YES;
    }
    
    CGFloat ascent = YYEmojiGetAscentWithFontSize(fontSize);
    CGFloat descent = YYEmojiGetDescentWithFontSize(fontSize);
    CGRect bounding = YYEmojiGetGlyphBoundingRectWithFontSize(fontSize);
    
    YYTextRunDelegate *delegate = [YYTextRunDelegate new];
    delegate.ascent = ascent;
    delegate.descent = descent;
    delegate.width = bounding.size.width + 2 * bounding.origin.x;
    
    YYTextAttachment *attachment = [YYTextAttachment new];
    attachment.contentMode = UIViewContentModeScaleAspectFit;
    attachment.contentInsets = UIEdgeInsetsMake(ascent - (bounding.size.height + bounding.origin.y), bounding.origin.x, descent + bounding.origin.y, bounding.origin.x);
    if (hasAnim) {
        YYAnimatedImageView *view = [YYAnimatedImageView new];
        view.frame = bounding;
        view.image = image;
        view.contentMode = UIViewContentModeScaleAspectFit;
        attachment.content = view;
    } else {
        attachment.content = image;
    }
    
    NSMutableAttributedString *atr = [[NSMutableAttributedString alloc] initWithString:YYTextAttachmentToken];
    [atr setTextAttachment:attachment range:NSMakeRange(0, atr.length)];
    CTRunDelegateRef ctDelegate = delegate.CTRunDelegate;
    [atr setRunDelegate:ctDelegate range:NSMakeRange(0, atr.length)];
    if (ctDelegate) CFRelease(ctDelegate);
    
    return atr;
}

后記

本篇主要介紹了NSAttributedString分類之Create attachment string for YYText，感興趣的給個(gè)贊或者關(guān)注~~~