HTMLAreaElement

HTMLAreaElement 接口提供了一些属性和方法 (除了常见的对象HTMLElement 接口提供的属性和方法通过继承也能获取到) 用来控制一个area元素的布局和展现。

属性

从它的父对象HTMLElement继承的,还有从URLUtils继承的。

HTMLAreaElement.accessKey
值为一个 DOMString 类型,包含了一个简单的字符代表键盘上的一个按键,相当于快捷键。
HTMLAreaElement.alt
值为一个DOMString 类型,代表了 alt HTML 属性,,包含一个area对象显示异常的情况下显示的备用文本字符串。
HTMLAreaElement.coords
值为一个 DOMString 类型,代表了 coords HTML 属性, 包含了定义热区相关的坐标。
HTMLAreaElement.download
值为一个 DOMString 类型,表明此资源是将要被下载的资源而不是显示在浏览器页面中。值为下载保存文件的推荐文件名。如果名字在操作系统里不是一个合格的文件名格式,浏览器将会做相应的修改。
URLUtils.hash
Is a DOMString containing the fragment identifier (including the leading hash mark (#)), if any, in the referenced URL.
URLUtils.host
Is a DOMString containing the hostname and port (if it's not the default port) in the referenced URL.
URLUtils.hostname
Is a DOMString containing the hostname in the referenced URL.
URLUtils.href
Is a DOMString 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).
URLUtils.password
Is a DOMString containing the password specified before the domain name.
URLUtils.origin 只读
Returns a DOMString containing the origin of the URL, that is its scheme, its domain and its port.
URLUtils.pathname
Is a DOMString containing the path name component, if any, of the referenced URL.
URLUtils.port
Is a DOMString containing the port component, if any, of the referenced URL.
URLUtils.protocol
Is a DOMString containing the protocol component (including trailing colon ':'), of the referenced URL.
HTMLAreaElement.rel
Is a DOMString that reflects the rel HTML attribute, indicating relationships of the current document to the linked resource.
HTMLAreaElement.relList 只读
Returns a DOMTokenList that reflects the rel HTML attribute, indicating relationships of the current document to the linked resource, as a list of tokens.
HTMLAreaElement.search
Is a DOMString 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.
HTMLAreaElement.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.
URLUtils.username
Is a DOMString containing the username specified before the domain name.

Methods

Inherits methods from its parent, HTMLElement and  implement those from URLUtils.

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

Specifications

Specification Status Comment
WHATWG HTML Living Standard
HTMLAreaElement
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 URLUtils interface, and HTMLAreaElement implements this interface.
HTML5
HTMLAreaElement
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
HTMLAreaElement
Recommendation No change from Document Object Model (DOM) Level 1 Specification.
Document Object Model (DOM) Level 1 Specification
HTMLAreaElement
Recommendation Initial definition.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Yes) 1.0 (1.7 or earlier) (Yes) (Yes) (Yes)
download  ? ? ? ? ?
username, password, and origin ? 26.0 (26.0) ? ? ?
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support (Yes) 1.0 (1.0) (Yes) (Yes) (Yes)
download  ? ? ? ? ?
username, password, and origin ? 26.0 (26.0) ? ? ?

See also

  • HTML element implementing this interface: <area>.

文档标签和贡献者