iOS - YYKit 之 YYText

本文只是让自己加深下理解,方便以后查看,原作者看到有不合适的地方,或者大神们看到有不对的地方希望指正 ~

原文地址,尊重原作者 ~

<br />

一. 特点和用法

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

二. 使用到的组件

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

  2. 定义的一些Enum
    YYTextAttributeType: attribute的类型,有NoneUIKitCoreTextYYText四种类型;
    YYTextLineStyleline的样式;
    YYTextVerticalAlignment: 垂直方向text的位置;
    YYTextDirectiontext的位置;
    YYTextTruncationTypetext截断的位置。

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

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

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

  6. YYTextShadow:用处和NSShadow一样,只是比NSShadow多了一些功能,比如说可以使用blendMode(图形混合模式)、可以在shadow上再加一层shadow。关于blendMode的学习,可以参见喵神的博客

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

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

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

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

  11. 再来说一下NSAttributedString+YYText文件
    在这个分类中主要是实现了几类的操作:

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

  13. YYText创建attachment的方法

  14. YYText添加YYText特有的attribute的方法

  15. 添加像设置属性一样的设置character attribute的fontcolorbackgroundColor等等的方法

  16. 添加像设置属性一样的设置paragraph attribute的方法。

  17. 添加像设置属性一样的设置YYText attribute的方法。

  18. 使用range设置不连续的attribute的方法

  19. 设置text highlight的便捷方法

  20. 和其他的工具型的方法。

  21. NSParagraphStyle+YYText文件
    提供了CoreText中的CTParagraphStyleRefNSParagraphStyle之间的转化

  22. YYTextParser
    这是一个protocol,声明了一个-(BOOL)parseText:(NSMutableAttributedString *)string selectedRange:(NSRangePointer)selectedRange;方法。这个方式是遵守这个协议必须实现的方法,当YYTextView或者YYLabel中的text改变时被调用。返回YES说明修改了这个text
    作者简单的实现了MarkdownParserEmotionParser,两个原理都差不多一样,在这里只对EmotionParser做一下简单的介绍,希望能有所启发:


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

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

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

5.YYTextLayout

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


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

  1. YYTextContainer
    支持矩形(CGSize)和图形(UIBezierPath)来初始化YYTextContainer;
    在这里重点说一下YYTextLinePositionModifier,它是 一个协议,定义了一个必须实现的方法,这个方法将会在layout完成的时候被调用,三个参数分别是存放YYTextLine的数组、完整的textlayout container
    YYTextLine:它是封装了CTLineRef的对象,封装了每一行text的具体展示位置、range、这一行拥有的attachments等等,只有一个类方法的初始化方法。如果不了解一些自行描述集的内容,对textLine中的一些属性和操作会不是很清晰,看下图:


    边框(Bounding Box):一个假想的边框,尽可能地容纳整个字形。
    基线(Baseline):一条假想的参照线,以此为基础进行字形的渲染。一般来说是一条横线。
    基础原点(Origin):基线上最左侧的点。
    行间距(Leading):行与行之间的间距。
    字间距(Kerning):字与字之间的距离,为了排版的美观,并不是所有的字形之间的距离都是一致的,但是这个基本步影响到我们的文字排版。
    上行高度(Ascent)和下行高度(Decent):一个字形最高点和最低点到基线的距离,所以行高就是ascent + decent
    看完上面的简单介绍你就能明白,在YYTextLinesetCTLine中的代码逻辑是从CTLineRef中取出对应的行宽、上行高度、下行高度、行间距、rangge和第一个字型符的位置(这个在垂直布局会用到)。之后调用reloadBounds方法,重新计算当前行的boundsattachments所在的rangerect
  2. YYTextLayout
    这个真的是核心内容了,这个文件一共3300多行的代码,从代码量上就能看出它的地位。这个类中存储着 textlayout结果,所有的property都是readonly的。实现的接口有:
    1、通过一些类方法初始化的方法(YYTextContainerCGSizetext
    2、layout之后的attributes,都是只读的
    3、从layout中读取信息(位置、range等等)
    4、绘制text layout
    这个类主要是使用上面讲过的所有的数据来绘制text,这部分的代码还是需要一点一点的去读的,如果是新手每一行都会有收获(比如说我),如果是老司机就没有必要一行行的读了,了解他的解题思路和解决这个问题的办法就可以。下面说一下生成layout的那个500行代码的情况,就按照代码的顺序从上往下大概的说明一下干了什么。
* 1)、初始化一系列使用到的变量

2)、安全判断,textcontainer
3)、判断是否需要修复emoji的bug(iOS8.3中)
4)、判断是否设置了path属性和exclusionPaths数组,做相应的计算拿到CGPath,如果CGPath为空则goto fail 返回nil(如果设置了pathsizeinsets就没有用了)
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是在YYAsyncLayerbackground queue渲染是调用的对象,它有三个回调,一个willDisplay在渲染之前、一个didDisplay在渲染之后和渲染时被调用的display

YYAsyncLayerCAlayer的子类,当这个layer更新contents时就会调用delegate方法去调用async display taskbackground 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的对照图:


看详细的分析请点这里

收获到的小知识点

  1. iOS7 and later,UIFontCTFontReftoll-free bridged的,在iOS6,UIFont是对CTFontRref的封装,所以在CoreText中是可以使用UIFont的,但是在UILabelUITextView中不能使用CTFontRef。
  2. NSParagraphStype不是toll-free bridged 到CTParagraphStypeRefCoreText可以同时使用两者,但UILabelUITextView只能使用NSParagraphStyle
  3. 查看.a静态文件支持哪种iOS处理器
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容

  • YYKit之YYText 转载链接: http://www.cnblogs.com/lujianwenance/p...
    kakukeme阅读 4,552评论 3 51
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,043评论 25 707
  • 内容来自于 iOS文档中 About Text Handling in iOS 部分 ios平台提供了显示及编辑文...
    纵横而乐阅读 6,700评论 2 21
  • 练习新闻听力不能着急,用心去体会单词
    班克西阅读 139评论 0 0
  • 爸 妈 我近视了 一副又一副眼镜 太阳穴被压得不行 你们给我指的路还是看不清 好几次我摘下眼镜 就像个瞎子 无法前行
    小年糕菌阅读 131评论 0 0