使用方法
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.from(text).bind(activity).into(textView);
// activity onDestory时
RichText.clear(activity);
注意
在第一次调用RichText之前:
@1. 先调用RichText.initCacheDir()方法设置缓存目录.
@2. ImageFixCallback的回调方法不一定是在主线程回调
@3. 注意不要进行UI操作
@4. 本地图片由根路径\开头,Assets目录图片由file:///android_asset/开头
@5. Gif图片播放不支持硬件加速,若要使用Gif图片请先关闭TextView的硬件加速
textView.setLayerType(View.LAYER_TYPE_SOFTWARE, null);
导入库
implementation 'com.zzhoujay.richtext:richtext:3.0.7'
布局
<android.support.v4.widget.NestedScrollView
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:layout_constraintLeft_toLeftOf="parent"
app:layout_constraintRight_toRightOf="parent"
app:layout_constraintTop_toBottomOf="@+id/toolbar">
<TextView
android:id="@+id/tv_headline_content"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginLeft="15dp"
android:layout_marginRight="15dp"
android:layout_marginTop="15dp"
android:lineSpacingExtra="4dp"
android:textIsSelectable="true" />
</android.support.v4.widget.NestedScrollView>
代码块
private void init() {
mToolbar = findViewById(R.id.toolbar);
setSupportActionBar(mToolbar);
if (getSupportActionBar() != null) getSupportActionBar()
.setDisplayShowTitleEnabled(false);
ActivityUtils.addToolbarTitle(this, mToolbar, "田园头条");
mToolbar.setNavigationOnClickListener(view -> onBackPressed());
//在第一次调用RichText之前先调用RichText.initCacheDir()方法设置缓存目录,不设置会报错
RichText.initCacheDir(this);
//这里是取后台返回的集合数据
headLineArticleList = getIntent().getParcelableArrayListExtra(EXTRA_TYPE_ARTICLE);
mTvHeadlineContent = findViewById(R.id.tv_headline_content);
for (int i = 0; i < headLineArticleList.size(); i++) {
Article article = headLineArticleList.get(i);
String textContent = article.getContent();//获取一个字符串的文本内容
}
RichText.from(textContent).bind(this)
.showBorder(false)
.size(ImageHolder.MATCH_PARENT, ImageHolder.WRAP_CONTENT)
.into(mTvHeadlineContent);
}
@Override
protected void onDestroy() {
super.onDestroy();
//结束时清空内容
RichText.clear(this);
}