【亲测免费】 HtmlTextView 使用教程

项目介绍

HtmlTextView 是一个扩展的 Android TextView 组件，能够加载非常简单的 HTML 内容。该项目基于 Apache-2.0 许可证，最新版本为 4.0。由于项目已停止维护，鼓励开发者 fork 并继续维护。

项目快速启动

添加依赖

首先，在您的 build.gradle 文件中添加以下依赖：

repositories {
    jcenter()
}

dependencies {
    implementation 'org.sufficientlysecure:html-textview:4.0'
}

在布局文件中使用

在您的布局文件中添加 HtmlTextView：

<org.sufficientlysecure.htmltextview.HtmlTextView
    android:id="@+id/html_text"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:textAppearance="@android:style/TextAppearance.Small" />

在代码中设置 HTML 内容

在您的 Activity 或 Fragment 中，找到 HtmlTextView 并设置 HTML 内容：

HtmlTextView htmlTextView = (HtmlTextView) findViewById(R.id.html_text);
htmlTextView.setHtml("<h2>Hello World!</h2><p>This is a <b>bold</b> text.</p>");

应用案例和最佳实践

显示富文本内容

HtmlTextView 可以用于显示包含格式化文本和图片的富文本内容。例如，您可以显示商品详情页面的内容：

String htmlContent = "<h1>商品标题</h1><p>商品描述</p><img src=\"https://example.com/image.jpg\" />";
htmlTextView.setHtml(htmlContent);

加载本地图片

您可以通过实现 ImageGetter 接口来加载本地图片：

htmlTextView.setHtml("<p>This is a local image: <img src='cat_pic.png' /></p>",
    new HtmlTextView.LocalImageGetter());

典型生态项目

HtmlTextView 可以与其他 Android 库结合使用，以增强其功能。例如，结合 Glide 或 Picasso 库来处理图片加载：

结合 Glide

htmlTextView.setHtml("<p>This is an image from the internet: <img src='https://example.com/image.jpg' /></p>",
    new HtmlTextView.ImageGetter() {
        @Override
        public Drawable getDrawable(String source) {
            Glide.with(context).asDrawable().load(source).into(new CustomTarget<Drawable>() {
                @Override
                public void onResourceReady(@NonNull Drawable resource, @Nullable Transition<? super Drawable> transition) {
                    // 设置图片大小
                    resource.setBounds(0, 0, resource.getIntrinsicWidth(), resource.getIntrinsicHeight());
                    htmlTextView.setText(htmlTextView.getText());
                }

                @Override
                public void onLoadCleared(@Nullable Drawable placeholder) {
                }
            });
            return null;
        }
    });

通过这些步骤，您可以快速集成和使用 HtmlTextView 来显示简单的 HTML 内容，并根据需要进行扩展和优化。