YYKit之YYText

原文:http://www.cnblogs.com/lujianwenance/p/5716804.html

本文的目的是希望能帮助到我们更快的熟悉和学习YYText的结构和实现的思路,如有不正确或者不准确的地方请指正,谢谢。

一、特点与用法

关于YYText的特点和用法请看@ibireme大神的github:

https://github.com/ibireme/YYText

二、使用到的组件

1、介绍YYLabel之前先说一下YYTextAttribute,因为后面会大量的使用到它。

YYTextAttribute:

1)定义的一些Enum,YYTextAttributeType:attribute的类型,有None、UIKit、CoreText和YYText四种类型;YYTextLineStyle:line的样式;YYTextVerticalAlignment:垂直方向text的位置;YYTextDirection:text的位置;YYTextTruncationType:text截断的位置。

2)YYText中定义的Attribute Name。主要是独有的一些类型。

3)YYTextBackedString:可以将一些表情图片映射成纯文本。

4)YYTextBinding:使一些特定的字符串绑定在一起,YYTextView在选择和编辑他们的时候把他们当成一个单独的字符。

5)YYTextShadow:用处和NSShadow一样,只是比NSShadow多了一些功能,比如说可以使用blendMode(图形混合模式)、可以在shadow上再加一层shadow。关于blendMode的学习,可以参见喵神的博客:https://onevcat.com/2013/04/using-blending-in-ios/

6)YYTextDecoration:实现下划线(underline)和中间截线(strikethrough)时使用,线条的形式给出了几种样式,可以通过YYTextLineStyle枚举查看。具体是underline还是strikethrough是在NSAttributedString+YYText中NSMutableAttributeString(YYText)中实现的方法。

7)YYTextBorder:实现在文本周围画一个border,也可以是填充一个背景色。

8)YYTextAttachment:封装需要放入text中的对象。在说明文档中提到,如果attachment是UIImage,就绘制到CGContext,如果是UIView或者CALayer就加入到text container的view或者layer中。

9)YYTextHightlight:当YYLabel或者YYTextView中的text可以被用户按下时,被按下的text会有一个highlighted 状态,这时候就需要是用YYTextHighlight来修改原来的text。所以这个对象和YYText一样,只是是在highlight状态下的YYText,而且添加了点击和长按事件。

2、再来说一下NSAttributedString+YYText文件

在这个分类中主要是实现了几类的操作:

1)一些操作当前attributed string的方法

比如说归档和反归档当前字符串、获得某个位置的attributes、字间距、色值、背景色、shadow等等。具体的参见文件,基本上是作者封装的方便获得各种数据的方法。(和Foundation中比强大太多了)。

2)为YYText创建attachment的方法

3)为YYText添加YYText特有的attribute的方法

4)添加像设置属性一样的设置character attribute的font、color、backgroundColor等等的方法。

5)添加像设置属性一样的设置paragraph attribute的方法。

6)添加像设置属性一样的设置YYText attribute的方法。

7)使用range设置不连续的attribute的方法

8)设置text highlight 的便捷方法

9)和其他的工具型的方法。

3、NSParagraphStyle+YYText文件

提供了CoreText中的CTParagraphStyleRef和NSParagraphStyle之间的转化。

4、YYTextParser

这是一个protocol,声明了一个-(BOOL)parseText:(NSMutableAttributedString *)string selectedRange:(NSRangePointer)selectedRange;方法。这个方式是遵守这个协议必须实现的方法,当YYTextView或者YYLabel中的text改变时被调用。返回YES说明修改了这个text。

作者简单的实现了MarkdownParser和EmotionParser,两个原理都差不多一样,在这里只对EmotionParser做一下简单的介绍,希望能有所启发:

这段代码就是生成正则表达式_regex和映射的字典_mapper,第一层for是获得你要匹配的key,第二层是如果有这些特殊的字符需要转译一下,然后将这些需要比配的key 用“|”连接起来。

