富文本解析器RichText使用心得

RichText

Android平台下的富文本解析器

• 流式操作
• 低侵入性
• 支持Html和Markdown格式文本
• 支持图片点击和长按事件
• 链接点击事件和长按事件
• 支持设置加载中和加载错误时的图片
• 支持自定义超链接的点击回调
• 支持修正图片宽高
• 支持GIF图片
• 支持Base64编码
• 自持自定义图片加载器

• 支持内存和磁盘双缓存

 

gradle中引用的方法

implementation 'com.zzhoujay.richtext:richtext:3.0.8'

MyApplication extends Application 中加入

RichText.initCacheDir(this);
RichText.debugMode = true;

基本使用

RichText.from(text).into(textView);

设置数据源类型

直接设置

1. // 设置为Html
2. RichText.fromHtml(text).into(textView);
3.  
4. // 设置为Markdown
5. RichText.fromMarkdown(text).into(textView);

使用type方法设置

RichText.from(text).type(RichText.TYPE_MARKDOWN).into(textView);

高级

1. RichText
2. .from(text) // 数据源
3. .type(RichText.TYPE_MARKDOWN) // 数据格式,不设置默认是Html,使用fromMarkdown的默认是Markdown格式
4. .autoFix(true) // 是否自动修复，默认true
5. .autoPlay(true) // gif图片是否自动播放
6. .showBorder(true) // 是否显示图片边框
7. .borderColor(Color.RED) // 图片边框颜色
8. .borderSize(10) // 边框尺寸
9. .borderRadius(50) // 图片边框圆角弧度
10. .scaleType(ImageHolder.ScaleType.FIT_CENTER) // 图片缩放方式
11. .size(ImageHolder.MATCH_PARENT, ImageHolder.WRAP_CONTENT) // 图片占位区域的宽高
12. .fix(imageFixCallback) // 设置自定义修复图片宽高
13. .fixLink(linkFixCallback) // 设置链接自定义回调
14. .noImage(true) // 不显示并且不加载图片
15. .resetSize(false) // 默认false，是否忽略img标签中的宽高尺寸（只在img标签中存在宽高时才有效），true：忽略标签中的尺寸并触发SIZE_READY回调，false：使用img标签中的宽高尺寸，不触发SIZE_READY回调
16. .clickable(true) // 是否可点击，默认只有设置了点击监听才可点击
17. .imageClick(onImageClickListener) // 设置图片点击回调
18. .imageLongClick(onImageLongClickListener) // 设置图片长按回调
19. .urlClick(onURLClickListener) // 设置链接点击回调
20. .urlLongClick(onUrlLongClickListener) // 设置链接长按回调
21. .placeHolder(placeHolder) // 设置加载中显示的占位图
22. .error(errorImage) // 设置加载失败的错误图
23. .cache(Cache.ALL) // 缓存类型，默认为Cache.ALL（缓存图片和图片大小信息和文本样式信息）
24. .imageGetter(yourImageGetter) // 设置图片加载器，默认为DefaultImageGetter，使用okhttp实现
25. .bind(tag) // 绑定richText对象到某个object上，方便后面的清理
26. .done(callback) // 解析完成回调
27. .into(textView); // 设置目标TextView

释放资源

必要时可调用RichText对象的clear方法释放资源，但很多情况不需要这样做

1. // 加载富文本
2. RichText.from(text).bind(activity).into(textView);
3.  
4. // activity onDestory时
5. RichText.clear(activity);

在应用退出时调用RichText.recycle()