Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Inherited Constants](https://developer.android.com/reference/android/text/style/URLSpan#inhconstants) \| [Ctors](https://developer.android.com/reference/android/text/style/URLSpan#pubctors) \| [Methods](https://developer.android.com/reference/android/text/style/URLSpan#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/text/style/URLSpan#inhmethods)

# URLSpan

*** ** * ** ***

` public class URLSpan `   
` ` ` ` ` extends https://developer.android.com/reference/android/text/style/ClickableSpan ` ` implements https://developer.android.com/reference/android/text/ParcelableSpan `

|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||||
| ↳ | [android.text.style.CharacterStyle](https://developer.android.com/reference/android/text/style/CharacterStyle) |||
|   | ↳ | [android.text.style.ClickableSpan](https://developer.android.com/reference/android/text/style/ClickableSpan) ||
|   |   | ↳ | android.text.style.URLSpan |

<br />

*** ** * ** ***

Implementation of the `https://developer.android.com/reference/android/text/style/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 `https://developer.android.com/reference/android/content/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);
```
![](https://developer.android.com/static/reference/android/images/text/style/urlspan.png) Text with `URLSpan`.

<br />

## Summary

### Inherited constants

From interface `https://developer.android.com/reference/android/os/Parcelable` `int` `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR`

Descriptor bit used with `https://developer.android.com/reference/android/os/Parcelable#describeContents()`: indicates that the Parcelable object's flattened representation includes a file descriptor.
`int` `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE`

Flag for use with `https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)`: the object being written is a return value, that is the result of a function such as "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`", or "`void someFunction(inout Parcelable)`".

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/text/style/URLSpan#URLSpan(android.os.Parcel)(https://developer.android.com/reference/android/os/Parcel src) ` Constructs a `https://developer.android.com/reference/android/text/style/URLSpan` from a parcel. |
| ` https://developer.android.com/reference/android/text/style/URLSpan#URLSpan(java.lang.String)(https://developer.android.com/reference/java/lang/String url) ` Constructs a `https://developer.android.com/reference/android/text/style/URLSpan` from a url string. |

| ### Public methods ||
|---|---|
| ` int` | ` https://developer.android.com/reference/android/text/style/URLSpan#describeContents()() ` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. |
| ` int` | ` https://developer.android.com/reference/android/text/style/URLSpan#getSpanTypeId()() ` Return a special type identifier for this span class. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/text/style/URLSpan#getURL()() ` Get the url string for this span. |
| ` void` | ` https://developer.android.com/reference/android/text/style/URLSpan#onClick(android.view.View)(https://developer.android.com/reference/android/view/View widget) ` Performs the click action associated with this span. |
| ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/android/text/style/URLSpan#toString()() ` Returns a string representation of the object. |
| ` void` | ` https://developer.android.com/reference/android/text/style/URLSpan#writeToParcel(android.os.Parcel,%20int)(https://developer.android.com/reference/android/os/Parcel dest, int flags) ` Flatten this object in to a Parcel. |

### Inherited methods

From class ` https://developer.android.com/reference/android/text/style/ClickableSpan ` ` abstract void` ` https://developer.android.com/reference/android/text/style/ClickableSpan#onClick(android.view.View)(https://developer.android.com/reference/android/view/View widget) `

Performs the click action associated with this span.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/android/text/style/ClickableSpan#toString()() `

Returns a string representation of the object.
` void` ` https://developer.android.com/reference/android/text/style/ClickableSpan#updateDrawState(android.text.TextPaint)(https://developer.android.com/reference/android/text/TextPaint ds) `

Makes the text underlined and in the link color.
From class ` https://developer.android.com/reference/android/text/style/CharacterStyle ` ` https://developer.android.com/reference/android/text/style/CharacterStyle` ` https://developer.android.com/reference/android/text/style/CharacterStyle#getUnderlying()() `

Returns "this" for most CharacterStyles, but for CharacterStyles that were generated by `https://developer.android.com/reference/android/text/style/CharacterStyle#wrap(android.text.style.CharacterStyle)`, returns the underlying CharacterStyle.
` abstract void` ` https://developer.android.com/reference/android/text/style/CharacterStyle#updateDrawState(android.text.TextPaint)(https://developer.android.com/reference/android/text/TextPaint tp) ` ` static https://developer.android.com/reference/android/text/style/CharacterStyle` ` https://developer.android.com/reference/android/text/style/CharacterStyle#wrap(android.text.style.CharacterStyle)(https://developer.android.com/reference/android/text/style/CharacterStyle cs) `

A given CharacterStyle can only applied to a single region of a given Spanned.
From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `

Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `

Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class<?>` ` https://developer.android.com/reference/java/lang/Object#getClass()() `

Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `

Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `

Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `

Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `

Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.
From interface ` https://developer.android.com/reference/android/text/ParcelableSpan ` ` abstract int` ` https://developer.android.com/reference/android/text/ParcelableSpan#getSpanTypeId()() `

Return a special type identifier for this span class.
From interface ` https://developer.android.com/reference/android/os/Parcelable ` ` abstract int` ` https://developer.android.com/reference/android/os/Parcelable#describeContents()() `

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.
` abstract void` ` https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)(https://developer.android.com/reference/android/os/Parcel dest, int flags) `

Flatten this object in to a Parcel.

## Public constructors

### URLSpan

Added in [API level 3](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public URLSpan (Parcel src)
```

Constructs a `https://developer.android.com/reference/android/text/style/URLSpan` from a parcel.

<br />

| Parameters ||
|---|---|
| `src` | `Parcel`: This value cannot be `null`. <br /> |

### URLSpan

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public URLSpan (String url)
```

Constructs a `https://developer.android.com/reference/android/text/style/URLSpan` from a url string.

<br />

| Parameters ||
|---|---|
| `url` | `String`: the url string <br /> |

## Public methods

### describeContents

Added in [API level 3](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
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 `https://developer.android.com/reference/android/os/Parcelable#writeToParcel(android.os.Parcel,%20int)`, the return value of this method must include the `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR` bit.

<br />

| Returns ||
|---|---|
| `int` | a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either `0` or - `https://developer.android.com/reference/android/os/Parcelable#CONTENTS_FILE_DESCRIPTOR` |

### getSpanTypeId

Added in [API level 3](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public int getSpanTypeId ()
```

Return a special type identifier for this span class.

<br />

| Returns ||
|---|---|
| `int` | <br /> |

### getURL

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String getURL ()
```

Get the url string for this span.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | the url string. <br /> |

### onClick

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public void onClick (View widget)
```

Performs the click action associated with this span.

<br />

| Parameters ||
|---|---|
| `widget` | `View`: This value cannot be `null`. <br /> |

### toString

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public String toString ()
```

Returns a string representation of the object.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/lang/String` | a string representation of the object. <br /> |

### writeToParcel

Added in [API level 3](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public void writeToParcel (Parcel dest, 
                int flags)
```

Flatten this object in to a Parcel.

<br />

| Parameters ||
|---|---|
| `dest` | `Parcel`: This value cannot be `null`. <br /> |
| `flags` | `int`: Additional flags about how the object should be written. May be 0 or `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE`. Value is either `0` or a combination of the following: - `https://developer.android.com/reference/android/os/Parcelable#PARCELABLE_WRITE_RETURN_VALUE` |