这个就是修改text之后会被调用的方法,在这个方法里对输入的text进行匹配,如果匹配到之前_mapper中需要替换的字符,就将这个字符串替换为需要替换的表情符。

替换成表情符之后就需要重新计算这个表情符所占的range了,这个方法就是拿到替换之后的的range。

5、YYTextLayout

先看一下文档中的说明,如下图:

是不是很眼熟?好像在哪见过?是的,就是NSLayoutManager和NSTextContainer。他们的作用都是相似的。

1)YYTextContainer

支持矩形(CGSize)和图形(UIBezierPath)来初始化YYTextContainer;

在这里重点说一下YYTextLinePositionModifier,它是 一个协议,定义了一个必须实现的方法,这个方法将会在layout完成的时候被调用,三个参数分别是存放YYTextLine的数组、完整的text和layout container。

YYTextLine:它是封装了CTLineRef的对象,封装了每一行text的具体展示位置、range、这一行拥有的attachments等等,只有一个类方法的初始化方法。如果不了解一些自行描述集的内容,对textLine中的一些属性和操作会不是很清晰,看下图:

边框(Bounding Box):一个假想的边框,尽可能地容纳整个字形。

基线(Baseline):一条假想的参照线,以此为基础进行字形的渲染。一般来说是一条横线。

基础原点(Origin):基线上最左侧的点。

行间距(Leading):行与行之间的间距。

字间距(Kerning):字与字之间的距离,为了排版的美观,并不是所有的字形之间的距离都是一致的,但是这个基本步影响到我们的文字排版。

上行高度(Ascent)和下行高度(Decent):一个字形最高点和最低点到基线的距离,所以行高就是ascent + decent。

看完上面的简单介绍你就能明白,在YYTextLine的setCTLine中的代码逻辑是从CTLineRef中取出对应的行宽、上行高度、下行高度、行间距、rangge和第一个字型符的位置(这个在垂直布局会用到)。之后调用reloadBounds方法,重新计算当前行的bounds、attachments所在的range和rect。

2)YYTextLayout

这个真的是核心内容了,这个文件一共3300多行的代码,从代码量上就能看出它的地位。这个类中存储着text的layout结果,所有的property都是readonly的。实现的接口有:

1、通过一些类方法初始化的方法(YYTextContainer、CGSize和text)

2、layout之后的attributes,都是只读的

3、从layout中读取信息(位置、range等等)

4、绘制text layout

这个类主要是使用上面讲过的所有的数据来绘制text,这部分的代码还是需要一点一点的去读的,如果是新手每一行都会有收获(比如说我),如果是老司机就没有必要一行行的读了,了解他的解题思路和解决这个问题的办法就可以。下面说一下生成layout的那个500行代码的情况,就按照代码的顺序从上往下大概的说明一下干了什么。

1)、初始化一系列使用到的变量

2)、安全判断,text和container

3)、判断是否需要修复emoji的bug(iOS8.3中)

4)、判断是否设置了path属性和exclusionPaths数组,做相应的计算拿到cgpath,如果cgpath为空则goto fail 返回nil(如果设置了path,size和insets就没有用了)

5)、判断是不是奇偶填充,判断pathWidth是否为0,判断是否是垂直展示

6)、使用text创建CTFramesetterRef,创建失败goto fail

7)、使用上一步中创建的frameSetter创建CTFrameRef

8)、从CTFrameRef的对象中获得每一行、ctRun数组,计算每一行的frame,判断是否实现了linePositionModifier这个协议,有的话调用协议方法。

9)、计算bounding size

10)、判断是否需要truncation,和按那种方式处理

11)、判断是否垂直布局text,需要的话,旋转布局

12)、判断得到的visibleRange长度,有效的话遍历text中的attributes,配置对应的layout属性

13)、配置layout中的attachments

14)、配置结束,返回layout

绘制时就是根据layout中的配置情况绘制相应的特征,这段代码在此就不做分析了。

6、YYAsyncLayer文件

