Text Kit进阶

时间  2019-11-08
标签 text kit 进阶 栏目 HTML 繁體版
原文   原文链接

Text Rendering Architecture

在上一篇文章Text Kit入门中咱们主要了解了什么是Text Kit及它的一些架构和基本特性，这篇文章中会涉及关于Text Kit的更多具体应用。html

Text Kit是创建在Core Text框架上的，咱们知道CoreText.framework是一个庞大而复杂的框架，而Text Kit在继承了Core Text强大功能的同时给开发者提供了比较友好的面向对象的API。ios

本文主要介绍Text Kit下面四个特性：git

  • 动态字体（Dynamic type）
  • 凸版印刷体效果（Letterpress effects）
  • 路径排除（Exclusion paths）
  • 动态文本格式化和存储（Dynamic text formatting and storage）

Dynamic type

动态字体是iOS7中新增长的比较重要的特性之一，程序应该按照用户设定的字体大小和粗细来显示文本内容。github

分别在设置\通用\辅助功能和设置\通用\文字大小中能够设置文本在应用程序中显示的粗细和大小。正则表达式

Font Weight Font Size

iOS7对系统字体在显示上作了一些优化，让不一样大小的字体在屏幕上都能清晰的显示。一般用户设置了本身偏好的字体，他们但愿在全部程序中都看到文本显示是根据他们的设定进行调整。为了实现这个，开发者须要在本身的应用中给文本控件设置当前用户设置字体，而不是指定死字体及大小。能够经过UIFont中新增的preferredFontForTextStyle:方法来获取用户偏好的字体。设计模式

iOS7中给出了6中字体样式供选择：架构

  • UIFontTextStyleHeadline
  • UIFontTextStyleBody
  • UIFontTextStyleSubheadline
  • UIFontTextStyleFootnote
  • UIFontTextStyleCaption1
  • UIFontTextStyleCaption2

Text Style

为了让咱们的程序支持动态字体，须要按一下方式给文本控件（一般是指UILabel，UITextField，UITextView）设定字体：app

self.textView.font = [UIFont preferredFontForTextStyle:UIFontTextStyleBody];

这样设置以后，文本控件就会以用户设定的字体大小及粗细显示，可是若是程序在运行时，用户切换到设置里修改了字体，这是在切回程序，字体并不会自动跟着变。这时就须要咱们本身来更新一下控件的字体了。框架

在系统字体修改时，系统会给运行中的程序发送UIContentSizeCategoryDidChangeNotification通知，咱们只须要监听这个通知，并从新设置一下字体便可。字体

[[NSNotificationCenter defaultCenter] addObserver:self
    selector:@selector(preferredContentSizeChanged:)
    name:UIContentSizeCategoryDidChangeNotification
    object:nil];

- (void)preferredContentSizeChanged:(NSNotification *)notification{
    self.textView.font = [UIFont preferredFontForTextStyle:UIFontTextStyleBody];
}

固然，有的时候要适应动态修改的字体并非这么设置一下就完事了，控件的大小可能也须要进行相应的调整，这时咱们程序中的控件大小也不该该写死，而是须要根据字体大小来计算.

Letterpress effects

凸版印刷替效果是给文字加上奇妙阴影和高光，让文字看起有凹凸感，像是被压在屏幕上。固然这种看起来很高端大气上档次的效果实现起来确实至关的简单，只须要给AttributedString加一个NSTextEffectAttributeName属性，并指定该属性值为NSTextEffectLetterpressStyle就能够了。

NSDictionary *attributes = @{ 
    NSForegroundColorAttributeName: [UIColor redColor],
    NSFontAttributeName: [UIFont preferredFontForTextStyle:UIFontTextStyleHeadline],
    NSTextEffectAttributeName: NSTextEffectLetterpressStyle
};
self.titleLabel.attributedText = [[NSAttributedString alloc] initWithString:@"Title" attributes:attributes];

Letterpress

在iOS7系统自带的备忘录应用中，苹果就使用了这种凸版印刷体效果。

