Android 的 TextView 除了可以用来显示文字数据之外,还可以使用 HTML 语法来调整文字的样式和文字超链接,无需特地去使用 WebView。只是一旦使用 TextView 制作超链接,该 TextView 就会变得难以控制,因此有几个特性应该是设计师必须事先知道的。

TextView 显示 HTML

要使用 TextView 显示 HTML 的作法很简单,只要用以下方式来 setText 即可。

textView.setText(Html.fromHtml("HTML语法字符串"));

例如:

textView.setText(Html.fromHtml("欢迎大家来到<big><font color=\"#FF0000\"><b>MagicLen</b></font></big>,本站网址如下:<br/><br/><a href=\"https://magiclen.org/\">https://magiclen.org/</a>"));

结果如下:

以 Html.fromHtml 显示的 TextView

激活 HTML 超链接

如果只是单单使用 TextView 的 setText 方法来指定 HTML 语法,HTML 超链接将无法有真正的作用,可以使用 Android SDK 内置提供的方式来让 TextView 拥有超链接的功能,程序只要添加一行即可,如下:

textView.setMovementMethod(LinkMovementMethod.getInstance());

指定 LinkMovementMethod 给 textView,使其拥有超链接的功能。

TextView 使用 AutoLink 自动判断链接

若数据源并非是 HTML,而是纯文字的话,如果想要让文字中的网址、电子邮件等等的信息也拥有超链接,可以设置 TextView 的 AutoLink 属性,决定要将哪些信息自动产生超链接。

在 XML 文件中设置 autolink 属性

添加方式如下:

<TextView
    android:id="@+id/textView"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:autoLink="all" />

若将 android:autoLink 设为 all,那它会将 text 文字中的网址、电子邮件、地址、电话都变成超链接。如果没有特殊需求的话,不要自动将电话变成超链接,因为不是所有的 Android 设备都能够打电话,且电话格式各国都不太一样,很大的概率会将一般数字误判成电话。也不要自动将地址变成超链接,因为并非在所有设备上都有地图 App,而且 Android 好像没办法判断中文地址。所以 autoLink 属性可以改写如下:

<TextView
    android:id="@+id/textView"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:autoLink="web|email" />

如果在 XML 设置 autoLink,激活了 AutoLink 属性的话,LinkMovementMethod 将会被自动加入 TextView 中,因此没有必要使用 setMovementMethod 再指定 LinkMovementMethod。

在 SDK 中用 Java 程序指定 AutoLinkMask

添加方式如下:

textView.setAutoLinkMask(Linkify.ALL);

不将电话和地址加上超链接的写法如下:

textView.setAutoLinkMask(Linkify.EMAIL_ADDRESSES|Linkify.WEB_URLS);

仅用 setAutoLinkMask 方法是无法激活 AutoLink 属性的,还要再指定 LinkMovementMethod 给 TextView:

textView.setMovementMethod(LinkMovementMethod.getInstance());

不必使用 HTML 的 a 标签指定超链接

激活 textView 的 AutoLink 之后,就不必再使用 HTML 的 a 标签来制作超链接。因为 Android 会自动抓取 text 文字中符合的格式,将其自动更换为 HTML 的超链接。当然如果想要让超链接显示出不同的文字,还是可以使用 a 标签来指定。完全不使用 HTML,Android 也会自动产生超链接。

以下举个例子:

textView.setText("欢迎大家来到MagicLen\n本站网址:https://magiclen.org\n电子邮件:len@magiclen.org");
textView.setAutoLinkMask(Linkify.EMAIL_ADDRESSES|Linkify.WEB_URLS);
textView.setMovementMethod(LinkMovementMethod.getInstance());

结果如下:

激活 AutoLink 后带有超链接的 TextView

支持超链接的 TextView 所产生的问题

要让 TextView 拥有超链接功能,必须要指定 LinkMovementMethod 给 TextView。然而 TextView 一旦设置了 MovementMethod 或是 KeyListener,TextView 会自动将 Focusable、Clickable、LongClickable 属性设置为 true。

问题与解决方法

当 TextView 为 Focusable 的时候,且此 TextView 作为 GridView 或是 ListView 的 Item,会使得无论是否点击到 TextView,onItemClickListener 和 onItemLongClickListener 都会没有作用。所以一定要覆写掉 hasFocusable 方法,让它永远传回 false。

当 TextView 为 Clickable 的时候,onTouchEvent 将永远回传 true,所以点击事件在 TextView 中就被挡下了,无法传给更上层的 View,因此当此 TextView 作为 GridView 或是 ListView 的 Item 时,onItemClickListener 和 onItemLongClickListener 将无作用,所以一定要想办法覆写掉 onTouchEvent 方法,让它可以在点击到 TextView 中链接的时候传回 true 就好。

