HTMLAreaElement

The HTMLAreaElement interface provides special properties and methods (beyond those of the regular object HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of <area> elements.

Properties

Inherits properties from its parent, HTMLElement, and implements those from HTMLHyperlinkElementUtils.

Element.accessKey
Is a DOMString containing a single character that switches input focus to the control.
HTMLAreaElement.alt
Is a DOMString that reflects the alt HTML attribute, containing alternative text for the element.
HTMLAreaElement.coords
Is a DOMString that reflects the coords HTML attribute, containing coordinates to define the hot-spot region.
HTMLAreaElement.download
Is a DOMString indicating that the linked resource is intended to be downloaded rather than displayed in the browser. The value represent the proposed name of the file. If the name is not a valid filename of the underlying OS, browser will adapt it.
HTMLHyperlinkElementUtils.hash
Is a USVString containing the fragment identifier (including the leading hash mark (#)), if any, in the referenced URL.
HTMLHyperlinkElementUtils.host
Is a USVString containing the hostname and port (if it's not the default port) in the referenced URL.
HTMLHyperlinkElementUtils.hostname
Is a USVString containing the hostname in the referenced URL.
HTMLHyperlinkElementUtils.href
Is a USVString containing that reflects the href HTML attribute, containing a valid URL of a linked resource.
HTMLAreaElement.hreflang
Is a DOMString containing that reflects the hreflang HTML attribute, indicating the language of the linked resource.
HTMLAreaElement.media
Is a DOMString containing that reflects the media HTML attribute, indicating target media of the linked resource.
HTMLAreaElement.noHref
Is a Boolean flag indicating if the area is inactive (true) or active (false).
HTMLHyperlinkElementUtils.password
Is a USVString containing the password specified before the domain name.
HTMLHyperlinkElementUtils.origin Read only
Returns a USVString containing the origin of the URL, that is its scheme, its domain and its port.
HTMLHyperlinkElementUtils.pathname
Is a USVString containing the path name component, if any, of the referenced URL.
HTMLHyperlinkElementUtils.port
Is a USVString containing the port component, if any, of the referenced URL.
HTMLHyperlinkElementUtils.protocol
Is a USVString containing the protocol component (including trailing colon ':'), of the referenced URL.
HTMLAreaElement.referrerPolicy
Is a DOMString that reflects the referrerpolicy HTML attribute indicating which referrer to use when fetching the linked resource.
HTMLAreaElement.rel
Is a DOMString that reflects the rel HTML attribute, indicating relationships of the current document to the linked resource.
HTMLAreaElement.relList Read only
Returns a DOMTokenList that reflects the rel HTML attribute, indicating relationships of the current document to the linked resource, as a list of tokens.
HTMLHyperlinkElementUtils.search
Is a USVString containing the search element (including leading question mark '?'), if any, of the referenced URL.
HTMLAreaElement.shape
Is a DOMString that reflects the shape HTML attribute, indicating the shape of the hot-spot, limited to known values.
HTMLElement.tabIndex
Is a long containing the element's position in the tabbing order.
HTMLAreaElement.target
Is a DOMString that reflects the target HTML attribute, indicating the browsing context in which to open the linked resource.
HTMLAreaElement.type
Is a DOMString that reflects the type HTML attribute, indicating the MIME type of the linked resource.
HTMLHyperlinkElementUtils.username
Is a USVString containing the username specified before the domain name.

Methods

Inherits methods from its parent, HTMLElement, and implements those from HTMLHyperlinkElementUtils.

HTMLHyperlinkElementUtils.toString()
Returns a USVString containing the whole URL of the script executed in the Worker. It is a synonym for HTMLHyperlinkElementUtils.href.

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'HTMLAreaElement' in that specification.
Living Standard The following property has been added: download.
Technically, the URL-related properties, media, host, hostname, pathname, port, protocol, search, and hash, have been moving to the HTMLHyperlinkElementUtils mixin, and HTMLAreaElement implements this mixin.
HTML5
The definition of 'HTMLAreaElement' in that specification.
Recommendation Technically, the properties tabindex and accesskey are now defined on HTMLElement.
The following property is now obsolete: nohref.
The following properties have been added: rel, relList, media, hreflang, type, host, hostname, pathname, port, protocol, search, and hash.
Document Object Model (DOM) Level 2 HTML Specification
The definition of 'HTMLAreaElement' in that specification.
Obsolete No change from Document Object Model (DOM) Level 1 Specification.
Document Object Model (DOM) Level 1 Specification
The definition of 'HTMLAreaElement' in that specification.
Obsolete Initial definition

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
HTMLAreaElementChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
accessKeyChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
altChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
coordsChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
download
Experimental
Chrome Full support 54Edge Full support 13Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support 54Chrome Android Full support 54Firefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support 6.0
hreflangChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
mediaChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
noHrefChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
referrerPolicyChrome Full support 51Edge Full support 79Firefox Full support 50IE No support NoOpera Full support 38Safari Full support 11.1WebView Android Full support 51Chrome Android Full support 51Firefox Android Full support 50Opera Android Full support 41Safari iOS No support NoSamsung Internet Android Full support 7.2
relChrome Full support 54Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support 54Chrome Android Full support 54Firefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support 6.0
relListChrome Full support 65Edge Full support 18Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support 65Chrome Android Full support 65Firefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support 9.0
shapeChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
tabIndexChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
targetChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
typeChrome Full support YesEdge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.

See also

  • HTML element implementing this interface: <area>