Linkify是一个辅助类,通过RegEx样式匹配,自动地在TextView类(和继承的类)中创建超链接。符合特定的RegEx样式的文本会被转变成可点击的超链接,这些超链接隐式的调用startActivity(new Intent(Intent.ACTION_VIEW,uri))
符合的文本会作为目标URI
你可以指定任意的字符串样式为链接,方便的,Linkify类提供了与之的通用内容类型(如电话号码和e-mail、web地址)
本地的连接类型
Linkify.addLinks 静态方法接受一个View来制作连接,还包括一个或多个默认内容类型的结果。Linkify类提供了一些内容类型:WEB_URLS、EMAIL_ADDRESSES、PHONE_NUMBERS和ALL。当点击时,会相应的打开浏览器或e-mail应用程序
Linkify.addLinks(textView,Linkify.WEB_URLS|Linkify.EMAIL_ADDRESSES);或是android:autoLink
创建自定义的连接字符串
为了定义自己的连接字符串,你需要创建一个RegEx样式来匹配文本,进而显示超链接。和本地类型一样,通过调用Linkify.addLinks来指定目标View,但传入的是新的RegEx样式。
接下来的例子显示了一个View链接到由Android Content Provider(下一章你会创建)提供的地震数据。与包含所有的情况相比,链接样式能匹配任何以“quake”开头后跟一个数字的文本。在Intent被触发前,内容会被添加到URI上。
int flags = Pattern.CASE_INSENSITIVE;
Pattern p = Pattern.compile(“\\bquake[0-9]*\\b”, flags);
Linkify.addLinks(myTextView, p, “content://com.paad.earthquake/earthquakes/”);
Linkify还支持TranformFilter和MatchFilter接口。它们提供一些对目标URI的额外控制和定义匹配字符串,它们的使用如下的框架代码所示:
Linkify.addLinks(myTextView, pattern, prefixWith, new MyMatchFilter(), new MyTransformFilter());
使用Match Filter
在你定义的MatchFilter中实现acceptMatch方法,来为RegEx样式匹配添加额外的条件。当一个潜在的匹配发现时,acceptMatch被触发,匹配的开始点和结束点(包括被查找的整个文本)以参数的形式传入。
接下来的代码显示了一个MatchFilter的实现,它取消任何之前是一个“!”的匹配。
class MyMatchFilter implements MatchFilter {
public boolean acceptMatch(CharSequence s, int start, int end) {
return (start == 0 || s.charAt(start-1) != ‘!’);
}
}
使用Transform Filter
Transform Filter为格式化文本字符串提供了更大的自由度,允许你修改由链接文本自动生成的隐式URI。减少链接文本和目标URI的耦合能更加自由地决定如何显示数据字符串给用户。
使用Transform Filter,在你定义的TransformFilter中实现transformUrl方法。当Linkify找到正确的匹配后,它会调用transformUrl,传入使用的RegEx样式和它创建的默认URI字符串。你可以修改匹配的字符串,然后返回一个适合给其它Android应用程序“看”的URI。
下面的TransformFilter实现将匹配的文本转换成小写的URI:
class MyTransformFilter implements TransformFilter {
public String transformUrl(Matcher match, String url) {
return url.toLowerCase();
}
}
符合的文本会作为目标URI
你可以指定任意的字符串样式为链接,方便的,Linkify类提供了与之的通用内容类型(如电话号码和e-mail、web地址)
本地的连接类型
Linkify.addLinks 静态方法接受一个View来制作连接,还包括一个或多个默认内容类型的结果。Linkify类提供了一些内容类型:WEB_URLS、EMAIL_ADDRESSES、PHONE_NUMBERS和ALL。当点击时,会相应的打开浏览器或e-mail应用程序
Linkify.addLinks(textView,Linkify.WEB_URLS|Linkify.EMAIL_ADDRESSES);或是android:autoLink
创建自定义的连接字符串
为了定义自己的连接字符串,你需要创建一个RegEx样式来匹配文本,进而显示超链接。和本地类型一样,通过调用Linkify.addLinks来指定目标View,但传入的是新的RegEx样式。
接下来的例子显示了一个View链接到由Android Content Provider(下一章你会创建)提供的地震数据。与包含所有的情况相比,链接样式能匹配任何以“quake”开头后跟一个数字的文本。在Intent被触发前,内容会被添加到URI上。
int flags = Pattern.CASE_INSENSITIVE;
Pattern p = Pattern.compile(“\\bquake[0-9]*\\b”, flags);
Linkify.addLinks(myTextView, p, “content://com.paad.earthquake/earthquakes/”);
Linkify还支持TranformFilter和MatchFilter接口。它们提供一些对目标URI的额外控制和定义匹配字符串,它们的使用如下的框架代码所示:
Linkify.addLinks(myTextView, pattern, prefixWith, new MyMatchFilter(), new MyTransformFilter());
使用Match Filter
在你定义的MatchFilter中实现acceptMatch方法,来为RegEx样式匹配添加额外的条件。当一个潜在的匹配发现时,acceptMatch被触发,匹配的开始点和结束点(包括被查找的整个文本)以参数的形式传入。
接下来的代码显示了一个MatchFilter的实现,它取消任何之前是一个“!”的匹配。
class MyMatchFilter implements MatchFilter {
public boolean acceptMatch(CharSequence s, int start, int end) {
return (start == 0 || s.charAt(start-1) != ‘!’);
}
}
使用Transform Filter
Transform Filter为格式化文本字符串提供了更大的自由度,允许你修改由链接文本自动生成的隐式URI。减少链接文本和目标URI的耦合能更加自由地决定如何显示数据字符串给用户。
使用Transform Filter,在你定义的TransformFilter中实现transformUrl方法。当Linkify找到正确的匹配后,它会调用transformUrl,传入使用的RegEx样式和它创建的默认URI字符串。你可以修改匹配的字符串,然后返回一个适合给其它Android应用程序“看”的URI。
下面的TransformFilter实现将匹配的文本转换成小写的URI:
class MyTransformFilter implements TransformFilter {
public String transformUrl(Matcher match, String url) {
return url.toLowerCase();
}
}