Exclusion paths

在排版中，图文混排是很是常见的需求，但有时候咱们的图片并必定都是正常的矩形，这个时候咱们若是须要将文本环绕在图片周围，就能够用路径排除（exclusion paths）了。

Explosion pats基本原理是将须要被文本留出来的形状的路径告诉文本控件的NSTextContainer对象，NSTextContainer在文字排版时就会避开该路径。

UIBezierPath *floatingPath = [self pathOfImage];
self.textView.textContainer.exclusionPaths = @[floatingPath];

Exclusion paths

因此实现Exclusion paths的主要工做就是获取这个path。

Dynamic text formatting and storage

好了，到如今咱们知道了Text Kit能够动态的根据用户设置的字体大小进行调整，可是若是具体某个文本显示控件中的文本样式可以动态调整是否是会更酷一些呢？

例如，你但愿让你的textView中的文本自动支持下面功能：

  • 让**字符之间的文本加粗显示
  • 让_字符之间的文本以斜体字显示
  • 让~~字符之间的文本以被横线穿透样式显示
  • 让全大写的文本以红色字体显示

Text Formatting Demo

实现这些才是真正体现Text Kit强大之处的时候，在此以前你须要理解Text Kit中的文本存储系统是怎么工做的，下图显示了Text Kit中文本的保存、渲染和现实之间的关系。

Text Kit

当你使用UITextView、UILabel、UITextField控件的时候，系统会自动建立上面这些类，你能够选择直接使用这么默认的实现或者为你的控件自定义这几个中的任何一个。

  • NSTextStorage自己继承与NSMutableAttributedString，它是以attributed string的形式保存须要渲染的文本，并在文本内容改变的时候通知到对应的layout manager对象。一般你须要建立NSTextStorage的子类来在文本改变时进行文本显示样式的更新。
  • NSLayoutManager做为文本控件中的排版引擎接收保存的文本并在屏幕上渲染出来。
  • NSTextContainer描述了文本在屏幕上显示时的几何区域，每一个text container与一个具体的UITextView相关联。若是你须要定义一个很复杂形状的区域来显示文本，你可能须要建立NSTextContainer子类。

要实现咱们上面描述的动态文本格式化功能，咱们须要建立NSTextStorage子类以便在用户输入文本的时候动态的增长文本属性。自定义了text storage后，咱们须要替换调UITextView默认的text storage。

建立NSTextStorage的子类

咱们建立NSTextStorage子类，命名为MarkupTextStorage，在实现文件中添加一个成员变量：

#import "MarkupTextStorage.h"

@implementation MarkupTextStorage
{
    NSMutableAttributedString *_backingStore;
}

- (id)init
{
    self = [super init];
    if (self) {
        _backingStore = [[NSMutableAttributedString alloc] init];
    }
    return self;
}

@end

NSTextStorage的子类须要重载一些方法提供NSMutableAttributedString类型的backing store信息，因此咱们继续添加下面代码：

- (NSString *)string
{
    return [_backingStore string];
}

