RZRichTextView

导入工程

pod 'RZRichTextView'

需要使用的地方

#import <RZRichTextView/RZRichTextView.h>

• RZRichTextView 继承自UITextView

• 富文本编辑器，支持html与文本相互转换，支持的功能如下

  • 插入图片
  • 撤销
  • 恢复
  • 字体 （大小、颜色、背景色、粗体、斜体、描边）
  • 下划线
  • 删除线
  • 上标
  • 下标
  • 段落样式（对齐、缩进、间距）
  • 文字拉伸
  • 阴影
  • 链接（文字、图片）

插入图片到富文本之后，在转换成HTML标签之前，需要将图片上传至服务器得到URL，最后将URL替换图片之后，生成HTML标签

• 如果要对插入的图片进行处理，请实现

    // 全局的图片的处理
    RZRichTextConfigureManager.manager.rz_shouldInserImage = ^UIImage * _Nullable(UIImage * _Nullable image) {
        return image;
    }

** 如果开发者需要代码预填入内容，或将html标签解析成富文本重新写入到文本中，继续编辑，请参考RZColorful， **

UI 展示

工具条

image5.jpeg

段落样式设置

image1.jpeg

字体描边属性设置

image2.jpeg

多个链接时，编辑

image3.jpeg

链接的编辑

image4.jpeg

使用RZRichTextView文本框

/**
获取输入框中的所有图片

@return 按照图片插入顺序排列
*/
- (NSArray <UIImage *> *)rz_rictTextImages;

/**
将富文本内容转换成HTML标签语言 urls需与图片顺序、数量一致（倒叙方式插入，缺失可能导致图片顺序不准确）

@param urls 图片的链接，如果有图片，则请将图片先上传至自己的服务器中，得到地址。然后在转换成HTML时，urls图片顺序将与[- (NSArray <UIImage *> *)rz_rictTextImages]方法得到的图片顺序一致
@return HTML标签string。
*/
- (NSString *)rz_codingToHtmlWithImageURLS:(NSArray <NSString *> *)urls;

使用NSAttributedString

包含文件

#import <RZColorful/RZColorful.h> // #import <RZColorful/NSAttributedString+RZColorful.h> 

在NSAttributedString中

pragma mark - HTML 富文本互换

// 将html转换成 NSAttributedString
+ (NSAttributedString *)htmlString:(NSString *)html;

// 获取富文本中的图片 用于上传服务器
- (NSArray <UIImage *> *)rz_images;

/**
将富文本编码成html标签，如果有图片，用此方法

@param urls 图片的url，url需要先获取图片，然后自行上传到服务器，最后按照【- (NSArray <UIImage *> *)images;】此方法得到的图片顺序排列url
@return HTML标签
*/
- (NSString *)rz_codingToHtmlWithImagesURLSIfHad:(NSArray <NSString *> *)urls;

/**
将富文本完整的code成html标签，（此方法如果富文本中有图片，则图片将被丢失）  有图片时，请用[rz_codingToHtmlWithImagesURLSIfHad]方法

@return HTML标签语言
*/
- (NSString *)rz_codingToCompleteHtml;

自定义RZRichTextView的功能

• 富文本主要是对NSAttributedString的属性进行各式设置，然后和text合并起来，最后形成富文本

自定义 工具条

image5.jpeg

• 工具条是一个UICollectionView，所以要自定义功能，需要实现以下四个方法

  • 1.cell 注册

      // [RZRichTextConfigureManager manager]
      /** 自定义 注册的键盘上的工具条的cell */
      - (void)registerRZRichTextAttributeItemClass:(Class)classNa forAccessoryItemCellWithIdentifier:(NSString *)identifier;
  

  • 2.dataSouce

      // [RZRichTextConfigureManager manager]
      /** 键盘上的工具条功能数组，可新增、删除、交换顺序
      如果要添加自定义的功能，添加的RZRichTextAttributeType 请尽量从100以后添加，
      */
      @property (nonatomic, copy) NSMutableArray <RZRichTextAttributeItem *> *rz_attributeItems;
  

  • 3.cell的初始化

      // [RZRichTextConfigureManager manager]
      /** 根据item，可自定义键盘工具栏的功能cell 不需要自定义时，return nil; （在工具条刷新的时候会调用）*/
      @property (nonatomic, copy) UICollectionViewCell *(^cellForItemAtIndePath)(UICollectionView *collectionView, NSIndexPath *indexPath, RZRichTextAttributeItem *item);
  

  • 4.cell的点击事件

      // [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修改之后，需要

// RZRichTextView
/**
 刷新工具条的cell
 */
- (void)rz_reloadAttributeData;