DTCoreText框架开发指南：从基础使用到高级技巧-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00920/article/details/148467765

DTCoreText框架开发指南：从基础使用到高级技巧

DTCoreText Methods to allow using HTML code with CoreText 项目地址: https://gitcode.com/gh_mirrors/dt/DTCoreText

框架概述

DTCoreText是一个强大的iOS富文本处理框架，它能够将HTML内容转换为NSAttributedString并进行高效渲染。本指南将全面介绍该框架的核心功能和使用技巧，帮助开发者快速掌握这一工具。

环境配置与基础测试

在项目中成功集成DTCoreText后，建议首先进行简单的功能测试。以下代码片段可作为"冒烟测试"验证基本功能是否正常：

#import "DTCoreText.h"

NSString *html = @"<p>测试文本</p>";
NSData *data = [html dataUsingEncoding:NSUTF8StringEncoding];

NSAttributedString *attrString = [[NSAttributedString alloc] initWithHTMLData:data documentAttributes:NULL];
NSLog(@"%@", attrString);

执行后控制台应输出生成的属性字符串描述，这表示框架已正确集成。

字体处理技巧

指定特定字体

DTCoreText提供两种方式指定特定字体：

直接在HTML中使用font标签：

<p><font face="HelveticaNeue-Light">特殊字体文本</font></p>

通过代码全局设置：

[DTCoreTextFontDescriptor setOverrideFontName:@"HelveticaNeue-Light" 
                                forFontFamily:@"Helvetica Neue" 
                                        bold:NO 
                                      italic:NO];

第二种方式会影响所有使用该字体系列且非粗体/斜体的文本。

字体匹配优化

为提高性能，框架内部维护了字体查找表。开发者可以通过以下方式优化：

创建DTCoreTextFontOverrides.plist文件预定义常用字体组合
异步预加载字体查找表：

[DTCoreTextFontDescriptor asyncPreloadFontLookupTable];

设置备用字体

当HTML中指定的字体不可用时，框架会使用备用字体：

[DTCoreTextFontDescriptor setFallbackFontFamily:@"Helvetica Neue"];

注意：备用字体必须是系统已安装的有效字体。

交互功能实现

获取点击单词

实现文本点击识别并获取点击单词的完整示例：

- (void)handleTap:(UITapGestureRecognizer *)gesture {
    if (gesture.state == UIGestureRecognizerStateRecognized) {
        CGPoint location = [gesture locationInView:_textView];
        NSUInteger tappedIndex = [_textView closestCursorIndexToPoint:location];
    
        __block NSRange wordRange = NSMakeRange(0, 0);
    
        [plainText enumerateSubstringsInRange:NSMakeRange(0, [plainText length]) 
                                   options:NSStringEnumerationByWords 
                                usingBlock:^(NSString *substring, NSRange substringRange, NSRange enclosingRange, BOOL *stop) {
            if (NSLocationInRange(tappedIndex, enclosingRange)) {
                *stop = YES;
                wordRange = substringRange;
            }
        }];
    
        NSString *word = [plainText substringWithRange:wordRange];
        NSLog(@"点击位置: %d, 单词: '%@'", tappedIndex, word);
    }
}

获取可见文本范围

计算当前可见文本范围的实现方法：

CGRect visibleRect = _textView.bounds;
NSArray *visibleLines = [_textView.attributedTextContentView.layoutFrame linesVisibleInRect:visibleRect];

NSRange stringRange = [visibleLines[0] stringRange];
stringRange = NSUnionRange([[visibleLines lastObject] stringRange], stringRange);

布局与尺寸计算

计算富文本所需尺寸

精确计算属性字符串渲染所需空间的方法：

NSAttributedString *attributedString = ...;
DTCoreTextLayouter *layouter = [[DTCoreTextLayouter alloc] initWithAttributedString:attributedString];

CGRect maxRect = CGRectMake(10, 20, CGFLOAT_WIDTH_UNKNOWN, CGFLOAT_HEIGHT_UNKNOWN);
DTCoreTextLayoutFrame *layoutFrame = [layouter layoutFrameWithRect:maxRect range:NSMakeRange(0, [attributedString length])];

CGSize sizeNeeded = [layoutFrame frame].size;

高级功能实现

远程图片加载

使用DTLazyImageView实现远程图片的延迟加载：

为图片附件创建视图：

- (UIView *)attributedTextContentView:(DTAttributedTextContentView *)attributedTextContentView 
                  viewForAttachment:(DTTextAttachment *)attachment 
                              frame:(CGRect)frame {
    if([attachment isKindOfClass:[DTImageTextAttachment class]]) {
        DTLazyImageView *imageView = [[DTLazyImageView alloc] initWithFrame:frame];
        imageView.delegate = self;
        imageView.url = attachment.contentURL;
        return imageView;
    }
    return nil;
}

图片加载完成后更新布局：

- (void)lazyImageView:(DTLazyImageView *)lazyImageView didChangeImageSize:(CGSize)size {
    NSURL *url = lazyImageView.url;
    NSPredicate *pred = [NSPredicate predicateWithFormat:@"contentURL == %@", url];

    for (DTTextAttachment *oneAttachment in [self.attributedTextContentView.layoutFrame textAttachmentsWithPredicate:pred]) {
        oneAttachment.originalSize = size;
    }

    self.attributedTextContentView.layouter = nil;
    [self.attributedTextContentView relayoutText];
}

自定义默认字体

修改HTML渲染的默认字体和大小：

NSDictionary* options = @{
    NSTextSizeMultiplierDocumentOption: @1.0,
    DTDefaultFontFamily: @"Helvetica Neue",
};

NSAttributedString* attributedDescription = [[NSAttributedString alloc] initWithHTMLData:htmlData 
                                                                              options:options 
                                                                   documentAttributes:NULL];

添加自定义字体

通过CSS样式表添加自定义字体：

let customStyleSheet = DTCSSStylesheet(styleBlock: "body { -coretext-fontname: SourceSansPro-Light; }")
DTCSSStylesheet.defaultStyleSheet().mergeStylesheet(customStyleSheet)