HTMLAreaElement - Web API 接口参考 编辑

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
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	Obsolete	No change from Document Object Model (DOM) Level 1 Specification.
Document Object Model (DOM) Level 1 Specification HTMLAreaElement	Obsolete	Initial definition.

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

• Desktop
• Mobile

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>.