lele8446 / cjlabel

A drop-in replacement for UILabel that supports NSAttributedString, rich text, display any view, links, select copy and more

CJLabel

CJLabel继承自UILabel，在支持UILabel所有属性的基础上，还提供富文本、图文混排、任意view插入展示、自定义点击链点设置、长按（双击）唤起UIMenuController选择复制文本等功能。

特性简介

1. 禁止使用-init初始化！！
2. enableCopy 长按或双击可唤起UIMenuController进行选择、全选、复制文本操作
3. attributedText 与 text 均可设置富文本
4. 不支持NSAttachmentAttributeName，NSTextAttachment！！
   显示图片请调用:
   + initWithView:viewSize:lineAlignment:configure:或者
   + insertViewAtAttrString:view:viewSize:atIndex:lineAlignment:configure:方法初始化NSAttributedString后显示
5. extendsLinkTouchArea设置是否扩大链点点击识别范围
6. shadowRadius设置文本阴影模糊半径
7. textInsets 设置文本内边距
8. verticalAlignment 设置垂直方向的文本对齐方式。注意与显示图片时候的imagelineAlignment作区分，self.verticalAlignment对应的是整体文本在垂直方向的对齐方式，而imagelineAlignment只对图片所在行的垂直对齐方式有效
9. delegate 点击链点代理
10. attributedTruncationToken自定义截断字符，默认"...",只针对self.lineBreakMode的以下三种值有效，假如attributedTruncationToken=***，则：
    NSLineBreakByTruncatingHead, // 头部截断: "***wxyz"
NSLineBreakByTruncatingTail, // 中间截断: "abcd***"
NSLineBreakByTruncatingMiddle // 尾部截断: "ab***yz"
11. kCJBackgroundFillColorAttributeName 背景填充颜色，属性优先级低于NSBackgroundColorAttributeName如果设置NSBackgroundColorAttributeName会忽略kCJBackgroundFillColorAttributeName的设置
12. kCJBackgroundStrokeColorAttributeName 背景边框线颜色
13. kCJBackgroundLineWidthAttributeName 背景边框线宽度
14. kCJBackgroundLineCornerRadiusAttributeName 背景边框线圆角弧度
15. kCJActiveBackgroundFillColorAttributeName 点击时候的背景填充颜色属性优先级同 kCJBackgroundFillColorAttributeName
16. kCJActiveBackgroundStrokeColorAttributeName 点击时候的背景边框线颜色
17. 支持添加自定义样式、可点击（长按）的文本点击链点
18. 支持 Interface Builder

CJLabel 已知 Bug

numberOfLines大于0且小于实际label.numberOfLines，同时verticalAlignment不等于CJContentVerticalAlignmentTop时，文本显示位置有偏差。如下图所示:

CJLabel引用

1. 直接导入

下载demo，将CJLabel文件夹导入项目，引用头文件 #import "CJLabel.h"

2. CocoaPods安装

pod 'CJLabel'

用法

• 根据NSAttributedString计算CJLabel的size大小

CGSize size = [CJLabel sizeWithAttributedString:str withConstraints:CGSizeMake(320, CGFLOAT_MAX) limitedToNumberOfLines:0];

• 指定内边距以及限定行数计算CJLabel的size大小

CGSize size = [CJLabel sizeWithAttributedString:str withConstraints:CGSizeMake(320, CGFLOAT_MAX) limitedToNumberOfLines:0 textInsets:3];

• 设置富文本展示

//初始化配置
CJLabelConfigure *configure = [CJLabel configureAttributes:nil isLink:NO activeLinkAttributes:nil parameter:nil clickLinkBlock:nil longPressBlock:nil];
//设置配置属性
configure.attributes = @{NSFontAttributeName:[UIFont boldSystemFontOfSize:18]};
//设置指定字符属性
attStr = [CJLabel configureAttrString:attStr withString:@"不同字体" sameStringEnable:NO configure:configure];
NSRange imgRange = [attStr.string rangeOfString:@"插入图片"];
//移除指定属性
[configure removeAttributesForKey:kCJBackgroundStrokeColorAttributeName];
//指定位置插入图片
UIImageView *imgView = [[UIImageView alloc]initWithImage:[UIImage imageNamed:@"CJLabel.png"]];
imgView.contentMode = UIViewContentModeScaleAspectFill;
imgView.clipsToBounds = YES;
attStr = [CJLabel insertViewAtAttrString:attStr view:imgView viewSize:CGSizeMake(55, 45) atIndex:(imgRange.location+imgRange.length) lineAlignment:CJVerticalAlignmentBottom configure:configure];
//设置内边距
self.label.textInsets = UIEdgeInsetsMake(10, 10, 10, 0);
self.label.attributedText = attStr;

• 垂直对齐、选择复制

