需求:

如题所诉。需要识别出文本中的链接,并显示成超链接的UI样式。点击能够跳转打开网页(最好是自己app内部的WebView。)

简单实现:

在 xml 里给TextView 设置:

1
2
3
4
5
<TextView 
android:autoLink="web"
android:linksClickable="true"
android:textColorLink="@color/color_017EBD"
.../>

简单,但是有很大的缺点:

  1. 链接下的下划线去不掉。
  2. 只能跳转到系统默认的浏览器。
  3. 链接后面不佳空格有中文就识别不出来。

虽然它不好。但它是系统自带的功能,可以看看它的实现原理,可以关键地方改写它。

原理:

根据所学知识。想必也是ClickableSpan的一种实际使用罢了。可以先看看:ClickableSpan的一点点摸索

关键类:

  1. URLSpan:ClickableSpan的子类,带URL,下划线去不掉。
  2. LinkMovementMethod:ClickableSpan生效所需,之前讲了。
  3. Linkify:一个识别文字中链接,地址,邮箱之类的工具类。

前面两个看ClickableSpan那篇就理解了。重点看Linkify。

Linkify:

Linkify take a piece of text and a regular expression and turns all of the regex matches in the text into clickable links. This is particularly useful for matching things like email addresses, web URLs, etc. and making them actionable.

Linkify是一个辅助类,通过RegEx样式匹配,自动地在TextView类(和继承的类)中创建超链接。

它的方法public方法有多个重载方法。只需要了解它的主要功能。

我们可以用它实现超链接的识别。写个工具类。

工具类:

我们只需要自定义RegEx就可以实现我们自己的识别超链接规则:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
object HyperLinkHelper {

private const val REGEX = "(((http[s]?|ftp?|file?)://)?[a-zA-Z0-9.\\-]+\\.([a-zA-Z]{2,4})(:\\d+)?(/[a-zA-Z0-9.\\-~!@#$%^&*+?:_/=<>]*)?)|(www.[a-zA-Z0-9.\\-]+\\.([a-zA-Z]{2,4})(:\\d+)?(/[a-zA-Z0-9.\\-~!@#$%^&*+?:_/=<>]*)?)"

/**
* 转换成链接。
*/
fun transUrlSpan(text: CharSequence, @ColorInt highColor: Int = -0xa8946b): Spannable {
val ss = SpannableString.valueOf(text)
Linkify.addLinks(ss, Pattern.compile(REGEX), "")
val urlSpans = ss.getSpans(0, ss.length,
URLSpan::class.java) ?: return ss
for (sp in urlSpans) {
val start = ss.getSpanStart(sp)
val end = ss.getSpanEnd(sp)
ss.removeSpan(sp)
ss.setSpan(UrlLinkSpan(sp.url.formatUrl(), highColor), start, end, Spannable.SPAN_INCLUSIVE_EXCLUSIVE)
}
return ss
}

/**
* 设置点击事件。
*/
fun setClickListener(spanned: Spanned, listener: UrlLinkSpan.OnClickListener) {
spanned.getSpans(0, spanned.length, UrlLinkSpan::class.java)
.forEach { it.listener = listener }
}

private fun String.formatUrl(): String {
return if (indexOf("http") != 0
&& indexOf("ftp") != 0
&& indexOf("file") != 0) {
"http://$this"
} else {
this
}
}
// 并把URLSpan替换成样式需要的Span。
class UrlLinkSpan(val url: String, @ColorInt val highColor: Int) : ClickableSpan() {

var listener: OnClickListener? = null

interface OnClickListener {
fun onUrlLinkClick(widget: View, url: String)
}

override fun onClick(widget: View) {
listener?.onUrlLinkClick(widget, url)
}

override fun updateDrawState(ds: TextPaint) {
super.updateDrawState(ds)
ds.color = highColor
ds.isUnderlineText = false
}
}

}

整一个 BindingAdapter 方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
@BindingAdapter(value = ["binding_text_url_link", "binding_url_link_listener"], requireAll = true)
fun TextView.setUrlLinkText(text: CharSequence?, listener: HyperLinkHelper.UrlLinkSpan.OnClickListener) {
if (this.text?.toString() != text) {
this.text = if (text != null) {
HyperLinkHelper.transUrlSpan(text, getColor(R.color.color_017EBD)).apply {
HyperLinkHelper.setClickListener(this, listener)
movementMethod = ClickLinkMovementMethod
}
} else {
""
}
}
}

ClickLinkMovementMethod 是为了解决长按的问题。ClickableSpan的一点点摸索那篇文章有讲。

扩展:

Linkify还可以定义如下接口:

  1. Match Filter:实现acceptMatch方法,来为RegEx样式匹配添加额外的条件。当一个潜在的匹配发现时,acceptMatch被触发,匹配的开始点和结束点(包括被查找的整个文本)以参数的形式传入。
  2. Transform Filter:为格式化文本字符串提供更大的自由度,允许你修改由链接文本自动生成的隐式URI。

有兴趣自己去了解。

总结:

要点:

  1. 正则识别链接
  2. 显示样式自定义,去掉下划线。
  3. 点击逻辑自定义,跳转到自己的WebView。
  4. 解决长按冲突问题。

配一张图