iOS強大的屬性文本控件 - TYAttributedLabel
TYAttributedLabel v2.6
TYAttributedLabel 簡單，強大的屬性文本的控件(無需了解CoreText)，支持圖文混排顯示，支持添加鏈接，image和UIView控件，支持自定義排版顯示
更新:
詳細的使用請看LovePlayNews項目
使用autolayout 如果需要自動推斷高度，必須設置preferredMaxLayoutWidth
添加到CocoaPods
v2.6 新增寬度自適應isWidthToFit，空心字設置strokeWidth，段落間距paragraphSpacing
v2.5 把label的一些操作移動textContainer,label只負責draw了。
v2.4 修復imge放大bug，新增imageAlignment 和 autolayout支持，以及相應的demo，感謝xinzhengzhang，nonstriater
v2.3 新增 做題demo，代碼優化
v2.2 新增 TYImagecache類,新增 image URL 下載緩存，功能優化，改進
v2.1 添加 tableViewCell demo
v2.0 重構優化代碼，性能提升，穩定（已在項目中使用）, 分離出TYTextContainer ，可以提前生成，也可以生成attributedString，顯著提升cell滑動場景流暢度，可以和微博一樣流暢
v1.2 添加設置行數，修復bug，增強穩定性
v1.1 添加鏈接高亮效果，鏈接便利方法，長按手勢代理，優化代碼
CocoaPods
pod 'TYAttributedLabel', '~> 2.6.2'
ScreenShot
新-做題demo
weibo demo 使用TYAttributedLabel 截圖
Requirements
- Xcode 5 or higher
- Apple LLVM compiler
- iOS 6.0 or higher
- ARC
Features
- 支持屬性文本，圖文混排顯示，支持行間距 行間距 段落間距，設置行數，自適應高度，寬度
- 支持添加自定義文本屬性
- 支持添加屬性文本，自定義鏈接，新增高亮效果顯示（文字和背景）
- 支持添加UIImage和UIView控件
Demo
運行demo可以查看效果，而且在demo中，針對各種文本和圖文的實現都有詳細的用例，每個頭文件中都有詳細的用法注釋，這里簡單的介紹下用法
Usage
API Quickstart
- Category And Protocol
| Class | Function |
|---|---|
| NSMutableAttributedString (TY) | category提供便利color,font CharacterSpacing,UnderlineStyle,ParagraphStyle的屬性添加，無需了解復雜的CoreText |
| TYTextStorageProtocol | 自定義文本屬性 遵守最基本的協議 即可 addTextStorage 添加進去 |
| TYAppendTextStorageProtocol | 自定義文本屬性協議 遵守即可appendTextStorage 添加進去 |
| TYLinkStorageProtocol | 自定義文本鏈接屬性 繼承TYAppendTextStorageProtocol |
| TYDrawStorageProtocol | 自定義顯示內容協議 如 UIImage UIView |
下層協議繼承上層的協議，如果覺得復雜，其實我已經實現了常用的自定義屬性，拿來就可以用，或者繼承，添加你想要的
- Label And Storage
| Class | Function |
|---|---|
| TYAttributedLabel | 簡單易用的屬性文本,富文本的顯示控件, addTextStorage在已經設置文本的基礎上添加屬性，image或者view, appendTextStorage(無需事先設置文本)直接添加屬性，image或者view到最后 |
| TYTextContainer | 文本容器，可以提前生成，也可以生成attributedString，顯著提升cell滾動流暢度 |
| TYTextStorage | 自定義文本屬性,支持textColor,font,underLineStyle |
| TYLinkTextStorage | 自定義鏈接屬性，繼承TYTextStorage，支持點擊代理 |
| TYDrawStorage | 自定義顯示內容屬性，如UIImage，UIView，支持點擊代理 |
| TYImageStorage | 自定義圖片顯示，繼承TYDrawStorage |
| TYViewStorage | 自定義UIView控件，繼承TYDrawStorage |
| TYImageCache | image緩存類，支持URL請求 |
如果需要更加詳細的內容，請看各個頭文件，有詳細的注釋
Delegate
// 點擊代理
- (void)attributedLabel:(TYAttributedLabel *)attributedLabel textStorageClicked:(id<TYTextStorageProtocol>)textStorage atPoint:(CGPoint)point;
// 長按代理 有多個狀態 begin, changes, end 都會調用,所以需要判斷狀態
- (void)attributedLabel:(TYAttributedLabel )attributedLabel textStorageLongPressed:(id<TYTextStorageProtocol>)textStorage onState:(UIGestureRecognizerState)state atPoint:(CGPoint)point;</code></pre>
Examples
-
appendStorage demo
TYAttributedLabel
label = [[TYAttributedLabel alloc]init];
[self.view addSubview:label];
// 文字間隙
label.characterSpacing = 2;
// 文本行間隙
label.linesSpacing = 6;
NSString *text = @"\t總有一天你將破蛹而出，成長得比人們期待的還要美麗。\n";
[label appendText:text];
NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc]initWithString:text];
[attributedString addAttributeTextColor:[UIColor blueColor]];
[attributedString addAttributeFont:[UIFont systemFontOfSize:15]];
[label appendTextAttributedString:attributedString];
[label appendImageWithName:@"CYLoLi" size:CGSizeMake(CGRectGetWidth(label.frame), 180)];
UIImageView *imageView = [[UIImageView alloc]initWithImage:[UIImage imageNamed:@"CYLoLi"]];
imageView.frame = CGRectMake(0, 0, CGRectGetWidth(label.frame), 180);
[label appendView:imageView];
[label setFrameWithOrign:CGPointMake(0,0） Width:CGRectGetWidth(self.view.frame)];</code></pre>
-
addStorage demo
TYAttributedLabel *label = [[TYAttributedLabel alloc]initWithFrame:CGRectMake(0, 0, CGRectGetWidth(self.view.frame), 0)];
[self.view addSubview:label];
NSString *text = @"\t總有一天你將破蛹而出，成長得比人們期待的還要美麗。\n";
[label setText:text];
// 文字間隙
label.characterSpacing = 2;
// 文本行間隙
label.linesSpacing = 6;
textStorage = [[TYTextStorage alloc]init];
textStorage.range = [text rangeOfString:@"總有一天你將破蛹而出"];
textStorage.textColor = RGB(0, 155, 0, 1);
textStorage.font = [UIFont systemFontOfSize:18];
[label addTextStorage:textStorage];
[label addLinkWithLinkData:@"www.baidu.com" range:NSMakeRange(5, 8)];
[label addImageWithName:@"haha" range:NSMakeRange(2, 1)];
UIImageView *imageView = [[UIImageView alloc]initWithImage:[UIImage imageNamed:@"CYLoLi"]];
imageView.frame = CGRectMake(0, 0, CGRectGetWidth(label.frame), 180);
[label addView:imageView range:NSMakeRange(16, 1)];
[label sizeToFit];</code></pre>
-
TextContainer demo
NSString text = @"\t總有一天你將破蛹而出，成長得比人們期待的還要美麗。\n";
TYTextContainer textContainer = [[TYTextContainer alloc]init];
textContainer.text = text;
// 文字間隙
textContainer.characterSpacing = 2;
// 文本行間隙
textContainer.linesSpacing = 5;
textStorage = [[TYTextStorage alloc]init];
textStorage.range = [text rangeOfString:@"總有一天你將破蛹而出"];
textStorage.textColor = RGB(0, 155, 0, 1);
textStorage.font = [UIFont systemFontOfSize:18];
[textContainer addTextStorage:textStorage];
[textContainer addLinkWithLinkData:@"www.baidu.com" range:NSMakeRange(5, 8)];
[textContainer addImageWithName:@"haha" range:NSMakeRange(2, 1)];
UIImageView *imageView = [[UIImageView alloc]initWithImage:[UIImage imageNamed:@"CYLoLi"]];
imageView.frame = CGRectMake(0, 0, CGRectGetWidth(label.frame), 180);
[textContainer addView:imageView range:NSMakeRange(16, 1)];
// 生成 textContainer 文本容器
[textContainer createTextContainerWithTextWidth:CGRectGetWidth(self.view.frame)];
TYAttributedLabel *label = [[TYAttributedLabel alloc]init];
label.textContainer = textContainer;
// 也可以 生成NSAttributedString 屬性文本
//NSAttributedString *attString = [textContainer createAttributedString];
//label.attributedText = attString;
[label setFrameWithOrign:CGPointZero Width:CGRectGetWidth(self.view.frame)];
[self.view addSubView:label];</code></pre>
Contact
如果你發現bug，please pull reqeust me
如果你有更好的改進，please pull reqeust me