---

XRichText是一个可以显示 Html 富文本的 TextView。可以用于显示新闻、商品详情等场景。欢迎 star、fork，提出意见。

使用

• Github : XRichText

step1

在根项目的build.gradle文件中添加

allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
    }
}

step2

添加依赖

dependencies {
        compile 'com.github.limedroid:XRichText:v1.0.0'
}

特别说明:

可以直接调用 text 方法显示 html，其他的接口只是应对特殊场景的。

主要特性

• 自定义超链接 link 的点击
• 自定义图片 img 的点击
• 支持链式调用
• 图片支持三种对齐方式(左对齐、居中、右对齐)
• 支持在图片加载前对每张图片的 url、width、height、对齐方式精细调整
• 内置图片下载器
• 可自定义图片下载器，如使用 universal image loader、Picasso、Glide 等

实现原理

• spanned
• 线程池
• 自定义 ImageGetter

示例

<cn.droidlover.xrichtext.XRichText
            android:id="@+id/richText"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:padding="16dp" />

在 Java 中：

richText
                .callback(new XRichText.BaseClickCallback() {

                    @Override
                    public boolean onLinkClick(String url) {
                        showMsg(url);
                        return true;
                    }

                    @Override
                    public void onImageClick(List<String> urlList, int position) {
                        super.onImageClick(urlList, position);
                        showMsg("图片:" + position);
                    }

                    @Override
                    public void onFix(XRichText.ImageHolder holder) {
                        super.onFix(holder);
                        if (holder.getPosition() % 3 == 0) {
                            holder.setStyle(XRichText.Style.LEFT);
                        } else if (holder.getPosition() % 3 == 1) {
                            holder.setStyle(XRichText.Style.CENTER);
                        } else {
                            holder.setStyle(XRichText.Style.RIGHT);
                        }

                        //设置宽高
                        holder.setWidth(550);
                        holder.setHeight(400);
                    }
                })
               .imageDownloader(new ImageLoader() {
                   @Override
                   public Bitmap getBitmap(String url) throws IOException {
                        return UILKit.getLoader().loadImageSync(url);
                   }
               })
                .text(TEXT);

api 说明

• onLinkClick(String url) 当点击超链接时触发，url 为点击的 url
• onImageClick(List urlList, int position) 当点击图片时触发，urlList 为图片的 url 集合，position 为被点击的位置，从 0 开始
• onFix(XRichText.ImageHolder holder) 当图片加载前回调此方法，通过 holder 可以调整图片的 src、width、height、style(对齐方式)
• 设置 html 内容时，务必调用 text 方法
• imageDownloader(ImageLoader loader)可以自定义图片加载器,库中已有默认实现。可以根据项目情况定义加载器，如三方库 UIL、Picasso 等，只需实现 ImageLoader 接口就行。getBitmap 方法已经在线程池中，所以自定义 loader 时不必考虑线程问题.
• ClickCallback 接口有默认实现类 BaseClickCallback,可以直接使用此类重写需要的方法。

我的另一个项目: XDroid ， 一个轻量级的 Android 快速开发框架