自定义可滚动TextView,添加并展示带html<p>/<h1>等文本

根据项目需求：
1.TextView可以显示带Html标签，如<p>/<h1>等标签相关的文本。
2.可以不断往文本下面添加新的带标签内容。
3.手指在触摸滑动内容时可以让文本上下滚动。
4.可以使用快速抛滑手指，也就是fling动画。
5.监听文本是否滑动到TextView最底端。

一般情况下，如果要使得一个TextView显示一个html内容是比较容易的，只需要使用如下代码就可以将文本转成Html就可以显示到文本中。

String htmlContent = "";
CharSequence squence = Html.fromHtml(htmlContent.toString());
setText(squence);

但它却不能让显示在里面的文本可以滑动。虽然解决这个问题我们还有个解决办法，就是在TextView的布局外再包一层ScrollView。但我这里不使用这种方法，不好意思了各位。

我们一个一个来看这个需求，一个个解决上面的问题。

Step1.创建一个自定义TextView ，HtmlTextView.java

public class HtmlTextView extends AppCompatTextView(){
    public HtmlTextView(@NonNull Context context){
        super(context);
    }
    public HtmlTextView(@NonNull Context context, @Nullable AttributeSets attrs){
        super(context, attrs);
    }
    public HtmlTextView(@NonNull Context context, @Nullable AttributeSets attrs, int defStyleAttr){
        super(context, attrs, defStyleAttr);
    }
}

Step2.可显示Html文本

像上面介绍的那样，如果需要显示Html,就需要将文本转换为Html文本，再将其设置到TextView中，我们可以这样做,先初始化一个StringBuilder来存放不停添加的文本内容。再将内容设置到TextView中。

private StringBuilder htmlContent;
// 在自定义view构造器中增加初始化方法
public class HtmlTextView extends AppCompatTextView(){
    public HtmlTextView(@NonNull Context context){
        super(context);
        init();
    }
    public HtmlTextView(@NonNull Context context, @Nullable AttributeSets attrs){
        super(context, attrs);
        init();
    }
    public HtmlTextView(@NonNull Context context, @Nullable AttributeSets attrs, int defStyleAttr){
        super(context, attrs, defStyleAttr);
        init();
    }

    private void init(){
        htmlContent = new StringBuilder();
    }
    // 创建一个方法，可以不停往里面添加新文本并设置到TextView中。
    private void addHtmlText(String title, String htmlText) {
        if(!TextUtils.isEmpty(title)) {
            String formatHtmlTitle = "<h1>" + title.trim + "</h1>";
            htmlContent.append(formatHtmlTitle);
        }
        htmlContent.append(htmlText);
        // 使用Html.fromHtml将Html文本转换为CharSequence
        CharSequence sequence = Html.fromHtml(htmlContent.toString());
        setText(sequence);
    }
}

Step3.可滑动/滚动TextView中的内容

根据要求，我们需要让TextView中的文字可以通过手指触摸屏幕并在上下滑动时进行滑动或滚动，那我们就需要使用用户手势检测GestureDetector类，使用这个类来监听用户滑动的触发事件。

所以我这里创建一个内部类继承GestureDetector.

private class GestureListener extends GestureDetector.SimpleOnGestureListener {
        // 记录手指按到界面时的初始位置
        private float mLastY;

        @Override
        public boolean onScroll(@Nullable MotionEvent e1, @NonNull MotionEvent e2, float distanceX, float distanceY) {
            // 获取当前视图的高度
            int viewHeight = getHeight();
            // 获取TextView中文本内容的高度
            int contentHeight = getLayout().getHeight();
            mContentHeight = contentHeight;

            // 计算TextView中内容的顶部和底部位置
            int contentTop = getScrollY();
            int contentBottom = contentTop + viewHeight;
            
            // 计算出当前有delta是正数还是负数，>0 则表示向手指向下滑动，<0 表示向上滑动。
            float deltaY = e2.getY() - mLastY;
            mLastY = e2.getY();
            if (deltaY > 0) {
                // 可监听界面向下滑动
            } else {
                // 可监听界面向上滑动            
            }

            // 检查是否滑动到顶部或底部
            boolean atTop = contentTop <= 0 && deltaY > 0;
            boolean atBottom = contentBottom >= contentHeight - 200 && deltaY < 0;

            if (atTop || atBottom) {
                 // 这里可处理滑动到顶部或底部处理的事件
                return true;
            }
            // 手势滑动事件
            scrollBy(0, (int) distanceY);
            return true;
        }

