From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/api/htmlareaelement/index.html | 197 +++++++++++++++++++++++++ 1 file changed, 197 insertions(+) create mode 100644 files/zh-cn/web/api/htmlareaelement/index.html (limited to 'files/zh-cn/web/api/htmlareaelement/index.html') diff --git a/files/zh-cn/web/api/htmlareaelement/index.html b/files/zh-cn/web/api/htmlareaelement/index.html new file mode 100644 index 0000000000..cc7feef547 --- /dev/null +++ b/files/zh-cn/web/api/htmlareaelement/index.html @@ -0,0 +1,197 @@ +--- +title: HTMLAreaElement +slug: Web/API/HTMLAreaElement +translation_of: Web/API/HTMLAreaElement +--- +
+
{{APIRef("HTML DOM")}}
+
+ +

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

+ +

属性

+ +

从它的父对象{{domxref("HTMLElement")}}继承的，还有从{{domxref("URLUtils")}}继承的。

+ +
+
{{domxref("HTMLAreaElement.accessKey")}}
+
值为一个 {{domxref("DOMString")}} 类型，包含了一个简单的字符代表键盘上的一个按键，相当于快捷键。
+
{{domxref("HTMLAreaElement.alt")}}
+
值为一个{{domxref("DOMString")}} 类型，代表了 {{ htmlattrxref("alt", "area") }} HTML 属性,，包含一个area对象显示异常的情况下显示的备用文本字符串。
+
{{domxref("HTMLAreaElement.coords")}}
+
值为一个 {{domxref("DOMString")}} 类型，代表了 {{ htmlattrxref("coords", "area") }} HTML 属性, 包含了定义热区相关的坐标。
+
{{domxref("HTMLAreaElement.download")}} {{experimental_inline}}
+
值为一个 {{domxref("DOMString")}} 类型，表明此资源是将要被下载的资源而不是显示在浏览器页面中。值为下载保存文件的推荐文件名。如果名字在操作系统里不是一个合格的文件名格式，浏览器将会做相应的修改。
+
{{domxref("URLUtils.hash")}}
+
Is a {{domxref("DOMString")}} containing the fragment identifier (including the leading hash mark (#)), if any, in the referenced URL.
+
{{domxref("URLUtils.host")}}
+
Is a {{domxref("DOMString")}} containing the hostname and port (if it's not the default port) in the referenced URL.
+
{{domxref("URLUtils.hostname")}}
+
Is a {{domxref("DOMString")}} containing the hostname in the referenced URL.
+
{{domxref("URLUtils.href")}}
+
Is a {{domxref("DOMString")}} containing that reflects the {{ htmlattrxref("href", "area") }} HTML attribute, containing a valid URL of a linked resource.
+
{{domxref("HTMLAreaElement.hreflang")}}
+
Is a {{domxref("DOMString")}} containing that reflects the {{ htmlattrxref("hreflang", "area") }} HTML attribute, indicating the language of the linked resource.
+
{{domxref("HTMLAreaElement.media")}}
+
Is a {{domxref("DOMString")}} containing that reflects the {{ htmlattrxref("media", "area") }} HTML attribute, indicating target media of the linked resource.
+
{{domxref("HTMLAreaElement.noHref")}} {{obsolete_inline}}
+
Is a {{domxref("Boolean")}} flag indicating if the area is inactive (true) or active (false).
+
{{domxref("URLUtils.password")}}
+
Is a {{domxref("DOMString")}} containing the password specified before the domain name.
+
{{domxref("URLUtils.origin")}} {{readonlyInline}}
+
Returns a {{domxref("DOMString")}} containing the origin of the URL, that is its scheme, its domain and its port.
+
{{domxref("URLUtils.pathname")}}
+
Is a {{domxref("DOMString")}} containing the path name component, if any, of the referenced URL.
+
{{domxref("URLUtils.port")}}
+
Is a {{domxref("DOMString")}} containing the port component, if any, of the referenced URL.
+
{{domxref("URLUtils.protocol")}}
+
Is a {{domxref("DOMString")}} containing the protocol component (including trailing colon ':'), of the referenced URL.
+
{{domxref("HTMLAreaElement.rel")}}
+
Is a {{domxref("DOMString")}} that reflects the {{ htmlattrxref("rel", "area") }} HTML attribute, indicating relationships of the current document to the linked resource.
+
{{domxref("HTMLAreaElement.relList")}} {{readOnlyInline}}
+
Returns a {{domxref("DOMTokenList")}} that reflects the {{ htmlattrxref("rel", "area") }} HTML attribute, indicating relationships of the current document to the linked resource, as a list of tokens.
+
{{domxref("HTMLAreaElement.search")}}
+
Is a {{domxref("DOMString")}} containing the search element (including leading question mark '?'), if any, of the referenced URL.
+
{{domxref("HTMLAreaElement.shape")}}
+
Is a {{domxref("DOMString")}} that reflects the {{ htmlattrxref("shape", "area") }} HTML attribute, indicating the shape of the hot-spot, limited to known values.
+
{{domxref("HTMLAreaElement.tabIndex")}}
+
Is a long containing the element's position in the tabbing order.
+
{{domxref("HTMLAreaElement.target")}}
+
Is a {{domxref("DOMString")}} that reflects the {{ htmlattrxref("target", "area") }} HTML attribute, indicating the browsing context in which to open the linked resource.
+
{{domxref("HTMLAreaElement.type")}}
+
Is a {{domxref("DOMString")}} that reflects the {{ htmlattrxref("type", "area") }} HTML attribute, indicating the MIME type of the linked resource.
+
{{domxref("URLUtils.username")}}
+
Is a {{domxref("DOMString")}} containing the username specified before the domain name.
+
+ +

Methods

+ +

Inherits methods from its parent, {{domxref("HTMLElement")}} and  implement those from {{domxref("URLUtils")}}.

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

Specifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG', "the-map-element.html#the-area-element", "HTMLAreaElement")}}{{Spec2('HTML WHATWG')}}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 {{domxref("URLUtils")}} interface, and HTMLAreaElement implements this interface.
{{SpecName('HTML5 W3C', "embedded-content-0.html#the-area-element", "HTMLAreaElement")}}{{Spec2('HTML5 W3C')}}Technically, the properties tabindex and accesskey are now defined on {{domxref("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.
{{SpecName('DOM2 HTML', 'html.html#ID-26019118', 'HTMLAreaElement')}}{{Spec2('DOM2 HTML')}}No change from {{SpecName("DOM1")}}.
{{SpecName('DOM1', 'level-one-html.html#ID-26019118', 'HTMLAreaElement')}}{{Spec2('DOM1')}}Initial definition.
+ +

Browser compatibility

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Basic support{{CompatVersionUnknown}}{{CompatGeckoDesktop(1.0)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
download {{experimental_inline}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
username, password, and origin{{CompatUnknown}}{{CompatGeckoDesktop("26.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Basic support{{CompatVersionUnknown}}{{CompatGeckoMobile(1.0)}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
download {{experimental_inline}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
username, password, and origin{{CompatUnknown}}{{CompatGeckoMobile("26.0")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

See also

+ + -- cgit v1.2.3-54-g00ecf