//设置垂直对齐方式
self.label.verticalAlignment = CJVerticalAlignmentCenter;
self.label.text = self.attStr;
//支持选择复制
self.label.enableCopy = YES;

• 设置文字、图片点击链点

//设置点击链点属性
configure.attributes = @{NSForegroundColorAttributeName:[UIColor blueColor]};
//设置点击高亮属性
configure.activeLinkAttributes = @{NSForegroundColorAttributeName:[UIColor redColor]};
//链点自定义参数
configure.parameter = @"参数为字符串";
//点击回调（也可通过设置self.label.delegate = self代理，返回点击回调事件）
configure.clickLinkBlock = ^(CJLabelLinkModel *linkModel) {
   //do something
};
//长按回调
configure.longPressBlock = ^(CJLabelLinkModel *linkModel) {
   //do something
};
//设置为可点击链点
configure.isLink = YES;
//设置点击链点
attStr = [CJLabel configureAttrString:attStr
                           withString:@"CJLabel"
                     sameStringEnable:YES
                            configure:configure];
//设置图片点击链点属性
NSRange imageRange = [attStr.string rangeOfString:@"图片"];
CJLabelConfigure *imgConfigure =
[CJLabel configureAttributes:@{kCJBackgroundStrokeColorAttributeName:[UIColor redColor]}
                      isLink:YES
         activeLinkAttributes:@{kCJActiveBackgroundStrokeColorAttributeName:[UIColor lightGrayColor]}
                    parameter:@"图片参数"
               clickLinkBlock:^(CJLabelLinkModel *linkModel){
                   [self clickLink:linkModel isImage:YES];
               }
               longPressBlock:^(CJLabelLinkModel *linkModel){
                   [self clicklongPressLink:linkModel isImage:YES];
               }];
attStr = [CJLabel insertViewAtAttrString:attStr view:@"CJLabel.png" viewSize:CGSizeMake(45, 35) atIndex:(imageRange.location+imageRange.length) lineAlignment:verticalAlignment configure:imgConfigure];
self.label.attributedText = attStr;
//支持选择复制
self.label.enableCopy = YES;

• 自定义截断文本，并设置为可点击

//配置链点属性
configure.isLink = YES;
configure.clickLinkBlock = ^(CJLabelLinkModel *linkModel) {
    //点击 `……全文`
    [self clickTruncationToken:linkModel];
};
configure.attributes = @{NSForegroundColorAttributeName:[UIColor blueColor],NSFontAttributeName:[UIFont systemFontOfSize:13]};
//自定义截断字符为："……全文"
NSAttributedString *truncationToken = [CJLabel initWithAttributedString:[[NSAttributedString alloc]initWithString:@"……全文"] strIdentifier:@"TruncationToken" configure:configure];
//设置行尾截断
self.label.lineBreakMode = NSLineBreakByTruncatingTail;
self.label.attributedTruncationToken = truncationToken;
//设置点击链点
attStr = [CJLabel configureAttrString:attStr withAttributedString:truncationToken strIdentifier:@"TruncationToken" sameStringEnable:NO configure:configure];            
self.label.attributedText = attStr;
//支持选择复制
self.label.enableCopy = YES;

版本说明

• V4.7.0
  新增不可换行标签功能，优化图文混排展示

• V4.6.0
  支持显示任意view

• V4.5.0 V4.5.1 V4.5.3
  增加attributedTruncationToken属性，支持自定义截断字符；增加kCJStrikethroughStyleAttributeName、kCJStrikethroughColorAttributeName属性，可对指定文本添加删除线

• V4.4.0
  优化NSAttributedString链点属性设置

• V4.0.0
  新增enableCopy属性，支持选择、全选、复制功能，类似UITextView的选择复制效果。

• V3.0.0
  优化富文本配置方法，新增CJLabelConfigure类，简化方法调用，增加对NSAttributedString点击链点的判断（比如对于两个重名用户：@lele 和 @lele，可以分别设置不同的点击响应事件）
  注意 V3.0.0 版本引入CJLabelConfigure类，优化了NSAttributedString的设置，旧的配置API不再支持。相关调用请参照以下相关方法
  + initWithImage:imageSize:imagelineAlignment:configure:
+ initWithString:configure:
+ initWithAttributedString:strIdentifier:configure:
  

• V2.1.2
  可修改图片所在行在垂直方向的对齐方式（只针对当前行），有居上、居中、居下选项，默认居下

• V2.1.1
  修复单行文字时候点击链点的判断，增加delegate

• V2.0.0
  优化点击链点响应判断，增加插入图片、插入图片链点、点击链点背景色填充、点击链点边框线描边等功能 v2.0.0之后版本与v1.x.x版本差别较大，基本上重写了增加以及移除点击链点的API

• V1.0.2
  点击链点增加扩展属性parameter