        @Override
        public boolean onFling(@Nullable MotionEvent e1, @NonNull MotionEvent e2, float velocityX, float velocityY) {
            // fling滑动事件
            mScroller.fling(0, getScrollY(), 0, (int) -velocityY, 0, 0, 0, computeVerticalScrollRange() - getHeight());
            invalidate();
            return true;
        }

        @Override
        public boolean onDown(@NonNull MotionEvent e) {
            mLastY = e.getY();
            return true;
        }

    }

这个处理滑动的监听已经处理完了，但还需要将其绑定到触摸监听中，否则这只是个内部类，不去绑定或调用就是一段废代码。所以需要在onTouchEvent事件中处理一下。
在处理之前，你得先初始化该类，得到一个对象，在创建该自定义view的初始化方法中实例该类的对象。

private void init() {
        mGestureDetector = new GestureDetector(getContext(), new GestureListener());
        mScroller = new Scroller(getContext());
        htmlContent = new StringBuilder();
}

对了，这里还有一个Scroller也需要初始化一下，实例一个它的对象出来，主要作用也是处理滑动事件，可以处理用户手动Fling快速滑动并弹起手指时候的自动滚动。
在onTouchEvent事件中的处理为：

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        // 让GestureDetector处理触摸事件
        boolean result = mGestureDetector.onTouchEvent(event);
        // 手指重新触摸屏幕内容后，判断一下当前scroller是否还在滚动，如果还在滚动，就把滚动暂停。
        boolean isFling = !mScroller.isFinished();
        if (isFling && event.getAction() == MotionEvent.ACTION_DOWN) {
            mScroller.abortAnimation();
        }
        // 手指弹起时刷一下界面
        if (event.getAction() == MotionEvent.ACTION_UP) {
            invalidate();
        }
        return true;
    }

在上面代码都写完后，其实还差最后一步，就是滚动后的内容还需要经过计算，把滚动后的位置给定住，则需要在HtmlTextView中重载计算滚动方法“computeScroll()”。

    @Override
    public void computeScroll() {
        super.computeScroll();
        if (mScroller.computeScrollOffset()) {
            scrollTo(0, mScroller.getCurrY());
            invalidate();
        }
    }

该函数会重绘界面，让其界面不会漂移。

上面说的4个需求这样貌似就实现了，可能还存在一些小问题，但这个暂时不影响使用。
以下是全部代码。

package com.bose.metabrowser.book.novelreadmodel.view;

import android.content.Context;
import android.graphics.Canvas;
import android.graphics.Color;
import android.graphics.Paint;
import android.graphics.drawable.ColorDrawable;
import android.graphics.drawable.Drawable;
import android.text.Html;
import android.text.Spannable;
import android.text.SpannableString;
import android.text.TextUtils;
import android.text.style.ImageSpan;
import android.util.AttributeSet;
import android.util.Log;
import android.util.TypedValue;
import android.view.GestureDetector;
import android.view.MotionEvent;
import android.widget.Scroller;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.appcompat.widget.AppCompatTextView;
import androidx.core.content.ContextCompat;

import com.bose.metabrowser.R;

import java.util.ArrayList;
import java.util.List;

/**
 * Created by gudd on 2024/3/5.
 */
public class HtmlTextView extends AppCompatTextView {

    private StringBuilder htmlContent;

    private float lastY;
    private float mContentHeight;

    private GestureDetector mGestureDetector;
    private Scroller mScroller;

    public HtmlTextView(@NonNull Context context) {
        super(context);
        init();
    }

    public HtmlTextView(@NonNull Context context, @Nullable AttributeSet attrs) {
        super(context, attrs);
        init();
    }

    public HtmlTextView(@NonNull Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init();
    }

    private void init() {
        initTextSize();

        mGestureDetector = new GestureDetector(getContext(), new GestureListener());
        mScroller = new Scroller(getContext());

        htmlContent = new StringBuilder();
    }

    private void initTextSize() {
        setTextSize(TypedValue.COMPLEX_UNIT_DIP, 20);
        setTextColor(ContextCompat.getColor(getContext(), R.color.black));
        ColorDrawable drawable = new ColorDrawable();
        drawable.setColor(Color.parseColor("#f2f2f2"));
        setBackground(drawable);
        int lr = dip2px(getContext(), 10.f);
        int tb = dip2px(getContext(), 5.f);
        setPadding(lr, tb, lr, tb);
    }

