lightbulb_outline Please take our October 2018 developer survey. Start survey

URLSpan

public class URLSpan
extends ClickableSpan implements ParcelableSpan

java.lang.Object
   ↳ android.text.style.CharacterStyle
     ↳ android.text.style.ClickableSpan
       ↳ android.text.style.URLSpan


Implementation of the ClickableSpan that allows setting a url string. When selecting and clicking on the text to which the span is attached, the URLSpan will try to open the url, by launching an an Activity with an Intent.ACTION_VIEW intent.

For example, a URLSpan can be used like this:

 SpannableString string = new SpannableString("Text with a url span");
 string.setSpan(new URLSpan("http://www.developer.android.com"), 12, 15, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
 
Text with URLSpan.

Summary

Inherited constants

Public constructors

URLSpan(String url)

Constructs a URLSpan from a url string.

URLSpan(Parcel src)

Constructs a URLSpan from a parcel.

Public methods

int describeContents()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.

int getSpanTypeId()

Return a special type identifier for this span class.

String getURL()

Get the url string for this span.

void onClick(View widget)

Performs the click action associated with this span.

void writeToParcel(Parcel dest, int flags)

Flatten this object in to a Parcel.

Inherited methods

Public constructors

URLSpan

added in API level 1
public URLSpan (String url)

Constructs a URLSpan from a url string.

Parameters
url String: the url string

URLSpan

added in API level 3
public URLSpan (Parcel src)

Constructs a URLSpan from a parcel.

Parameters
src Parcel

This value must never be null.

Public methods

describeContents

added in API level 3
public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance.

getSpanTypeId

added in API level 3
public int getSpanTypeId ()

Return a special type identifier for this span class.

Returns
int

getURL

added in API level 1
public String getURL ()

Get the url string for this span.

Returns
String the url string.

onClick

added in API level 1
public void onClick (View widget)

Performs the click action associated with this span.

Parameters
widget View

writeToParcel

added in API level 3
public void writeToParcel (Parcel dest, 
                int flags)

Flatten this object in to a Parcel.

Parameters
dest Parcel: The Parcel in which the object should be written.

This value must never be null.

flags int: Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE.