textkit

时间  2019-12-09
标签 textkit 繁體版
原文   原文链接

更详细的内容能够参考官方文档 《Text Programming Guide for iOS》。html

 

“Text Kit指的是UIKit框架中用于提供高质量排版服务的一些类和协议，它让程序可以存储，排版和显示文本信息，并支持排版所须要的全部特性，包括字距调整、连写、换行和对齐等。”
 
之前，若是咱们想实现复杂的文本排版，例如在textView中显示不一样样式的文本，或者图片和文字混排，你可能就须要借助于UIWebView或者深刻研究一下Core Text。在iOS6中，UILabel、UITextField、UITextView增长了一个NSAttributedString属性，能够稍微解决一些排版问题，可是支持的力度还不够。如今Text Kit彻底改变了这种现状。
 
Text Kit是基于Core Text构建的快速、先进的文本排版和渲染引擎，而且与UIKit很好的集合。UITextView，UITextField、UILabel都已经基于Text Kit从新构建，因此它们都支持分页文本、文本包装、富文本编辑、交互式文本着色、文本折叠和自定义截取等特性。全部这些UI控件如今都以一样的方式构建，在它们后面，一个NSTextStorage对象保存着文本的主要信息，它自己是NSMutableAttributedString的子类，支持分批编辑。这就意味着你能够改变一个范围内的字符的样式而不用总体替换文本内容。
 
  1. [self.textView.textStorage beginEditing]; 
  2. [self markWord:@"Alice" inTextStorage:self.textView.textStorage]; 
  3. [self.textView.textStorage endEditing]; 
 
Text storage管理者一系列的NSLayoutManager对象，当它的字符或者属性改变时会通知到本身所管理的layout Manager对象以便它们做出相应的反应。在layout manager上面是一个NSTextContainer对象，用于为layout manager定义坐标系和一些几何特性。例如，若是你想UITextView中的文本环绕在一张图片四周，你能够给text container设定一个排除路径(exclusion path)。
 
  1. UIBezierPath *exclusion = ButterflyBezierPath; 
  2. self.textView.textContainer.exclusionPaths = @[exclusion]; 
 
 
Text container可以处理击中测试(hit tests)，因此能够定位到点击的字符在文本中的位置。此外它还提供一些代理方法让开发者可以本身定义连接点击后的处理事件。
 
 
经过基于Text Kit从新构建UILabel、UITextField和UITextView，苹果给开发者更大的灵活性和能力来设计富文本视图，同时简化了这些控件的使用，由于它们是以一样的方式设计的，全部这些好处都是站在巨人(Core Text)的肩上。一般更强大的功能和灵活性也就意味着须要更多的设置和管理，可是，若是你只是想显示一段简单的文本，你仍是能够像之前同样使用。
 
  1. self.textLabel.text = @"Hello Text Kit"; 
 
 本文翻译自《 iOS 7: Text Kit》
 
 
Text Kit进阶
上一篇文章Text Kit入门中咱们主要了解了什么是Text Kit及它的一些架构和基本特性，这篇文章中会涉及关于Text Kit的更多具体应用。
 
Text Kit是创建在Core Text框架上的，咱们知道CoreText.framework是一个庞大而复杂的框架，而Text Kit在继承了Core Text强大功能的同时给开发者提供了比较友好的面向对象的API。
 
本文主要介绍Text Kit下面四个特性：
动态字体（Dynamic type）
凸版印刷体效果（Letterpress effects）
路径排除（Exclusion paths）
动态文本格式化和存储（Dynamic text formatting and storage）
 
动态字体（Dynamic type）
动态字体是iOS7中新增长的比较重要的特性之一，程序应该按照用户设定的字体大小和粗细来显示文本内容。
 
分别在设置\通用\辅助功能和设置\通用\文字大小中能够设置文本在应用程序中显示的粗细和大小。
iOS7对系统字体在显示上作了一些优化，让不一样大小的字体在屏幕上都能清晰的显示。一般用户设置了本身偏好的字体，他们但愿在全部程序中都看到文本显示是根据他们的设定进行调整。为了实现这个，开发者须要在本身的应用中给文本控件设置当前用户设置字体，而不是指定死字体及大小。能够经过UIFont中新增的preferredFontForTextStyle:方法来获取用户偏好的字体。
 
iOS7中给出了6中字体样式供选择：
UIFontTextStyleHeadline
UIFontTextStyleBody
UIFontTextStyleSubheadline
UIFontTextStyleFootnote
UIFontTextStyleCaption1
UIFontTextStyleCaption2
 
 为了让咱们的程序支持动态字体，须要按一下方式给文本控件（一般是指UILabel，UITextField，UITextView）设定字体：
 
  1. self.textView.font = [UIFont preferredFontForTextStyle:UIFontTextStyleBody]; 
 
这样设置以后，文本控件就会以用户设定的字体大小及粗细显示，可是若是程序在运行时，用户切换到设置里修改了字体，这是在切回程序，字体并不会自动跟着变。这时就须要咱们本身来更新一下控件的字体了。
 
在系统字体修改时，系统会给运行中的程序发送UIContentSizeCategoryDidChangeNotification通知，咱们只须要监听这个通知，并从新设置一下字体便可。
 
  1. [[NSNotificationCenter defaultCenter] addObserver:self 
  2.     selector:@selector(preferredContentSizeChanged:) 
  3.     name:UIContentSizeCategoryDidChangeNotification 
  4.     object:nil]; 
 
 
  1. - (void)preferredContentSizeChanged:(NSNotification *)notification{ 
  2.     self.textView.font = [UIFont preferredFontForTextStyle:UIFontTextStyleBody]; 
  3. } 
固然，有的时候要适应动态修改的字体并非这么设置一下就完事了，控件的大小可能也须要进行相应的调整，这时咱们程序中的控件大小也不该该写死，而是须要根据字体大小来计算.
 
凸版印刷体效果（Letterpress effects）
凸版印刷替效果是给文字加上奇妙阴影和高光，让文字看起有凹凸感，像是被压在屏幕上。固然这种看起来很高端大气上档次的效果实现起来确实至关的简单，只须要给AttributedString加一个NSTextEffectAttributeName属性，并指定该属性值为NSTextEffectLetterpressStyle就能够了。
 
  1. tionary *attributes = @{  
  2.     NSForegroundColorAttributeName: [UIColor redColor], 
  3.     NSFontAttributeName: [UIFont preferredFontForTextStyle:UIFontTextStyleHeadline], 
  4.     NSTextEffectAttributeName: NSTextEffectLetterpressStyle 
  5. }; 
  6. self.titleLabel.attributedText = [[NSAttributedString alloc] initWithString:@"Title" attributes:attributes]; 
 
 
在iOS7系统自带的备忘录应用中，苹果就使用了这种凸版印刷体效果。
 
路径排除（Exclusion paths）
在排版中，图文混排是很是常见的需求，但有时候咱们的图片并必定都是正常的矩形，这个时候咱们若是须要将文本环绕在图片周围，就能够用路径排除（exclusion paths）了。
 
Explosion pats基本原理是将须要被文本留出来的形状的路径告诉文本控件的NSTextContainer对象，NSTextContainer在文字排版时就会避开该路径。
 
  1. UIBezierPath *floatingPath = [self pathOfImage]; 
  2. self.textView.textContainer.exclusionPaths = @[floatingPath]; 
 
 
因此实现Exclusion paths的主要工做就是获取这个path。
 
动态文本格式化和存储（Dynamic text formatting and storage）
好了，到如今咱们知道了Text Kit能够动态的根据用户设置的字体大小进行调整，可是若是具体某个文本显示控件中的文本样式可以动态调整是否是会更酷一些呢？
 
 
 
实现这些才是真正体现Text Kit强大之处的时候，在此以前你须要理解Text Kit中的文本存储系统是怎么工做的，下图显示了Text Kit中文本的保存、渲染和现实之间的关系。
 
当你使用UITextView、UILabel、UITextField控件的时候，系统会自动建立上面这些类，你能够选择直接使用这么默认的实现或者为你的控件自定义这几个中的任何一个。
 
