ZZAttributedMarkup


前言
ZZAttributedMarkup是以WPAttributedMarkup为原本。因为原作者没有更新了,而我觉得这是个很好用的超小型的文字排版(CoreText)开源代码。本人只是修复了bug,整合了代码,会不断更新。我只是重新造轮子。尊重原作者,若侵即删。

[TOC]

ZZAttributedMarkup 是什么、能做什么。

关于文字排版的有很多开源代码,其实现的主要功能是高度自定义字体样式,插入图片,添加点击事件等。如:OHAttribtuedLabel、DTCoreText、Nimbus、M80AttributedLabel、WXLabel等。有一些开源Label大致实现方法是:继承UIView(并非直接继承UILabel)创建一个子类,为其添加text、font、textColor、shadow、textAlignment、lineBreakMode等属性,然后在- (void)drawRect:(CGRect)rect;方法中使用CoreText和CoreGraphics,根据设置的属性要求将文本绘制出来。优点:极大化的自定义Label,灵活功能强大。缺点:不能再使用UILabel的计算文本高度,需要手写计算方法,不能根据文本内容进行autolayout布局。总的来说就是:可能会影响某些布局,不能再使用UILabel系统提供的好方法。

ZZAttributedMarkup是一个简单而实用的category,你可以很方便的来用它来创建富文本,通过标签的方式设置属性字典。(类似HTML中标签中的内容、css定义的样式。)

// 定义样式
    

// 展现内容
    这段字是红色的

详解与举例

demo中的类

  • NSString+AttributedMarkup (category,自定义字体样式,插入图片)
  • ClickEventLabel (继承UILabel,添加点击事件)

举个栗子

    NSDictionary *style1 = @{
                             @"body":@[[UIFont systemFontOfSize:18],[UIColor grayColor]],
                             @"bold":[UIFont boldSystemFontOfSize:22],
                             @"red": [UIColor redColor]
                             };
                             
    NSString *text1 = @"一段普通 字体 颜色 富文本";
    
    _label1.attributedText = [text1 attributedStringWithStyleBook:style1];

ZZAttributedMarkup_第1张图片
一段普通富文本

在这个例子中,与@"bold"关联的样式应用于标记的文本中包含的文本(大一点的粗体)。与@"red"关联的样式应用于标记的文本中包含的文本(字设置为红色)。与@"body"关联的样式被应用于整个文本。(没错,如果有设置@"body"样式,默认会修饰全部内容)。
NSDictionary *style1;这个字典叫做style book里面包含了文本的字体、颜色等(NSAttributedString)属性诸如此类的设置。以下的这些属性可以被设置到属性字典当中:

  • UIColor - 给文本设置颜色

    @"red" : [UIColor redColor]
    
  • UIFont - 给文本设置字体

    @"bold" : [UIFont boldSystemFontOfSize:22]
    
  • UIImage - 插入图片到文本在文本段。注释:图像标签内的文本必须包含一个单独的字符,这将被图像替换。 (详解代码见demo)

    @"thumb":[UIImage imageNamed:@"thumbIcon"]
    
     
    
  • NSDictionary - (传统方法)根据键值对给文本设置属性.这个可以用来设置(NSAttributedString中)下划线、中划线、段落样式等。设置样式的字典,元素是由小样式组成。

    @"line" : @{
                NSUnderlineStyleAttributeName : @(NSUnderlineStyleSingle | NSUnderlinePatternSolid),
                NSFontAttributeName : [UIFont systemFontOfSize:18]
            }
    
  • NSArray - 设置样式的数组,元素是由小样式组成。

    @"body" : @[
                [UIFont systemFontOfSize:18],
                [UIColor grayColor]
                ],
    
  • AttributedMarkupAction - (存储Action block的类) 给文本添加了超链接属性 (添加点击事件)
     @"help":[AttributedMarkupAction styledActionWithAction:^{
                                              NSLog(@"Help Action");
                                              }],
    
  • 常量标签

    1. bold - 默认会修饰全部内容

    @"bold" : [UIFont boldSystemFontOfSize:22]
    修饰全部内容
    

    2. link - 默认会修饰添加了超链接属性的内容

    @"link" : [UIColor orangeColor]
    修饰点击事件内容
    

运行截图

ZZAttributedMarkup_第2张图片
ZZAttributedMarkup Simulator Screen Shot

你可能感兴趣的:(ZZAttributedMarkup)