    public void addHtmlText(String title, String htmlText) {
        int scrollY = mScroller.getCurrY();
        Log.i("guddd", "添加Text时scrollY: " + scrollY);
        // title添加到文本中
        if (!TextUtils.isEmpty(title)) {
            String formatHtmlTitle = "<h1>" + title.trim() + "</h1>";
            htmlContent.append(formatHtmlTitle);
        }
        // 添加HTML文本到TextView中
        htmlContent.append(htmlText);
        // 使用Html.fromHtml将HTML文本转换为CharSequence
        CharSequence sequence = Html.fromHtml(htmlContent.toString());
        setText(sequence);
        post(() -> scrollTo(0, scrollY));
    }

    public void setTextSizeEnlarge() {
        int curSize = px2dip(getContext(), getTextSize());
        if (curSize < 30 && curSize >= 10) {
            curSize += 2;
        } else {
            curSize = 30;
        }
        setTextSize(TypedValue.COMPLEX_UNIT_DIP, curSize);
    }

    public void setTextSizeReduce() {
        int curSize = px2dip(getContext(), getTextSize());
        if (curSize <= 30 && curSize > 10) {
            curSize -= 2;
        } else {
            curSize = 10;
        }
        setTextSize(TypedValue.COMPLEX_UNIT_DIP, curSize);
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        // 让GestureDetector处理触摸事件
        boolean result = mGestureDetector.onTouchEvent(event);
        boolean isFling = !mScroller.isFinished();
        if (isFling && event.getAction() == MotionEvent.ACTION_DOWN) {
            mScroller.abortAnimation();
        }
        if (event.getAction() == MotionEvent.ACTION_UP) {
            invalidate();
        }
        return true;
    }

    private class GestureListener extends GestureDetector.SimpleOnGestureListener {
        private float mLastY;

        @Override
        public boolean onSingleTapUp(@NonNull MotionEvent e) {
            return super.onSingleTapUp(e);
        }

        @Override
        public boolean onScroll(@Nullable MotionEvent e1, @NonNull MotionEvent e2, float distanceX, float distanceY) {
            // 获取当前视图的高度
            int viewHeight = getHeight();
            // 获取TextView中文本内容的高度
            int contentHeight = getLayout().getHeight();
            mContentHeight = contentHeight;

            // 计算TextView中内容的顶部和底部位置
            int contentTop = getScrollY();
            int contentBottom = contentTop + viewHeight;

            float deltaY = e2.getY() - mLastY;
            mLastY = e2.getY();
            if (onBottomReachedListener != null) {
                onBottomReachedListener.onTouchSlide(deltaY);
            }

            // 检查是否滑动到顶部或底部
            boolean atTop = contentTop <= 0 && deltaY > 0;
            boolean atBottom = contentBottom >= contentHeight - 200 && deltaY < 0;

            if (atTop || atBottom) {
                if (atBottom) {
                    // 调用接口通知加载新页面
                    if (onBottomReachedListener != null) {
                        onBottomReachedListener.onBottomReached();
                    }
                }
                return true;
            }
            // 手势滑动事件
            scrollBy(0, (int) distanceY);
            return true;
        }

        @Override
        public boolean onFling(@Nullable MotionEvent e1, @NonNull MotionEvent e2, float velocityX, float velocityY) {
            // fling滑动事件
            mScroller.fling(0, getScrollY(), 0, (int) -velocityY, 0, 0, 0, computeVerticalScrollRange() - getHeight());
            invalidate();
            return true;
        }

        @Override
        public boolean onDown(@NonNull MotionEvent e) {
            mLastY = e.getY();
            return true;
        }
    }

    @Override
    public void computeScroll() {
        super.computeScroll();
        if (mScroller.computeScrollOffset()) {
            scrollTo(0, mScroller.getCurrY());
            invalidate();
        }
    }

    private float dpToPx(float dp) {
        return dp * getContext().getResources().getDisplayMetrics().density;
    }

    /**
     * 根据手机的分辨率从 dp 的单位 转成为 px(像素)
     */
    public static int dip2px(Context context, float dpValue) {
        final float scale = context.getResources().getDisplayMetrics().density;
        return (int) (dpValue * scale + 0.5f);
    }

    /**
     * 根据手机的分辨率从 px(像素) 的单位 转成为 dp
     */
    public static int px2dip(Context context, float pxValue) {
        final float scale = context.getResources().getDisplayMetrics().density;
        return (int) (pxValue / scale + 0.5f);
    }

    public interface OnBottomReachedListener {
        void onBottomReached();// 文字内容滑动到最底部了
        void onTouchSlide(float deltaY);// 手指在屏幕上上下滑动
    }

    private OnBottomReachedListener onBottomReachedListener;

    public void setOnBottomReachedListener(OnBottomReachedListener listener) {
        this.onBottomReachedListener = listener;
    }
}