1.NSTextStorage自己继承与NSMutableAttributedString，它是以attributed string的形式保存须要渲染的文本，并在文本内容改变的时候通知到对应的layout manager对象。一般你须要建立NSTextStorage的子类来在文本改变时进行文本显示样式的更新。
 
2.NSLayoutManager做为文本控件中的排版引擎接收保存的文本并在屏幕上渲染出来。
 
3.NSTextContainer描述了文本在屏幕上显示时的几何区域，每一个text container与一个具体的UITextView相关联。若是你须要定义一个很复杂形状的区域来显示文本，你可能须要建立NSTextContainer子类。
 
要实现咱们上面描述的动态文本格式化功能，咱们须要建立NSTextStorage子类以便在用户输入文本的时候动态的增长文本属性。自定义了text storage后，咱们须要替换调UITextView默认的text storage。
 
建立NSTextStorage的子类
咱们建立NSTextStorage子类，命名为MarkupTextStorage，在实现文件中添加一个成员变量：
 
  1. #import "MarkupTextStorage.h" 
  2.  
  3. @implementation MarkupTextStorage 
  4. { 
  5.     NSMutableAttributedString *_backingStore; 
  6. } 
  7.  
  8. - (id)init 
  9. { 
  10.     self = [super init]; 
  11.     if (self) { 
  12.         _backingStore = [[NSMutableAttributedString alloc] init]; 
  13.     } 
  14.     return self; 
  15. } 
  16.  
  17. @end 
 
NSTextStorage的子类须要重载一些方法提供NSMutableAttributedString类型的backing store信息，因此咱们继续添加下面代码：
 
  1. - (NSString *)string 
  2. { 
  3.     return [_backingStore string]; 
  4. } 
  5.  
  6. - (NSDictionary *)attributesAtIndex:(NSUInteger)location effectiveRange:(NSRangePointer)range 
  7. { 
  8.     return [_backingStore attributesAtIndex:location effectiveRange:range]; 
  9. } 
  10.  
  11. - (void)replaceCharactersInRange:(NSRange)range withString:(NSString *)str 
  12. { 
  13.     [self beginEditing]; 
  14.     [_backingStore replaceCharactersInRange:range withString:str]; 
  15.     [self edited:NSTextStorageEditedCharacters | NSTextStorageEditedAttributes 
  16.            range:range changeInLength:str.length - range.length]; 
  17.     [self endEditing]; 
  18. } 
  19.  
  20. - (void)setAttributes:(NSDictionary *)attrs range:(NSRange)range 
  21. { 
  22.     [self beginEditing]; 
  23.     [_backingStore setAttributes:attrs range:range]; 
  24.     [self edited:NSTextStorageEditedAttributes 
  25.            range:range changeInLength:0]; 
  26.     [self endEditing]; 
  27. } 
 
后面两个方法都是代理到backing store，而后须要被beginEditing edited endEditing包围，并且必须在文本编辑时按顺序调用来通知text storage对应的layout manager。
 
你可能发现子类化NSTextStorage须要写很多的代码，由于NSTextStorage是一个类集群中的一个开发接口，不能只是继承它而后重载不多的方法来拓展它的功能，而是须要本身实现不少细节。
 
类集群(Class cluster)是苹果Cocoa(Touch)框架中经常使用的设计模式之一。
 
类集群是Objective-C中对抽象工厂模式的简单实现，为建立一些列相关或独立对象提供了统一的接口而不用指定具体的类。经常使用的像NSArray和NSNumber事实上也是一系列类集群的开放接口。
 
苹果使用类集群是为了将一些类具体类隐藏在开放的抽象父类之下，外面经过抽象父类的方法来建立私有子类的实例，而且外界也彻底不知道工厂分配到了哪一个私有类，由于它们始终只和开放接口交互。
 
使用类集群确实简化了接口，让类更容易被使用，可是要知道鱼和熊掌不可兼得，你又想简单又想可拓展性强，哪有那么好的事啊？因此建立一个类集群中的抽象父类就没有那么简单了。
 
好了，上面解释了这么多其实主要就说明了为何子类化NSTextStorage须要写这么多代码，下面要在UITextView使用咱们自定义的text storage了。
 