- (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range
{
    return [_backingStore attributesAtIndex:location effectiveRange:range];
}

- (void)replaceCharactersInRange:(NSRange)range withString:(NSString *)str
{
    [self beginEditing];
    [_backingStore replaceCharactersInRange:range withString:str];
    [self edited:NSTextStorageEditedCharacters | NSTextStorageEditedAttributes
           range:range changeInLength:str.length - range.length];
    [self endEditing];
}

- (void)setAttributes:(NSDictionary *)attrs range:(NSRange)range
{
    [self beginEditing];
    [_backingStore setAttributes:attrs range:range];
    [self edited:NSTextStorageEditedAttributes
           range:range changeInLength:0];
    [self endEditing];
}

后面两个方法都是代理到backing store，而后须要被beginEditing edited endEditing包围，并且必须在文本编辑时按顺序调用来通知text storage对应的layout manager。

你可能发现子类化NSTextStorage须要写很多的代码，由于NSTextStorage是一个类集群中的一个开发接口，不能只是继承它而后重载不多的方法来拓展它的功能，而是须要本身实现不少细节。

类集群(Class cluster)是苹果Cocoa(Touch)框架中经常使用的设计模式之一。

类集群是Objective-C中对抽象工厂模式的简单实现，为建立一些列相关或独立对象提供了统一的接口而不用指定具体的类。经常使用的像NSArray和NSNumber事实上也是一系列类集群的开放接口。

苹果使用类集群是为了将一些类具体类隐藏在开放的抽象父类之下，外面经过抽象父类的方法来建立私有子类的实例，而且外界也彻底不知道工厂分配到了哪一个私有类，由于它们始终只和开放接口交互。

使用类集群确实简化了接口，让类更容易被使用，可是要知道鱼和熊掌不可兼得，你又想简单又想可拓展性强，哪有那么好的事啊？因此建立一个类集群中的抽象父类就没有那么简单了。

好了，上面解释了这么多其实主要就说明了为何子类化NSTextStorage须要写这么多代码，下面要在UITextView使用咱们自定义的text storage了。

设置UITextView

- (void)createMarkupTextView
{
    NSDictionary *attributes = @{NSFontAttributeName: [UIFont preferredFontForTextStyle:UIFontTextStyleBody]};
    NSString *content = [NSString stringWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"content" ofType:@"txt"]
                                                  encoding:NSUTF8StringEncoding
                                                     error:nil];
    NSAttributedString *attributedString = [[NSAttributedString alloc] initWithString:content
                                                                           attributes:attributes];
    _textStorage = [[MarkupTextStorage alloc] init];
    [_textStorage setAttributedString:attributedString];
    
    CGRect textViewRect = CGRectMake(20, 60, 280, self.view.bounds.size.height - 100);
    
    NSLayoutManager *layoutManager = [[NSLayoutManager alloc] init];
    
    NSTextContainer *textContainer = [[NSTextContainer alloc] initWithSize:CGSizeMake(textViewRect.size.width, CGFLOAT_MAX)];
    [layoutManager addTextContainer:textContainer];
    [_textStorage addLayoutManager:layoutManager];
    
    _textView = [[UITextView alloc] initWithFrame:textViewRect
                                    textContainer:textContainer];
    _textView.delegate = self;
    [self.view addSubview:_textView];
}

很长的代码，下面咱们来看看都作了些啥：

  1. 建立了一个自定义的text storage对象，并经过attributed string保存了须要显示的内容；
  2. 建立了一个layout manager对象；
  3. 建立了一个text container对象并将它与layout manager关联，而后该text container再和text storage对象关联；
  4. 经过text container建立了一个text view并显示。

你能够将代码和前面那对象间的关系图对应着理解一下。

动态格式化

继续在MarkupTextStorage.m文件中添加以下方法：

- (void)processEditing
{
    [self performReplacementsForRange:[self editedRange]];
    [super processEditing];
}

processEditing在layout manager中文本修改时发送通知，它一般也是处理一些文本修改逻辑的好地方。

继续添加：

- (void)performReplacementsForRange:(NSRange)changedRange
{
    NSRange extendedRange = NSUnionRange(changedRange, [[_backingStore string]
                                                        lineRangeForRange:NSMakeRange(changedRange.location, 0)]);
    extendedRange = NSUnionRange(changedRange, [[_backingStore string]
                                                lineRangeForRange:NSMakeRange(NSMaxRange(changedRange), 0)]);
    [self applyStylesToRange:extendedRange];
}

这个方法用于扩大文本匹配的范围，由于changedRange只是标识出一个字符，lineRangeForRange会将范围扩大到当前的一整行。

下面就剩下匹配特定格式的文原本显示对应的样式了：

- (NSDictionary*)createAttributesForFontStyle:(NSString*)style
                                    withTrait:(uint32_t)trait {
    UIFontDescriptor *fontDescriptor = [UIFontDescriptor
                                        preferredFontDescriptorWithTextStyle:UIFontTextStyleBody];
    
    UIFontDescriptor *descriptorWithTrait = [fontDescriptor
                                             fontDescriptorWithSymbolicTraits:trait];
    
    UIFont* font =  [UIFont fontWithDescriptor:descriptorWithTrait size: 0.0];
    return @{ NSFontAttributeName : font };
}

