Linkify介绍

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.

 

接下来的代码片段显示如何为TextView制作链接显示web和e-mail地址为超链接。当点击时，它们会相应地打开浏览器或e-mail应用程序。

 

TextView textView = (TextView)findViewById(R.id.myTextView);

Linkify.addLinks(textView, Linkify.WEB_URLS|Linkify.EMAIL_ADDRESSES);

 

 

你可以在layout资源里使用android:autoLink特性来为View制作链接。它支持一个或多个（用|分割）自定义的值：none、web、email、phone或all。接下来的XML片段显示了如何为电话号码和e-mail地址添加超链接：

 

<TextView

android:layout_width=”fill_parent”

android:layout_height=”fill_parent”

android:text=”@string/linkify_me”

android:autoLink=”phone|email”

/>

 

 

创建自定义的链接字符串

 

为了定义自己的链接字符串，你需要创建一个RegEx样式来匹配文本，进而显示成超链接。

 

和本地类型一样，通过调用Linkify.addLinks来指定目标View，但这次，传入的是新的RegEx样式。你还可以传入一个前缀，当链接点击时，它会添加到目标URI上。

 

接下来的例子显示了一个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();

}

}