设置UITextView
  1. - (void)createMarkupTextView 
  2. { 
  3.     NSDictionary *attributes = @{NSFontAttributeName: [UIFont preferredFontForTextStyle:UIFontTextStyleBody]}; 
  4.     NSString *content = [NSString stringWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"content" ofType:@"txt"] 
  5.                                                   encoding:NSUTF8StringEncoding 
  6.                                                      error:nil]; 
  7.     NSAttributedString *attributedString = [[NSAttributedString alloc] initWithString:content 
  8.                                                                            attributes:attributes]; 
  9.     _textStorage = [[MarkupTextStorage alloc] init]; 
  10.     [_textStorage setAttributedString:attributedString]; 
  11.      
  12.     CGRect textViewRect = CGRectMake(20, 60, 280, self.view.bounds.size.height - 100); 
  13.      
  14.     NSLayoutManager *layoutManager = [[NSLayoutManager alloc] init]; 
  15.      
  16.     NSTextContainer *textContainer = [[NSTextContainer alloc] initWithSize:CGSizeMake(textViewRect.size.width, CGFLOAT_MAX)]; 
  17.     [layoutManager addTextContainer:textContainer]; 
  18.     [_textStorage addLayoutManager:layoutManager]; 
  19.      
  20.     _textView = [[UITextView alloc] initWithFrame:textViewRect 
  21.                                     textContainer:textContainer]; 
  22.     _textView.delegate = self; 
  23.     [self.view addSubview:_textView]; 
  24. } 
很长的代码，下面咱们来看看都作了些啥：
 
1.建立了一个自定义的text storage对象，并经过attributed string保存了须要显示的内容；
2.建立了一个layout manager对象；
3.建立了一个text container对象并将它与layout manager关联，而后该text container再和text storage对象关联；
4.经过text container建立了一个text view并显示。
 
你能够将代码和前面那对象间的关系图对应着理解一下。
 
动态格式化
继续在MarkupTextStorage.m文件中添加以下方法：
  1. - (void)processEditing 
  2. { 
  3.     [self performReplacementsForRange:[self editedRange]]; 
  4.     [super processEditing]; 
  5. } 
 
 processEditing在layout manager中文本修改时发送通知，它一般也是处理一些文本修改逻辑的好地方。
 
继续添加：
  1. - (void)performReplacementsForRange:(NSRange)changedRange 
  2. { 
  3.     NSRange extendedRange = NSUnionRange(changedRange, [[_backingStore string] 
  4.                                                         lineRangeForRange:NSMakeRange(changedRange.location, 0)]); 
  5.     extendedRange = NSUnionRange(changedRange, [[_backingStore string] 
  6.                                                 lineRangeForRange:NSMakeRange(NSMaxRange(changedRange), 0)]); 
  7.     [self applyStylesToRange:extendedRange]; 
  8. } 
 
这个方法用于扩大文本匹配的范围，由于changedRange只是标识出一个字符，lineRangeForRange会将范围扩大到当前的一整行。
 
