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 超链接
如果只是单单使用 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());
结果如下:
支持超链接的 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());


