本人录制技术视频地址:https://edu.csdn.net/lecturer/1899 欢迎观看。
前几节中,我转载他人的博客,详细的描述了Core Text的基本概念及使用,但看上去他所提供的demo是面向过程的,代码不容易管理及维护。接下来几节,我将逐步封装Core Text代码,让其看起来不那么凌乱(因为Core Text是纯C的语法)。下面,我们先看一张 “iOS Text Design and Rendering Architecture” 架构图。
上图中,最底层的Core Graphics是核心绘画,我在Quartz 2D章节已经进行了详细的说明,然后上面一层的就是Core Text。 先看看我实现的一个Core Text的demo效果图。
1. 我们先看看原始的代码实现过程,可以看出,代码中,将坐标系的变换,路径的初始化,字符串的处理,frame的创建及最终的绘制 全部放在一起处理了,当遇到复杂的业务需求的话,代码显的臃肿和不利于维护。
CGContextRef context = UIGraphicsGetCurrentContext();
CGContextSetTextMatrix(context, CGAffineTransformIdentity);
CGContextTranslateCTM(context, 0, self.bounds.size.height);
CGContextScaleCTM(context, 1.0, -1.0);
CGMutablePathRef path = CGPathCreateMutable();
CGPathAddRect(path, NULL, self.bounds);
NSAttributedString *attrString = [[NSAttributedString alloc] initWithString:@"大话西游台词..."];
// 这里截断字符串,然后对每段进行文字及颜色的设置
CTFramesetterRef framesetter = CTFramesetterCreateWithAttributedString((CFAttributedStringRef)attrString);
CTFrameRef frame = CTFramesetterCreateFrame(framesetter, CFRangeMake(0, attrString.length), path, NULL);
CTFrameDraw(frame, context);
CFRelease(frame);
CFRelease(path);
CFRelease(framesetter);
对于一个复杂的排版引擎来说,可以将其功能拆分成以下几个类来完成。
1)一个显示用的类,仅负责显示内容,不负责排版。
2)一个模型类,用于承载显示所需要的所有数据。
3)一个排版类,用于实现文字内容的排版。
4)一个配置类,用于实现一些排版时的可配置项。
按照以上的描述,我们可以将上面的代码内容拆分,分成4个类:
1)CTFrameParserConfig类,用于配置绘制的参数,例如文字颜色、大小、行间距等。
2)CTFrameParser类,用于生成最后绘制界面需要的CTFrameRef实例。
3)CoreTextData类,用于保存由CTFrameParser类生成的CTFrameRef实例以及CTFrameRef实际绘制需要的高度。
4)CTDisplayView类,持有CoreTextData类的实例,负责将CTFrameRef绘制到界面上。
下面我就一一介绍上面说描述的类:
1)CTFrameParserConfig类,主要是初始化了文字宽度、大小、行间距、颜色信息。 代码如下:
@interface CTFrameParserConfig : NSObject
@property (nonatomic,assign) CGFloat width;
@property (nonatomic,assign) CGFloat fontSize;
@property (nonatomic,assign) CGFloat lineSpace;
@property (nonatomic,strong) UIColor *textColor;
@end
#define RGB(A,B,C) [UIColor colorWithRed:(A/255.0) green:(B/255.0) blue:(C/255.0) alpha:1.0]
#import "CTFrameParserConfig.h"
@implementation CTFrameParserConfig
- (instancetype)init {
if (self = [super init]) {
self.width = 300.0f;
self.fontSize = 16.0f;
self.lineSpace = 8.0f;
self.textColor = RGB(108, 108, 108);
}
return self;
}
@end
@interface CoreTextData : NSObject
@property (nonatomic,assign) CTFrameRef ctFrame;
@property (nonatomic,assign) CGFloat height;
@end
@implementation CoreTextData
- (void)setCtFrame:(CTFrameRef)ctFrame {
if (_ctFrame != ctFrame) {
if(_ctFrame != nil) {
CFRelease(_ctFrame);
}
CFRetain(ctFrame);
_ctFrame = ctFrame;
}
}
- (void)dealloc {
if (_ctFrame != nil) {
CFRelease(_ctFrame);
_ctFrame = nil;
}
}
@end
I. 在绘制之前先进行坐标系翻转,因为Core Text的默认坐标系原点在左下角。
II.直接调用CTFrameDraw方法,完成绘制工作。
@interface CTDisplayView : UIView
@property (nonatomic,strong) CoreTextData *data;
@end
- (void)drawRect:(CGRect)rect {
[super drawRect:rect];
CGContextRef context = UIGraphicsGetCurrentContext();
CGContextSetTextMatrix(context, CGAffineTransformIdentity);
CGContextTranslateCTM(context, 0, self.bounds.size.height);
CGContextScaleCTM(context, 1.0, -1.0);
if (self.data) {
CTFrameDraw(self.data.ctFrame, context);
}
}
@interface CTFrameParser : NSObject
/* 对整段文字进行排版 */
+ (CoreTextData *)parseContent:(NSString *)content config:(CTFrameParserConfig *)config;
/* 自定义自己的排版 */
+ (CoreTextData *)parseTemplateFile:(NSString *)path config:(CTFrameParserConfig *)config;
@end
先来看看parseContent方法:
+ (CoreTextData *)parseContent:(NSString *)content config:(CTFrameParserConfig *)config {
NSDictionary *attributes = [self attributesWithConfig:config];
NSAttributedString *contentString = [[NSAttributedString alloc] initWithString:content attributes:attributes];
return [self parseAttributedContent:contentString config:config];
}
+ (NSDictionary *)attributesWithConfig:(CTFrameParserConfig *)config {
CGFloat fontSize = config.fontSize;
CTFontRef fontRef = CTFontCreateWithName((CFStringRef)@"ArialMT", fontSize, NULL);
CGFloat lineSpacing = config.lineSpace;
const CFIndex kNumberOfSettings = 3;
CTParagraphStyleSetting theSettings[kNumberOfSettings] = {
{kCTParagraphStyleSpecifierLineSpacingAdjustment,sizeof(CGFloat),&lineSpacing},
{kCTParagraphStyleSpecifierMaximumLineSpacing,sizeof(CGFloat),&lineSpacing},
{kCTParagraphStyleSpecifierMinimumLineSpacing,sizeof(CGFloat),&lineSpacing}
};
CTParagraphStyleRef theParagraphRef = CTParagraphStyleCreate(theSettings, kNumberOfSettings);
UIColor *textColor = config.textColor;
NSMutableDictionary *dict = [NSMutableDictionary dictionary];
dict[(id)kCTForegroundColorAttributeName] = (id)textColor.CGColor;
dict[(id)kCTFontAttributeName] = (__bridge id)fontRef;
dict[(id)kCTParagraphStyleAttributeName] = (__bridge id)theParagraphRef;
CFRelease(theParagraphRef);
CFRelease(fontRef);
return dict;
}
+ (CoreTextData *)parseAttributedContent:(NSAttributedString *)content config:(CTFrameParserConfig *)config {
// 创建CTFramesetterRef实例
CTFramesetterRef framesetter = CTFramesetterCreateWithAttributedString((CFAttributedStringRef)content);
// 获得要绘制区域的高度
CGSize restrictSize = CGSizeMake(config.width, CGFLOAT_MAX);
CGSize coreTextSize = CTFramesetterSuggestFrameSizeWithConstraints(framesetter, CFRangeMake(0, 0), nil, restrictSize, nil);
CGFloat textHeight = coreTextSize.height;
// 生成CTFrameRef实例
CTFrameRef frame = [self createFrameWithFramesetter:framesetter config:config height:textHeight];
// 将生成好的CTFrameRef实例和计算好的绘制高度保存到CoreTextData实例中,并返回
CoreTextData *data = [[CoreTextData alloc] init];
data.ctFrame = frame;
data.height = textHeight;
// 内存释放
CFRelease(frame);
CFRelease(framesetter);
return data;
}
+ (CTFrameRef)createFrameWithFramesetter:(CTFramesetterRef)framesetter config:(CTFrameParserConfig *)config height:(CGFloat)height {
CGMutablePathRef path = CGPathCreateMutable();
CGPathAddRect(path, NULL, CGRectMake(0, 0, config.width, height));
CTFrameRef frame = CTFramesetterCreateFrame(framesetter, CFRangeMake(0, 0), path, NULL);
CFRelease(path);
return frame;
}
/* 自定义自己的排版 */
+ (CoreTextData *)parseTemplateFile:(NSString *)path config:(CTFrameParserConfig *)config {
NSAttributedString *content = [self loadTemplateFile:path config:config];
return [self parseAttributedContent:content config:config];
}
loadTemplateFile方法具体实现如下:
+ (NSAttributedString *)loadTemplateFile:(NSString *)path config:(CTFrameParserConfig *)config {
NSMutableAttributedString *result = [[NSMutableAttributedString alloc] init];
// JSON方式获取数据
// NSArray *array = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingAllowFragments error:nil];
NSArray *array = [NSArray arrayWithContentsOfFile:path];
if (array) {
if ([array isKindOfClass:[NSArray class]]) {
for (NSDictionary *dict in array) {
NSAttributedString *as = [self parseAttributedContentFromNSDictionary:dict config:config];
[result appendAttributedString:as];
}
}
}
return result;
}
+ (NSAttributedString *)parseAttributedContentFromNSDictionary:(NSDictionary *)dict config:(CTFrameParserConfig *)config {
NSMutableDictionary *attributes = (NSMutableDictionary *)[self attributesWithConfig:config];
UIColor *color = [self colorFromTemplate:dict[@"color"]];
if (color) {
attributes[(id)kCTForegroundColorAttributeName] = (id)color.CGColor;
}
CGFloat fontSize = [dict[@"size"] floatValue];
if (fontSize > 0) {
CTFontRef fontRef = CTFontCreateWithName((CFStringRef)@"ArialMT", fontSize, NULL);
attributes[(id)kCTFontAttributeName] = (__bridge id)(fontRef);
CFRelease(fontRef);
}
NSString *content = dict[@"content"];
return [[NSAttributedString alloc] initWithString:content attributes:attributes];
}
+ (UIColor *)colorFromTemplate:(NSString *)name {
if ([name isEqualToString:@"blue"]) {
return [UIColor blueColor];
} else if ([name isEqualToString:@"green"]) {
return [UIColor greenColor];
} else if ([name isEqualToString:@"red"]) {
return [UIColor redColor];
} else if ([name isEqualToString:@"purple"]) {
return [UIColor purpleColor];
} else {
return nil;
}
}
CTFrameParserConfig *config = [[CTFrameParserConfig alloc] init];
config.width = self.ctView.width;
NSString *path = [[NSBundle mainBundle] pathForResource:@"TempData.plist" ofType:nil];
CoreTextData *data = [CTFrameParser parseTemplateFile:path config:config];
// 传递数据给CTDisplayView,然后绘制内容
self.ctView.data = data;
// 设置CTDisplayView的高度
self.ctView.height = data.height;
下图是框架的UML示意图:
1. CTFrameParser通过CTFrameParserConfig实例来生成CoreTextData实例。
2. CTDisplayView通过持有CoreTextData实例来获得绘制所需要的所有信息。
3. ViewController类通过配置CTFrameParserConfig实例,进而获得生成的CoreTextData实例,最后将其赋值给它的CTDisplayView成员,达到将指定内容显示在界面上得效果。