下面就剩下匹配特定格式的文原本显示对应的样式了：
  1. - (NSDictionary*)createAttributesForFontStyle:(NSString*)style 
  2.                                     withTrait:(uint32_t)trait { 
  3.     UIFontDescriptor *fontDescriptor = [UIFontDescriptor 
  4.                                         preferredFontDescriptorWithTextStyle:UIFontTextStyleBody]; 
  5.      
  6.     UIFontDescriptor *descriptorWithTrait = [fontDescriptor 
  7.                                              fontDescriptorWithSymbolicTraits:trait]; 
  8.      
  9.     UIFont* font =  [UIFont fontWithDescriptor:descriptorWithTrait size: 0.0]; 
  10.     return @{ NSFontAttributeName : font }; 
  11. } 
  12.  
  13. - (void)createMarkupStyledPatterns  
  14. { 
  15.     UIFontDescriptor *scriptFontDescriptor = 
  16.     [UIFontDescriptor fontDescriptorWithFontAttributes: 
  17.      @{UIFontDescriptorFamilyAttribute: @"Bradley Hand"}]; 
  18.      
  19.     // 1. base our script font on the preferred body font size 
  20.     UIFontDescriptor* bodyFontDescriptor = [UIFontDescriptor 
  21.                                             preferredFontDescriptorWithTextStyle:UIFontTextStyleBody]; 
  22.     NSNumber* bodyFontSize = bodyFontDescriptor. 
  23.     fontAttributes[UIFontDescriptorSizeAttribute]; 
  24.     UIFont* scriptFont = [UIFont 
  25.                           fontWithDescriptor:scriptFontDescriptor size:[bodyFontSize floatValue]]; 
  26.      
  27.     // 2. create the attributes 
  28.     NSDictionary* boldAttributes = [self 
  29.                                     createAttributesForFontStyle:UIFontTextStyleBody 
  30.                                     withTrait:UIFontDescriptorTraitBold]; 
  31.     NSDictionary* italicAttributes = [self 
  32.                                       createAttributesForFontStyle:UIFontTextStyleBody 
  33.                                       withTrait:UIFontDescriptorTraitItalic]; 
  34.     NSDictionary* strikeThroughAttributes = @{ NSStrikethroughStyleAttributeName : @1, 
  35.                                                NSForegroundColorAttributeName: [UIColor redColor]}; 
  36.     NSDictionary* scriptAttributes = @{ NSFontAttributeName : scriptFont, 
  37.                                         NSForegroundColorAttributeName: [UIColor blueColor] 
  38.                                         }; 
  39.     NSDictionary* redTextAttributes = 
  40.     @{ NSForegroundColorAttributeName : [UIColor redColor]}; 
  41.      
  42.     _replacements = @{ 
  43.                       @"(\\*\\*\\w+(\\s\\w+)*\\*\\*)" : boldAttributes, 
  44.                       @"(_\\w+(\\s\\w+)*_)" : italicAttributes, 
  45.                       @"(~~\\w+(\\s\\w+)*~~)" : strikeThroughAttributes, 
  46.                       @"(`\\w+(\\s\\w+)*`)" : scriptAttributes, 
  47.                       @"\\s([A-Z]{2,})\\s" : redTextAttributes 
  48.                       }; 
  49. } 
  50.  
  51. - (void)applyStylesToRange:(NSRange)searchRange 
  52. { 
  53.     NSDictionary* normalAttrs = @{NSFontAttributeName: 
  54.                                       [UIFont preferredFontForTextStyle:UIFontTextStyleBody]}; 
  55.      
  56.     // iterate over each replacement 
  57.     for (NSString* key in _replacements) { 
  58.         NSRegularExpression *regex = [NSRegularExpression 
  59.                                       regularExpressionWithPattern:key 
  60.                                       options:0 
  61.                                       error:nil]; 
  62.          
  63.         NSDictionary* attributes = _replacements[key]; 
  64.          
  65.         [regex enumerateMatchesInString:[_backingStore string] 
  66.                                 options:0 
  67.                                   range:searchRange 
  68.                              usingBlock:^(NSTextCheckingResult *match, 
  69.                                           NSMatchingFlags flags, 
  70.                                           BOOL *stop){ 
  71.                                  // apply the style 
  72.                                  NSRange matchRange = [match rangeAtIndex:1]; 
  73.                                  [self addAttributes:attributes range:matchRange]; 
  74.                                   
  75.                                  // reset the style to the original 
  76.                                  if (NSMaxRange(matchRange)+1 < self.length) { 
  77.                                      [self addAttributes:normalAttrs 
  78.                                                    range:NSMakeRange(NSMaxRange(matchRange)+1, 1)]; 
  79.                                  } 
  80.                              }]; 
  81.     } 
  82. } 
 在createMarkupStyledPatterns初始化方法中调用createMarkupStyledPatterns，经过正则表达式来给特定格式的字符串设定特定显示样式，造成一个对应的字典。而后在applyStylesToRange:中利用已定义好的样式字典来给匹配的文本端增长样式。
 
到这里本篇文章的内容就结束了，其实前面三点都很简单，稍微过一下就能用。最后一个动态文本格式化内容稍微多一点，能够结合个人代码TextKitDemo来看。
 
参考连接：
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程