但是,Android 内置的 LinkMovementMethod 并不会让我们知道用户到底是不是点击链接,因此我们还必须改写 LinkMovementMethod。

改写后的 TextView 命名为 LinkTextView,LinkMovementMethod 命名为 LinkTextViewMovementMethod,代码如下:

/**
 * 解决可使用Link HTML的TextView变成Clickable和Focusable的问题
 *
 * @author magiclen
 */
public class LinkTextView extends TextView {

    // -----对象变量-----
    private boolean linkHit; // 是否为按下链接

    // -----构造器-----
    public LinkTextView(Context context) {
        super(context);
    }

    public LinkTextView(Context context, AttributeSet attrs) {
        super(context, attrs);
    }

    public LinkTextView(Context context, AttributeSet attrs, int defStyle) {
        super(context, attrs, defStyle);
    }

    // -----对象方法-----
    /**
     * 覆写onTouchEvent,使其不会永远传回true,若为true,则无法将touch事件传出给上层的View。
     *
     */
    @SuppressLint("ClickableViewAccessibility")
    @Override
    public boolean onTouchEvent(MotionEvent event) {
        super.onTouchEvent(event);
        return linkHit;
    }

    /**
     * 设置HTML内容给TextView,如果已激活AutoLink属性,则不需要使用这个方法来制作a标签的链接。
     *
     * @param html
     */
    public void setTextViewHTML(String html) {
        Spanned sequence = Html.fromHtml(html);
        SpannableStringBuilder strBuilder = new SpannableStringBuilder(sequence);
        setText(strBuilder);
    }

    /**
     * 设置MovementMethod之后,TextView会成为Focusable,所以LinkTextView覆写此方法,永远传回false。
     */
    @Override
    public boolean hasFocusable() {
        return false;
    }

    /**
     * 继承LinkMovementMethod的LinkTextViewMovementMethod,将会针对链接点击进行处理,
     * 让LinkTextView知道目前点击是否为链接点击。
     *
     * @author magiclen
     *
     */
    public static class LinkTextViewMovementMethod extends LinkMovementMethod {

        // -----类别变量-----
        private static LinkTextViewMovementMethod sInstance; // 保存唯一的实体参考

        // -----对象方法-----
        /**
         * 取得LinkTextViewMovementMethod的唯一实体参考。
         *
         * @return
         */
        public static LinkTextViewMovementMethod getInstance() {
            if (sInstance == null) {
                sInstance = new LinkTextViewMovementMethod(); // 创建新的实体
            }
            return sInstance;
        }

        /**
         * 覆写触摸事件,分辨出是否为链接的点击。
         */
        @Override
        public boolean onTouchEvent(TextView widget, Spannable buffer, MotionEvent event) {
            int action = event.getAction(); // 取得事件类型

            if (action == MotionEvent.ACTION_UP || action == MotionEvent.ACTION_DOWN) {
                int x = (int) event.getX();
                int y = (int) event.getY();

                x -= widget.getTotalPaddingLeft();
                y -= widget.getTotalPaddingTop();

                x += widget.getScrollX();
                y += widget.getScrollY();

                Layout layout = widget.getLayout();
                int line = layout.getLineForVertical(y);
                int off = layout.getOffsetForHorizontal(line, x);

                ClickableSpan[] link = buffer.getSpans(off, off, ClickableSpan.class);

                if (link.length != 0) { // 是链接点击
                    if (widget instanceof LinkTextView) { // 如果实体是LinkTextView
                        ((LinkTextView) widget).linkHit = true;
                    }
                    if (action == MotionEvent.ACTION_UP) { // 放开时
                        link[0].onClick(widget); // 打开链接
                    } else if (action == MotionEvent.ACTION_DOWN) { // 按下时
                        Selection.setSelection(buffer, buffer.getSpanStart(link[0]), buffer.getSpanEnd(link[0])); // 选择链接
                    }
                    return true;
                } else { // 不是链接点击
                    if (widget instanceof LinkTextView) { // 如果实体是LinkTextView
                        ((LinkTextView) widget).linkHit = false;
                    }
                    Selection.removeSelection(buffer);
                    Touch.onTouchEvent(widget, buffer, event);
                    return false;
                }
            }
            return Touch.onTouchEvent(widget, buffer, event);
        }
    }
}

LinkTextView 的使用方式和一般的 TextView 一样,只不过如果要使其支持超链接功能,一定要手动指定 LinkTextViewMovementMethod 给 LinkTextView,如下:

linkTextView.setMovementMethod(LinkTextViewMovementMethod.getInstance());