Help Center

Local Navigation

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.