YYAsyncLayerDispalyTask是在YYAsyncLayer去background queue 渲染是调用的对象,它有三个回调,一个willDisplay在渲染之前、一个didDisplay在渲染之后和渲染时被调用的display。

YYAsyncLayer是CAlayer的子类,当这个layer更新contents时就会调用delegate方法去调用async display task 去background queue 渲染。这个delegate方法是YYAsyncLayerDelegate的方法。

YYAsyncLayer在刷新时调用_displayAsync:方法,然后调用遵守YYAsyncLayerDelegate的对象实现的newAsyncDisplayTask方法,获取到需要绘制的前后和绘制时的task,根据是够需要异步来判断直接在主线程执行绘制代码还是异步执行绘制代码。

在异步绘制过程中用到了一个异步队列,获取方法是YYAsyncLayerGetDisplayQueue,在这个方法中有一个关于QOS的概念,NSQualityOfService(QOS)ios8之后提供的新功能,这个枚举值是要告诉操作系统我们在进行什么样的工作,让系统能通过合理的资源控制来最高效的执行任务代码,主要涉及CPU调度、IO优先级、任务运行在哪个线程以及运行的顺序等等。

      枚举值的含义如下:

            NSQualityOfServiceUserInteractive

            与用户交互的任务,这些任务通常跟UI级别的刷新相关,比如动画,这些任务需要在一瞬间完成

            NSQualityOfServiceUserInitiated

            由用户发起的并且需要立即得到结果的任务,比如滑动scroll view时去加载数据用于后续cell的显示,这些任务通常跟后续的用户交互相关,在几秒或者更短的时间内完成

            NSQualityOfServiceUtility

            一些可能需要花点时间的任务,这些任务不需要马上返回结果,比如下载的任务,这些任务可能花费几秒或者几分钟的时间

            NSQualityOfServiceBackground
            这些任务对用户不可见,比如后台进行备份的操作,这些任务可能需要较长的时间,几分钟甚至几个小时

            NSQualityOfServiceDefault

            优先级介于user-initiated 和 utility,当没有 QoS信息时默认使用,开发者不应该使用这个值来设置自己的任务

Qos和GCD queue的对照图:

看详细的分析请到这里:http://www.jianshu.com/p/f9e01c69a46f

收获到的小知识点:

1、iOS7 and later,UIFont 和CTFontRef是 toll-free bridged的,在iOS6,UIFont是对CTFontRref的封装,所以在CoreText中是可以使用UIFont的,但是在UILabel和UITextView中不能使用CTFontRef。

2、NSParagraphStype不是toll-free bridged 到CTParagraphStypeRef,CoreText可以同时使用两者,但UILabel和UITextView只能使用NSParagraphStyle。

3、查看.a静态文件支持哪种iOS处理器

时间: 2024-11-05 00:33:30

YYKit之YYText的相关文章

iOS 文本展开收起

