HTML element: <a>
Availability
|
Partial support as of BlackBerry®
Device Software version 3.2.
Full support as of BlackBerry Device Software
version 4.6.
|
The <a> element defines an anchor, which can be used to create a link to another document, or to create a bookmark within the current document.
Differences between HTML, XHTML, and XHTML-MP
To conform to XHTML (strict) or XHTML-MP, use the id attribute rather than the name attribute to uniquely identify the anchor.
Considerations
In the BlackBerry® Browser, the content of a target document opens in a new window.
Attributes
Attributes
|
Value(s)
|
Descriptions
|
Supported in
|
charset
|
charset
|
This attribute specifies the character encoding used in the referenced document; the value must be the name of a standard character set.
|
4.0 or later
|
coords
|
coordinates
|
This attribute specifies the coordinates of key points of a shape in an image map. The number and order of the values depend on the value of the shape attribute:
- rect: defines the top left and bottom right corners in the following format:
left, top, right, bottom
- circle: defines the circle center and radius length in the following format: center-x, center-y, radius
- poly: defines each point in the following format: x1, y1, x2, y2, x3, x3, ..., xN, yN
|
4.6 or later
|
href
|
URI
|
Required if the anchor is a link. This attribute identifies the target of the link.
Links can be of the following types:
- web page links: The BlackBerry Browser
supports the http:// and https:// link schemes.
- phone links: The BlackBerry Browser
supports the following phone link schemes:
- tel: (I-Mode format)
- wtai: (Wirleess Telephone application Make Call Links)
- dc: (Direct Connect links on iDEN networks)
- cti: (Computer Telephone Integration)
- email links: The BlackBerry Browser
supports the following email link schemes:
- mailto:
- PIN: (direct BlackBerry to BlackBerry messaging)
|
3.2 or later
|
hreflang
|
language_code
|
This attribute defines the base language of the target resource.
|
4.6 or later
|
id
|
text
|
Required if the anchor is to be a target of a link. This attribute defines a unique name for the anchor, which can be used to identify it as a link target.
|
4.6 or later
|
name
|
text
|
This attribute defines a unique name for the anchor, which can be used to identify it as a target of a link.
Note: This attribute is equivalent to the id attribute. To conform to XHTML (strict) or XHTML-MP, you should use the id attribute instead.
|
4.0 or later
|
rel
|
link_types
|
This attribute specifies the relationship between the current document and the referenced resource. For example, “stylesheet”.
|
4.6 or later
|
rev
|
link_types
|
This attribute provides text that describes a link relationship from the referenced target document to the source document. Not displayed to the user.
|
4.6 or later
|
shape
|
rect
circle
poly
|
This attribute specifies the shape of a region in an image map.
|
4.6 or later
|
target
|
frame_target
|
This attribute specifies where the target document will be opened. The value can be the id attribute of the target frame, or can have one of the following special values:
- _blank: Default. The document opens in a new window.
- _self: The document opens in the current frame.
- _parent: The document opens in the parent frameset.
- _top: The document opens in the full window.
|
4.2 or later
|
type
|
MIME_type
|
This attribute specifies the MIME type of the target document.
|
4.6 or later
|
Common attributes
|
—
|
The <a> element supports the following common attributes:
- class
- dir
- lang
- style
- title
|
4.6 or later
|
Event attributes
|
—
|
The <a> element supports the following events:
- onclick
- onfocus
- onkeydown
- onkeypress
- onkeyup
- onmousedown
- onmousemove
- onmouseout
- onmouseover
- onmouseup
|
4.6 or later
|
Index
Was this information helpful? Send us your comments.