- (void)createMarkupStyledPatterns 
{
    UIFontDescriptor *scriptFontDescriptor =
    [UIFontDescriptor fontDescriptorWithFontAttributes:
     @{UIFontDescriptorFamilyAttribute: @"Bradley Hand"}];
    
    // 1. base our script font on the preferred body font size
    UIFontDescriptor* bodyFontDescriptor = [UIFontDescriptor
                                            preferredFontDescriptorWithTextStyle:UIFontTextStyleBody];
    NSNumber* bodyFontSize = bodyFontDescriptor.
    fontAttributes[UIFontDescriptorSizeAttribute];
    UIFont* scriptFont = [UIFont
                          fontWithDescriptor:scriptFontDescriptor size:[bodyFontSize floatValue]];
    
    // 2. create the attributes
    NSDictionary* boldAttributes = [self
                                    createAttributesForFontStyle:UIFontTextStyleBody
                                    withTrait:UIFontDescriptorTraitBold];
    NSDictionary* italicAttributes = [self
                                      createAttributesForFontStyle:UIFontTextStyleBody
                                      withTrait:UIFontDescriptorTraitItalic];
    NSDictionary* strikeThroughAttributes = @{ NSStrikethroughStyleAttributeName : @1, NSForegroundColorAttributeName: [UIColor redColor]};
    NSDictionary* scriptAttributes = @{ NSFontAttributeName : scriptFont, NSForegroundColorAttributeName: [UIColor blueColor] };
    NSDictionary* redTextAttributes =
    @{ NSForegroundColorAttributeName : [UIColor redColor]};
    
    _replacements = @{ @"(\\*\\*\\w+(\\s\\w+)*\\*\\*)" : boldAttributes, @"(_\\w+(\\s\\w+)*_)" : italicAttributes, @"(~~\\w+(\\s\\w+)*~~)" : strikeThroughAttributes, @"(`\\w+(\\s\\w+)*`)" : scriptAttributes, @"\\s([A-Z]{2,})\\s" : redTextAttributes
                      };
}

- (void)applyStylesToRange:(NSRange)searchRange
{
    NSDictionary* normalAttrs = @{NSFontAttributeName:
                                      [UIFont preferredFontForTextStyle:UIFontTextStyleBody]};
    
    // iterate over each replacement
    for (NSString* key in _replacements) {
        NSRegularExpression *regex = [NSRegularExpression
                                      regularExpressionWithPattern:key
                                      options:0
                                      error:nil];
        
        NSDictionary* attributes = _replacements[key];
        
        [regex enumerateMatchesInString:[_backingStore string]
                                options:0
                                  range:searchRange
                             usingBlock:^(NSTextCheckingResult *match,
                                          NSMatchingFlags flags,
                                          BOOL *stop){
                                 // apply the style
                                 NSRange matchRange = [match rangeAtIndex:1];
                                 [self addAttributes:attributes range:matchRange];
                                 
                                 // reset the style to the original
                                 if (NSMaxRange(matchRange)+1 < self.length) {
                                     [self addAttributes:normalAttrs
                                                   range:NSMakeRange(NSMaxRange(matchRange)+1, 1)];
                                 }
                             }];
    }
}

在text storage初始化方法中调用createMarkupStyledPatterns，经过正则表达式来给特定格式的字符串设定特定显示样式，造成一个对应的字典。而后在applyStylesToRange:中利用已定义好的样式字典来给匹配的文本端增长样式。

到这里本篇文章的内容就结束了，其实前面三点都很简单，稍微过一下就能用。最后一个动态文本格式化内容稍微多一点，能够结合个人代码TextKitDemo来看。

参考连接：

Posted by TracyYih - Oct 17 2013
如需转载，请注明： 本文来自 Esoft Mobile

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程