经常会遇到类似微信的展开收起,本身这个逻辑是比较清晰的,动态变换文本的高度就可以,但实际操作过程中,却会有各种坑,最令人蛋疼的就是抖动,下面简述下自己的采坑之路 一.给定文本一个限定高度(比如:90),小于等于90就取90,大于90默认收起,点击展开取真实高度,点击收起,取90.这样的做法是直接拿到内容就计算出高度,变高度. 以下5种方法经测验方案5抖动最小属于偶发性质且很不明显(抖动的根本原因在于文本的高度是可变的,在偶发情况下可能刚好使cell的高度在一个临界值:比如差零点几个像素之类的,然

专访 YYKit 作者 ibireme: 开源大牛是怎样炼成的

前言 第一次听到 ibireme 这个名字,是看到他在 微博上分享 了 YYText 开源库.当时我第一眼见到 YYText 的功能示意 GIF 图时(下图所示),就被它丰富的功能吸引了.YYText 应该是我见到过的功能最强大的基于 CoreText 的排版框架了. 令人惊讶的是,YYText 虽然代码量很大(超过一万行),但它只是 ibireme 的作品之一.ibireme 利用业余时间完成了 YYKit 工具库,包括: YYModel — 高性能的 iOS JSON 模型框架. YYCac

功能强大的 iOS 富文本编辑与显示框架:YYText

功能强大的 iOS 富文本编辑与显示框架.(该项目是 YYKit 组件之一) 特性 API 兼容 UILabel 和 UITextView 支持高性能的异步排版和渲染 扩展了 CoreText 的属性以支持更多文字效果 支持 UIImage.UIView.CALayer 作为图文混排元素 支持添加自定义样式的.可点击的文本高亮范围 支持自定义文本解析 (内置简单的 Markdown/表情解析) 支持文本容器路径.内部留空路径的控制 支持文字竖排版,可用于编辑和显示中日韩文本 支持图片和富文本的复

YYKit @autoreleasepool 使用,优化内存

写在前面 最近再看YY大神的YYKit工具,发现在代码中经常使用@autoreleasepool,特别是在与for循环搭配使用的时候.刚开始很不能理解. 之前对iOS的ARC的理解就是自己创建的对象,会在该对象所在是代码快(当前作用域)结束时候自动释放.无需程序员自己管理.但是如果仔细研究YYKit的代码的话,发现如果注释掉@autoreleasepool,程序一样可以正常运行,但是观察当前内存,会比在加上该句代码时候占用比更大的空间.所以自己百度了一下,这里是sunny(百度一90后iOS程序

YYKit源码阅读 - YYCache

前言 本篇用来记录下阅读YYKit中YYCache的一些理解和收获,着重解决两个问题: 1.YYCache在内存和磁盘各自存取方式. 2.YYCache使用怎样的数据结构来进行数据的存储.怎样确保多线程下的数据操作的安全性. 首先我们来看一下YYCache包含的文件.在本篇中我们并不像之前那样每个属性,每个方法都展示出来解释,主要还是针对问题. YYMemoryCache YYMemoryCache是存储键值对的快速内存缓存,区别于NSDictionary,其键是retain而非copy.它的A

iOS -- YYText富文本

NSMutableAttributedString *text = [[NSMutableAttributedString alloc] initWithString: [NSString stringWithFormat:@"%@", kRealName]]; [text setYy_color:kDarkColor]; NSMutableAttributedString *one = [[NSMutableAttributedString alloc] initWithString

YYKit笔记之FPS

FPS计算方法 FPS是Frame per second的缩写,即每秒的帧数.这一术语广泛的应用于计算机图形学,视频采集,游戏等. CADisplayLink CADisplayLink是一个能让我们以和屏幕刷新率相同的频率将内容画到屏幕上的定时器,创建一个新的 CADisplayLink 对象,把它添加到一个runloop中,并给它提供一个 target 和selector 在屏幕刷新的时候调用.一旦CADisplayLink已特定的模式注册到runloop滞后,每当屏幕需要刷新的时候,run

整理第三方类库

网络 AFNetworking:mattt大神的网络事件处理框架. XMPPFramework:XMPP,主要用于即时通讯. CocoaAsyncSocket:异步socket请求框架. Reachability:用来检查应用当前的网络连接状况,是苹果Reachability类的直接替代品,支持ARC,支持block,使用GCD方法来通知网络接口的变化. SocketRocket:WebSocket协议是一种网络协议,它的Web设计实现了浏览器与服务器的双向通讯.通过使用WebSockets,你

1.2iOS常用的开源库(一)

1. AFNetworking 在众多iOS开源项目中,AFNetworking可以称得上是最受开发者欢迎的库项目.AFNetworking是一个轻量级的iOS.Mac OS X网络通信类库,现在是GitHub上第三大Objective-C库.它建立在NSURLConnection.NSOperation等类库的基础上,让很多网络通信功能的实现变得十分简单,因此,许多iOS应用开发都会使用到它. 支持HTTP请求和基于REST的网络服务(包括GET.POST.PUT.DELETE等): 支持AR