# RZRichTextView **Repository Path**: wangshunyang/RZRichTextView ## Basic Information - **Project Name**: RZRichTextView - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2020-12-17 - **Last Updated**: 2021-10-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # RZRichTextView ###### [更新日志](https://github.com/rztime/RZRichTextView/blob/master/UpdateLog.md) 导入工程 ```objc pod 'RZRichTextView' ``` 需要使用的地方 ```objc #import ``` * RZRichTextView 继承自UITextView * 富文本编辑器，支持html与文本相互转换，支持的功能如下 * 插入图片 * 撤销 * 恢复 * 字体 （大小、颜色、背景色、粗体、斜体、描边） * 下划线 * 删除线 * 上标 * 下标 * 段落样式（对齐、缩进、间距） * 文字拉伸 * 阴影 * 链接（文字、图片） ### 插入图片到富文本之后，在转换成HTML标签之前，需要将图片上传至服务器得到URL，最后将URL替换图片之后，生成HTML标签 #### 如果要保存草稿，暂不上传至服务器，则可以先将图片保存到本地沙盒，使用相对路径，再缓存，恢复时，替换还原html ``` // 保存草稿箱 NSAttributedString *attr = ... NSString *url = @"file://xxx/Documents/imageName.png"; NSString *html = [attr rz_codingToHtmlWithImagesURLSIfHad:@[url]]; // 缓存 html ``` ``` // 还原 NSString *html = ...; html = [html stringByReplacingOccurrencesOfString:@"xxx" withString:NSHomeDirectory()]; textLabel.attributedText = [NSAttributedString htmlString:html]; ``` * 如果要对插入的图片进行处理，请实现 ```objc // 全局的图片的处理 RZRichTextConfigureManager.manager.rz_shouldInserImage = ^UIImage * _Nullable(UIImage * _Nullable image) { return image; } ``` ### [** 如果开发者需要代码预填入内容，或将html标签解析成富文本重新写入到文本中，继续编辑，请参考RZColorful **](https://github.com/rztime/RZColorful)


所支持的工具条


段落样式设置


描边功能设置


多个链接时选择编辑


链接编辑

### 使用RZRichTextView文本框 ```objc /** 获取输入框中的所有图片 @return 按照图片插入顺序排列 */ - (NSArray *)rz_rictTextImages; ``` ```objc /** 将富文本内容转换成HTML标签语言 urls需与图片顺序、数量一致（倒叙方式插入，缺失可能导致图片顺序不准确） @param urls 图片的链接，如果有图片，则请将图片先上传至自己的服务器中，得到地址。然后在转换成HTML时，urls图片顺序将与[- (NSArray *)rz_rictTextImages]方法得到的图片顺序一致 @return HTML标签string。 */ - (NSString *)rz_codingToHtmlWithImageURLS:(NSArray *)urls; ``` ### NSAttributedString 与 html 互相转换 * 请参考 [RZColorful](https://github.com/rztime/RZColorful) [NSAttributedString+RZHtml.m](https://github.com/rztime/RZColorful/blob/master/RZColorfulExample/RZColorful/AttributeCore/NSAttributedString%2BRZHtml.m) ```objc - (NSString *)rz_codingToCompleteHtmlByWeb; ``` 系统方法转换时，会丢失部分属性，所以取巧，用这种方法来加上style，供借鉴和学习，如果有更好的方法，可以一起交流 在iOS 13中，Light/Dark模式适配 ```objc RZRichTextConfigureManager的overrideUserInterfaceStyle属性，默认跟随系统 UITextView的overrideUserInterfaceStyle，跟随RZRichTextConfigureManager的overrideUserInterfaceStyle的属性 [注意]： 如果设置 textView.overrideUserInterfaceStyle属性，将会修改RZRichTextConfigureManager的overrideUserInterfaceStyle， 所以在textView使用完成之后，按需要去还原RZRichTextConfigureManager的overrideUserInterfaceStyle的默认属性 ``` ### 使用NSAttributedString 包含文件 ```objc #import // #import ``` 在NSAttributedString中 #pragma mark - HTML 富文本互换 ```objc // 将html转换成 NSAttributedString + (NSAttributedString *)htmlString:(NSString *)html; ``` ```objc // 获取富文本中的图片 用于上传服务器 - (NSArray *)rz_images; ``` ```objc /** 将富文本编码成html标签，如果有图片，用此方法 @param urls 图片的url，url需要先获取图片，然后自行上传到服务器，最后按照【- (NSArray *)images;】此方法得到的图片顺序排列url @return HTML标签 */ - (NSString *)rz_codingToHtmlWithImagesURLSIfHad:(NSArray *)urls; ``` ```objc /** 将富文本完整的code成html标签，（此方法如果富文本中有图片，则图片将被丢失） 有图片时，请用[rz_codingToHtmlWithImagesURLSIfHad]方法 @return HTML标签语言 */ - (NSString *)rz_codingToCompleteHtml; ``` # 自定义RZRichTextView的功能 * 富文本主要是对NSAttributedString的属性进行各式设置，然后和text合并起来，最后形成富文本 #### 自定义 工具条

工具条

###### 工具条是一个UICollectionView，所以要自定义功能，需要实现以下四个方法 * 1.cell 注册 ``` objc // [RZRichTextConfigureManager manager] /** 自定义 注册的键盘上的工具条的cell */ - (void)registerRZRichTextAttributeItemClass:(Class)classNa forAccessoryItemCellWithIdentifier:(NSString *)identifier; ``` * 2.dataSouce ``` objc // [RZRichTextConfigureManager manager] /** 键盘上的工具条功能数组，可新增、删除、交换顺序 如果要添加自定义的功能，添加的RZRichTextAttributeType 请尽量从100以后添加， */ @property (nonatomic, copy) NSMutableArray *rz_attributeItems; ``` * 3.cell的初始化 ```objc // [RZRichTextConfigureManager manager] /** 根据item，可自定义键盘工具栏的功能cell 不需要自定义时，return nil; （在工具条刷新的时候会调用）*/ @property (nonatomic, copy) UICollectionViewCell *(^cellForItemAtIndePath)(UICollectionView *collectionView, NSIndexPath *indexPath, RZRichTextAttributeItem *item); ``` * 4.cell的点击事件 ```objc // [RZRichTextConfigureManager manager] /** 点击了某个功能， 需要自定义处理时，返回YES*/ @property (nonatomic, copy) BOOL(^didClickedCell)(RZRichTextView *textView, RZRichTextAttributeItem *item); ``` ##### 以上修改是针对全局的RZRichTextView的功能 #### 在配置了全局的RZRichTextView的功能，也可以在RZRichTextView初始化之后，单独对某一个RZRichTextView进行定制，RZRichTextView同样有2、3、4方法，当实现了之后，[RZRichTextConfigureManager manager]的2、3、4全局的自定义方法将以RZRichTextView为主 ### 自定义方法，是对[RZRichTextView rz_attributedDictionays]的字典里的内容的修改，所以如需自定义，请在4.cell的点击事件中进行处理 ### 完成rz_attributedDictionays修改之后，需要 ```objc // RZRichTextView /** 刷新工具条的cell */ - (void)rz_reloadAttributeData; ```