java.lang.Object | |
↳ | android.text.util.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.
Alone with the pattern that is to be matched, a url scheme prefix is also
required. Any pattern match that does not begin with the supplied scheme
will have the scheme prepended to the matched text when the clickable url
is created. For instance, if you are matching web urls you would supply
the scheme http://
. If the pattern matches example.com, which
does not have a url scheme prefix, the supplied scheme will be prepended to
create http://example.com
when the clickable url link is
created.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Linkify.MatchFilter | MatchFilter enables client code to have more control over what is allowed to match and become a link, and what is not. | ||||||||||
Linkify.TransformFilter | TransformFilter enables client code to have more control over how matched patterns are represented as URLs. |
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | ALL | Bit mask indicating that all available patterns should be matched in methods that take an options mask | |||||||||
int | EMAIL_ADDRESSES | Bit field indicating that email addresses should be matched in methods that take an options mask | |||||||||
int | MAP_ADDRESSES | Bit field indicating that street addresses should be matched in methods that take an options mask | |||||||||
int | PHONE_NUMBERS | Bit field indicating that phone numbers should be matched in methods that take an options mask | |||||||||
int | WEB_URLS | Bit field indicating that web URLs should be matched in methods that take an options mask |
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
sPhoneNumberMatchFilter | Filters out URL matches that don't have enough digits to be a phone number. | ||||||||||
sPhoneNumberTransformFilter | Transforms matched phone number text into something suitable to be used in a tel: URL. | ||||||||||
sUrlMatchFilter | Filters out web URL matches that occur after an at-sign (@). |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Scans the text of the provided TextView and turns all occurrences of
the link types indicated in the mask into clickable links.
| |||||||||||
Applies a regex to the text of a TextView turning the matches into
links.
| |||||||||||
Scans the text of the provided Spannable and turns all occurrences
of the link types indicated in the mask into clickable links.
| |||||||||||
Applies a regex to a Spannable turning the matches into
links.
| |||||||||||
Applies a regex to a Spannable turning the matches into
links.
| |||||||||||
Applies a regex to the text of a TextView turning the matches into
links.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Bit mask indicating that all available patterns should be matched in methods that take an options mask
Bit field indicating that email addresses should be matched in methods that take an options mask
Bit field indicating that street addresses should be matched in methods that take an options mask
Bit field indicating that phone numbers should be matched in methods that take an options mask
Bit field indicating that web URLs should be matched in methods that take an options mask
Filters out URL matches that don't have enough digits to be a phone number.
Transforms matched phone number text into something suitable to be used in a tel: URL. It does this by removing everything but the digits and plus signs. For instance: '+1 (919) 555-1212' becomes '+19195551212'
Filters out web URL matches that occur after an at-sign (@). This is to prevent turning the domain name in an email address into a web link.
Scans the text of the provided TextView and turns all occurrences of the link types indicated in the mask into clickable links. If matches are found the movement method for the TextView is set to LinkMovementMethod.
Applies a regex to the text of a TextView turning the matches into links. If links are found then UrlSpans are applied to the link text match areas, and the movement method for the text is changed to LinkMovementMethod.
text | TextView whose text is to be marked-up with links |
---|---|
p | Regex pattern to be used for finding links |
scheme | Url scheme string (eg http:// to be
prepended to the url of links that do not have
a scheme specified in the link text |
matchFilter | The filter that is used to allow the client code additional control over which pattern matches are to be converted into links. |
Scans the text of the provided Spannable and turns all occurrences of the link types indicated in the mask into clickable links. If the mask is nonzero, it also removes any existing URLSpans attached to the Spannable, to avoid problems if you call it repeatedly on the same text.
Applies a regex to a Spannable turning the matches into links.
s | Spannable whose text is to be marked-up with links |
---|---|
p | Regex pattern to be used for finding links |
scheme | Url scheme string (eg http:// to be
prepended to the url of links that do not have
a scheme specified in the link text |
matchFilter | The filter that is used to allow the client code additional control over which pattern matches are to be converted into links. |
Applies a regex to a Spannable turning the matches into links.
text | Spannable whose text is to be marked-up with links |
---|---|
pattern | Regex pattern to be used for finding links |
scheme | Url scheme string (eg http:// to be
prepended to the url of links that do not have
a scheme specified in the link text
|
Applies a regex to the text of a TextView turning the matches into links. If links are found then UrlSpans are applied to the link text match areas, and the movement method for the text is changed to LinkMovementMethod.
text | TextView whose text is to be marked-up with links |
---|---|
pattern | Regex pattern to be used for finding links |
scheme | Url scheme string (eg http:// to be
prepended to the url of links that do not have
a scheme specified in the link text
|