• V1.0.1
  增加文本中内容相同的链点能够响应点击属性sameLinkEnable，必须在设置self.attributedText前赋值，默认值为NO，只取文本中首次出现的链点。

• V1.0.0
  支持链点点击响应

许可证

CJLabel 使用 MIT 许可证，详情见 LICENSE 文件。

更多

深入理解 iOS 图文混排原理并自定义图文控件 CJLabel富文本三 —— UILabel支持选择复制以及实现原理

cjlabel's Issues

ffc

设置了textInsets，CJSelectTextRangeView没有贴合文本问题

CJSelectTextRangeView应该不包括设置的textInsets区域

能否做一个只有长按选择复制的UIlabel扩展?

现有bug: numberOfLines大于0且小于实际label.numberOfLines，同时verticalAlignment不等于CJContentVerticalAlignmentTop时，文本显示位置有偏差

您的这个三方库这个问题太致命了, 会导致布局紊乱. 我这边只需要您的库的选择复制功能.

嗨，如果传入的图片支持网络地址就好了

有时候文本会展示不全，会显示...

如果是fffffffffff这样的文本或者是office之类的就会显示....

因为添加空白占位符，导致高度计算不对，尤其是在10个汉字的时候

不知道基于什么考虑，添加了这些代码
unichar spacingChar = 0xFFFC;
NSString *spacingCharString = [NSString stringWithCharacters:&spacingChar length:1];
//空白占位符
NSAttributedString *placeholderStr = [[NSAttributedString alloc]initWithString:spacingCharString];
[str appendAttributedString:placeholderStr];

选择复制文本的时候，全选或部分选中区域有时候会不太对，请问怎么解决呢？

可否像微信一样，长按的时候，直接选择全部？

如题，可以新增一个配置项来控制。

点击图片怎么获取

你好: 我在文本后面用NSTextAttachment 添加了图片,想要获取图片点击事件 怎么处理 ? 谢谢

请问怎么才能支持NSAttachmentAttributeName，NSTextAttachment

因为需要展示自己设计的系统表情类图片，需要将图片放在imageView上转换成Attachment展示

点击图片之后，闪一下图片就变不显示了，点按在图片位置会显示出来

点击图片之后，闪一下图片就变不显示了，点按在图片位置会显示出来

当键盘弹出，长按文本，不会显示menuVC

其实就是键盘和UIMenuController的并存问题：
1.需要增加一个自定义的TextView,支持设置nextResponder
2.CJLabel需要增加一个长按的回调或者通知，让业务层去监听当前谁即将成为Responder， 业务层去设置TextView的nextResponder
3.自定义的TextView需要监听UIMenuController的生命周期，取消nextResponder

bug 有点多啊 masonry不支持？

cell 有多个控件的话 frame masonry 都不好使

报错

pod下来后- (void)touchesCancelled:(nullable NSSet<UITouch *> *)touches withEvent:(nullable UIEvent *)event报错

在tableview cell中，设置两种labeltext颜色，显示会乱

选择复制的时候，光标向左偏移了。

如题，控件是先初始化，之后再设置frame的。

不同CTRun的下滑线对齐

一个CTLine里面，不同CTRun，它们的下划线没有处在同一水平线上，如何调整

这个控件没办法添加中划线

这个控件没办法添加中划线，有解决办法吗？

每次给lable重新复制的时候显示不正确 或 闪退

每次给lable重新复制的时候显示不正确 或 闪退

编译报错

CJLabelConfigure.h中 CTLineRef lastVisibleLine = CFArrayGetValueAtIndex(lines, lastVisibleLineIndex); 报错提示：Cannot initialize a variable of type 'CTLineRef' (aka 'const __CTLine *') with an rvalue of type 'const void *'

NSMutableParagraphStyle，行间距设置

NSMutableParagraphStyle行间距设置，没有效果

代码如下
NSMutableParagraphStyle *paragraphStyleLineS = [[NSMutableParagraphStyle alloc] init];
paragraphStyleLineS.lineSpacing = 2.0; // 设置行间距

[attributes setValue:paragraphStyleLineS forKey:NSParagraphStyleAttributeName];

configure.attributes = attributes;

只有一行的情况下点击事件无效,convertRectFromLoc不应该减去rect.size.height

如题

hi

当 文本是中文英文，数字的时候字体大小不一样阿

Emoji表情，多行时，无法显示全部内容

Hello,我这边出现，在iOS 9、10系统，emoji表情显示不会填充满Label，导致内容无法全部显示
多行时，内容会提前换行，每行，Label的宽度足以再放入一个emoji表情，但是却直接换行了，导致计算出来的高度，与实际展示需要的高度不一致，

为什么CJLabel只有添加到self.view上block回调才能监听到点击事件，加在自己写的子view上就获取不到点击事件？

@Jacquesless 看下你自定义view是否userInteractionEnabled=NO了，或者有其他忽略点击的设置