Android中富文本RichText框架使用

最新推荐文章于 2024-10-16 09:11:10 发布

Android涛

最新推荐文章于 2024-10-16 09:11:10 发布

阅读量7.7k

点赞数 3

分类专栏：框架文章标签： RichText 富文本

本文链接：https://blog.youkuaiyun.com/qq_40441190/article/details/82734875

版权

框架专栏收录该内容

12 篇文章

订阅专栏

本文详细介绍了RichText库的使用方法，包括如何设置缓存目录、配置数据源类型及格式、高级定制选项等内容，并提供了从依赖引入到资源释放的完整流程。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

详细介绍看GitHub：https://github.com/zzhoujay/RichText

注意

在第一次调用RichText之前先调用RichText.initCacheDir()方法设置缓存目录

ImageFixCallback的回调方法不一定是在主线程回调，注意不要进行UI操作

本地图片由根路径\开头，Assets目录图片由file:///android_asset/开头

Gif图片播放不支持硬件加速，若要使用Gif图片请先关闭TextView的硬件加速

textView.setLayerType(View.LAYER_TYPE_SOFTWARE, null);

第一步：填加依赖。

implementation 'com.zzhoujay.richtext:richtext:2.5.1'

第二步：使用方式。

1.基本使用

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

2.设置数据源类型

2.1 直接设置

// 设置为Html
RichText.fromHtml(text).into(textView);

// 设置为Markdown
RichText.fromMarkdown(text).into(textView);

2.2 使用type方法设置

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

3.高级使用

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

第三步：释放资源。

必要时可调用RichText对象的clear方法释放资源，但很多情况不需要这样做，只需要在应用退出时调用RichText.recycle()

// 加载富文本
RichText.from(text).bind(activity).into(textView);

// activity onDestory时
RichText.clear(activity);